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

3.5 KiB

Raw Blame History

Auto Selection

Content signals determine default art + tone + layout (or preset).

Content Signal Matrix

Content Signals	Art Style	Tone	Layout	Preset
Tutorial, how-to, beginner	manga	neutral	webtoon	ohmsha
Computing, AI, programming	manga	neutral	dense	ohmsha
Technical explanation, educational	manga	neutral	webtoon	ohmsha
Pre-1950, classical, ancient	realistic	vintage	cinematic	-
Personal story, mentor	ligne-claire	warm	standard	-
Psychology, motivation, self-help, coaching	manga	warm	standard	concept-story
Business narrative, management, leadership	manga	warm	standard	concept-story
Conflict, breakthrough	(inherit)	dramatic	splash	-
Wine, food, lifestyle	realistic	neutral	cinematic	-
Martial arts, wuxia, xianxia	ink-brush	action	splash	wuxia
Romance, love, school life	manga	romantic	standard	shoujo
Business allegory, fable, parable, short insight, 四格	minimalist	neutral	four-panel	four-panel
Biography, balanced	ligne-claire	neutral	mixed	-

Preset Recommendation Rules

When preset is recommended: Load presets/{preset}.md and apply all special rules.

ohmsha

Triggers: Tutorial, technical, educational, computing, programming, how-to, beginner
Special rules: Visual metaphors, NO talking heads, gadget reveals, Doraemon-style characters
Base: manga + neutral + webtoon/dense

wuxia

Triggers: Martial arts, wuxia, xianxia, cultivation, swordplay
Special rules: Qi effects, combat visuals, atmospheric elements
Base: ink-brush + action + splash

shoujo

Triggers: Romance, love story, school life, emotional drama
Special rules: Decorative elements, eye details, romantic beats
Base: manga + romantic + standard

concept-story

Triggers: Psychology, motivation, self-help, business narrative, management, leadership, personal growth, coaching, soft skills, abstract concept through story
Special rules: Visual symbol system, growth arc, dialogue+action balance, original characters
Base: manga + warm + standard

four-panel

Triggers: Business allegory, fable, parable, short insight, four-panel, 四格, 四格漫画, single-page comic, minimalist comic strip
Special rules: Strict 起承转合 4-panel structure, B&W + spot color, simplified stick-figure characters, single-page story
Base: minimalist + neutral + four-panel

Compatibility Matrix

Art Style × Tone combinations work best when matched appropriately:

Art Style	✓✓ Best	✓ Works	✗ Avoid
ligne-claire	neutral, warm	dramatic, vintage, energetic	romantic, action
manga	neutral, romantic, energetic, action	warm, dramatic	vintage
realistic	neutral, warm, dramatic, vintage	action	romantic, energetic
ink-brush	neutral, dramatic, action, vintage	warm	romantic, energetic
chalk	neutral, warm, energetic	vintage	dramatic, action, romantic
minimalist	neutral	warm, energetic	dramatic, vintage, romantic, action

Note: Art Style × Tone × Layout can be freely combined. Incompatible combinations work but may produce unexpected results.

Priority Order

User-specified options (art / tone / style)
Content signal analysis → auto-selection
Fallback: ligne-claire + neutral + standard

3.5 KiB Raw Blame History Unescape Escape