Files

Teknium 38d3c49aaf refactor(skills): clean up bundled skill set + add environments: relevance gate (#39028 )

* 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.

2026-06-04 06:11:22 -07:00

1.8 KiB

Raw Blame History

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

1.8 KiB Raw Blame History