hermes-agent/skills/creative/baoyu-article-illustrator/references/usage.md
Jim Liu 宝玉 4bd297094a feat(skills): adapt baoyu-article-illustrator for Hermes
Adapts the upstream baoyu-article-illustrator skill (verbatim-copied in
the previous commit) to Hermes' tool ecosystem, matching the pattern
used by baoyu-infographic.

- Metadata: openclaw → hermes; add author, license, tags, category
- Triggering: slash command + CLI flags → natural language
- User config: remove EXTEND.md, first-time-setup, preferences-schema
- User prompts: AskUserQuestion (batched) → clarify (one at a time)
- Image gen: baoyu-imagine → image_generate (describe refs in prompt text)
- Platform: drop Windows/PowerShell; Linux/macOS only
- File ops: switch to write_file / read_file
- Watermark: opt-in per-article instead of EXTEND.md-driven
- Add PORT_NOTES.md describing the adaptation and sync procedure

Style, palette, and prompt/system.md reference files are verbatim copies
and are the sync points with upstream.
2026-05-18 18:28:56 -07:00

50 lines
1.8 KiB
Markdown

# Usage
This skill is triggered by natural language in Hermes — no slash command or CLI flags.
## Trigger Phrases
- "Illustrate this article" / "为文章配图"
- "Add images to this post"
- "Generate illustrations for [path/to/article.md]"
## Input Modes
| Mode | How to trigger | Output Directory |
|------|----------------|------------------|
| File path | Mention an article path (`path/to/article.md`) | `{article-dir}/imgs/` (default) |
| Pasted content | Paste the article text in the conversation | `illustrations/{topic-slug}/` (cwd) |
## Specifying Options in Natural Language
The user can specify any of the following directly in their request. If not specified, the skill asks via the `clarify` tool.
| Option | Example phrasing |
|--------|------------------|
| Type | "as an infographic", "as a flowchart", "as scenes" |
| Style | "in blueprint style", "use notion style", "用 watercolor 风格" |
| Preset | "use the tech-explainer preset", "storytelling preset" |
| Palette | "with macaron palette", "warm colors only" |
| Density | "minimal images", "one per section", "rich illustrations" |
| Language | "images in English" / "图片文字用中文" |
| Output | "save images alongside the article" / "put them in `illustrations/`" |
## Examples
**Technical article with data**:
> 帮我为 api-design.md 配图,用 infographic + blueprint 风格
**Preset shortcut**:
> Illustrate api-design.md with the tech-explainer preset
**Personal story**:
> Illustrate journey.md using the storytelling preset
**Tutorial with rich images**:
> Generate illustrations for how-to-deploy.md — tutorial preset, rich density
**Opinion article**:
> Illustrate opinion.md with the opinion-piece preset
**Preset with style override**:
> Use the tech-explainer preset for article.md but swap the style for notion