Files
hermes-agent/optional-skills/creative/baoyu-article-illustrator/PORT_NOTES.md
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.3 KiB
Raw Blame History

Port Notes — baoyu-article-illustrator

Ported from JimLiu/baoyu-skills v1.57.0.

Changes from upstream

SKILL.md, references/workflow.md, references/usage.md, references/style-presets.md, references/styles.md, references/prompt-construction.md, and prompts/system.md were adapted. The 23 style files and 4 palette files are verbatim copies. The references/config/ directory was removed entirely.

Adaptations

Change Upstream Hermes
Metadata namespace openclaw hermes
Trigger /baoyu-article-illustrator slash command + CLI flags Natural language skill matching
User config EXTEND.md (project/user/XDG paths) + first-time-setup Removed — not part of Hermes infra
User prompts AskUserQuestion (batched, multi-question) clarify tool (one question at a time)
Image generation baoyu-imagine (Bun/TypeScript, multi-provider, accepts --ref, writes to local path) image_generate (returns URL only; agent downloads via terminal/curl)
Backend selection User picks provider via CLI flags Not agent-selectable — image_generate uses the user-configured FAL model. Removed hardcoded "nano banana pro" line from prompts/system.md.
Reference images Passed to backend via --ref, copied via shell vision_analyze extracts a textual description (binary never touched by write_file/read_file); description is embedded in prompts. Optional terminal cp for a local record.
Platform support Linux/macOS/Windows/WSL/PowerShell Linux/macOS only
File operations Bash commands Hermes file tools: write_file/read_file for text, terminal for binaries and URL downloads, vision_analyze for reading images
Watermark Driven by EXTEND.md watermark.enabled Optional — user asks for it per-article
Output directory EXTEND.md default_output_dir (imgs-subdir / same-dir / illustrations-subdir / independent) Defaults based on input type; user overrides in request

What was preserved

  • Type × Style × Palette three-dimension framework
  • All style definitions (23 files, verbatim)
  • All palette definitions (4 files, verbatim)
  • Core reference files (workflow, prompt-construction, styles, style-presets) — adapted for Hermes tooling
  • Core principles and workflow structure (analyze → confirm → outline → prompts → generate)
  • Prompt-file-as-reproducibility-record discipline
  • Author, version, homepage attribution

Syncing with upstream

To pull upstream updates:

# Compare versions
curl -sL https://raw.githubusercontent.com/JimLiu/baoyu-skills/main/skills/baoyu-article-illustrator/SKILL.md | head -5
# Look for version: line

# Diff style/palette files (safe to overwrite — unchanged from upstream)
diff <(curl -sL https://raw.githubusercontent.com/JimLiu/baoyu-skills/main/skills/baoyu-article-illustrator/references/styles/blueprint.md) references/styles/blueprint.md

references/styles/* and references/palettes/* can be overwritten directly. SKILL.md, references/workflow.md, references/usage.md, references/style-presets.md, references/styles.md, references/prompt-construction.md, and prompts/system.md must be manually merged since they contain Hermes-specific adaptations (tool wiring, backend neutrality, removed EXTEND.md references).