Homepage (site/index.html): integration-v14 promoted, Writings section integrated with 33 pieces clustered by type (stories/essays/miscellany), Writings welcome lightbox, content frame at 98% opacity. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
3.7 KiB
skill-scout — commissioning skill extension
Fetches purpose-specific external skills at commission time.
Add this capability to the commissioning skill Step 3 (compose path)
whenever a builder scion is being commissioned.
When to run skill-scout
Run skill-scout before commissioning any builder scion. The sorter scion and commit-tracker hook do not require external skills — they are covered by their spore files alone. The builder scion does, because the quality of its output depends on the aesthetic and technical conventions of the build type (frontend-design, annotated-writing, etc.).
Skill-scout decision table
| Section being built | Recommended external skill | Source |
|---|---|---|
| Home page (star-map) | frontend-design + ux-design | anthropics/skills + wondelai |
| Writings | annotated-writing | project skills (user-supplied) |
| Videos | frontend-design | anthropics/skills |
| Images (slideshow) | frontend-design | anthropics/skills |
| Playlists / Watchlists | frontend-design | anthropics/skills |
| Music gallery | frontend-design | anthropics/skills |
| Creature Playground | commissioning-skill (recursive) | this workspace |
| Any section (UI/UX) | ux-design (refactoring-ui + ux-heuristics) | wondelai/skills |
Skill-scout process
- Identify the section being built from the ToBuild/{section}/ path
- Look up the recommended skill from the decision table above
- Check whether the skill is already present in commissioning-skill/fetched-skills/
- If absent: fetch from source
- For GitHub-hosted skills: clone or download the SKILL.md (and references/ if present)
- Save to commissioning-skill/fetched-skills/{skill-name}/
- Set SCION_EXTERNAL_SKILL env var to the fetched skill path before spawning builder
- Include fetched skill contents in the builder scion's commission package
Fetched skill cache
commissioning-skill/
└── fetched-skills/
├── frontend-design/
│ └── SKILL.md
├── annotated-writing/
│ ├── SKILL.md
│ └── references/
└── ux-design/
└── SKILL.md
Fetched skills are cached between commission cycles. Do not re-fetch on every commission — check the cache first. Re-fetch only if the skill file is older than 7 days or if the parent explicitly requests a refresh.
Skill-scout for Creature Playground
The Creature Playground section is special: scions build there autonomously. The parent commissions a builder scion with the commissioning-skill itself bundled (recursive commissioning). The scion can then commission sub-scions of its own within the Playground scope. Output is for review only — nothing in Creature Playground is deployed to the live site without explicit parent review and JL's commit trigger.
Integration point in commissioning skill
Add between Step 3b (reason through decision surface) and Step 3c (write spore entries) for builder task class:
3b-scout: If task-class is builder:
- Identify section from ToBuild path
- Run skill-scout to fetch appropriate external skill
- Set SCION_EXTERNAL_SKILL to fetched skill path
- Proceed to 3c with external skill context available
The external skill content should be appended to the builder scion's spore file reference list, not embedded inline — keep the spore file itself within its token budget.