38d3c49aaf
* refactor(skills): clean up bundled skill set + add environments: relevance gate Bundled skills cleanup pass plus a new offer-time relevance gate. Removals (redundant / dead): - spotify (covered by the spotify plugin's 7 native tools) - linear (covered by `hermes mcp install linear`) - kanban-codex-lane, debugging-hermes-tui-commands - empty category markers: diagramming, gifs, inference-sh, mlops/training, mlops/vector-databases - domain (stale orphan dup of optional/research/domain-intel) Bundled -> optional: - baoyu-article-illustrator, baoyu-comic, creative-ideation, pixel-art - dspy, subagent-driven-development - minecraft-modpack-server, pokemon-player - hermes-s6-container-supervision (-> optional/devops) Consolidation: - webhook-subscriptions + native-mcp folded into the hermes-agent skill as references/webhooks.md + references/native-mcp.md with SKILL.md pointers - writing-plans merged into plan (v2.0.0); related_skills + prose refs updated New: environments: frontmatter gate (agent/skill_utils.skill_matches_environment) - Offer-time relevance filter (kanban / docker / s6), parallel to platforms:. - Wired into the 3 OFFER surfaces only (prompt_builder skills index, skills_tool.list_skills, skill_commands slash discovery). - Explicit loads (skill_view, --skills preload) intentionally BYPASS it, so load-bearing force-loads like the kanban dispatcher's `--skills kanban-worker` always resolve. Verified via E2E. - kanban-orchestrator/kanban-worker tagged environments: [kanban]; hermes-s6-container-supervision tagged environments: [s6] + platforms: [linux]. Validation: 8/8 E2E gating assertions (incl force-load invariant); 442 targeted tests green (agent, skills_tool, skill_commands, kanban worker). * docs: regenerate skill catalogs + pages for the bundled cleanup Regenerated per-skill doc pages, catalogs, and sidebar to match the skill moves/removals in the parent commit. Moved skills' pages relocate bundled -> optional (history preserved); removed skills' pages deleted; edited skills' pages refreshed (hermes-agent now embeds the webhook + native-mcp reference pointers). zh-Hans i18n mirror: stale bundled pages and catalog rows for moved/removed skills pruned (new optional translations land via the translation pipeline). * test: drop regression test for removed kanban-codex-lane skill The kanban-codex-lane skill was removed in the bundled-skills cleanup; its dedicated regression test read the now-deleted SKILL.md and failed with FileNotFoundError on CI shard 6.
51 lines
1.8 KiB
Markdown
51 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
|