mirrors/hermes-agent
1
0
Fork 0
mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-04-25 00:51:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
hermes-agent/skills/creative/baoyu-comic/PORT_NOTES.md
Jim Liu 宝玉 a8beba82d0 refactor(skills): adapt baoyu-comic for Hermes 
Port the upstream baoyu-comic skill to Hermes' tool ecosystem, matching
the earlier baoyu-infographic adaptation:

- metadata namespace openclaw -> hermes (+ tags, homepage)
- drop EXTEND.md preferences system (references/config/ removed,
  workflow Step 1.1 removed)
- user prompts via clarify (one question at a time) instead of
  AskUserQuestion batches
- image generation via image_generate instead of baoyu-imagine, with
  aspect-ratio mapping to landscape/portrait/square
- Windows/PowerShell/WSL shell snippets dropped
- file I/O referenced via Hermes write_file/read_file tools
- CLI-style --flags converted to natural-language options and
  user-intent cues (skill matching has no slash command trigger)

Add PORT_NOTES.md documenting the adaptations and a sync procedure.
Art-style/tone/layout reference files are preserved verbatim from
upstream v1.56.1.
2026-04-21 17:50:04 -07:00

3.4 KiB
Raw Blame History

Port Notes — baoyu-comic

Ported from JimLiu/baoyu-skills v1.56.1.

Changes from upstream

SKILL.md adaptations

Change Upstream Hermes
Metadata namespace openclaw hermes (with tags + homepage)
Trigger Slash commands / CLI flags Natural language skill matching
User config EXTEND.md file (project/user/XDG paths) Removed — not part of Hermes infra
User prompts AskUserQuestion (batched) clarify tool (one question at a time)
Image generation baoyu-imagine (Bun/TypeScript) image_generate tool
Platform support Linux/macOS/Windows/WSL/PowerShell Linux/macOS only
File operations Generic instructions Hermes file tools (write_file, read_file)
Runtime abstraction ${BUN_X} resolution Direct bun invocation for scripts/merge-to-pdf.ts

Structural removals

  • references/config/ directory (removed entirely):
    • first-time-setup.md — blocking first-time setup flow for EXTEND.md
    • preferences-schema.md — EXTEND.md YAML schema
    • watermark-guide.md — watermark config (tied to EXTEND.md)
  • Workflow Step 1.1 — "Load Preferences (EXTEND.md)" section removed from workflow.md; steps 1.2/1.3 renumbered to 1.1/1.2.
  • Generic "User Input Tools" and "Image Generation Tools" preambles — SKILL.md no longer lists fallback rules for multiple possible tools; it references clarify and image_generate directly.

SKILL.md reductions

  • CLI option columns (--art, --tone, --layout, --aspect, --lang, --ref, --storyboard-only, --prompts-only, --images-only, --regenerate) converted to plain-English option descriptions.
  • Preset files (presets/*.md) and ohmsha-guide.md: `--style X` / `--art X --tone Y` shorthand rewritten to art=X, tone=Y + natural-language references.
  • partial-workflows.md: per-skill slash command invocations rewritten as user-intent cues.
  • auto-selection.md: priority order dropped the EXTEND.md tier.
  • analysis-framework.md: language-priority comment updated (user option → conversation → source).

What was preserved verbatim

  • All 6 art-style definitions (references/art-styles/)
  • All 7 tone definitions (references/tones/)
  • All 7 layout definitions (references/layouts/)
  • Core templates: character-template.md, storyboard-template.md, base-prompt.md
  • Preset bodies (only the first few intro lines adapted; special rules unchanged)
  • scripts/merge-to-pdf.ts (Bun-compatible on Linux/macOS)
  • 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-comic/SKILL.md | head -5
# Look for the version: line

# Diff a reference file
diff <(curl -sL https://raw.githubusercontent.com/JimLiu/baoyu-skills/main/skills/baoyu-comic/references/art-styles/manga.md) \
     references/art-styles/manga.md

Art-style, tone, and layout reference files can usually be overwritten directly (they're upstream-verbatim). SKILL.md, references/workflow.md, references/partial-workflows.md, references/auto-selection.md, references/analysis-framework.md, references/ohmsha-guide.md, and references/presets/*.md must be manually merged since they contain Hermes-specific adaptations.