How robertgarcia-ai/skills works
This repository is a library of four Claude Code skills, not a conventional application. Users invoke a skill to produce plans, campaign artifacts, handoffs, or structured intent. The README documents the butterfly-collector campaign stages and word-vomit’s routing outcomes; other internal links are shown only where those descriptions support them. Source inspection was limited to the state validator excerpt, so the skills’ internal procedures are represented at their documented paths rather than inferred from unsampled contents.
Main entry points: butterfly-collector/SKILL.md Campaign Controller · word-vomit/SKILL.md Intent Structurer · orchestrator/SKILL.md Plan Generator · handoff/SKILL.md Handoff Writer
Components 17
Orchestration
- Plan Generator
skills/orchestrator/SKILL.md
Bug Campaign
- Campaign Controller
skills/butterfly-collector/SKILL.md - Bug Hunt
skills/butterfly-collector/references/phases/hunt.md - Fix Execution
skills/butterfly-collector/references/phases/execute.md - Dev-Run Bundle
skills/butterfly-collector/references/phases/devrun.md - Finding Synthesis
skills/butterfly-collector/references/phases/synthesize.md - Campaign State
skills/butterfly-collector/references/state.md - State Validator
skills/butterfly-collector/scripts/validate_state.py - Campaign Templates
skills/butterfly-collector/references/templates - Campaign Examples
skills/butterfly-collector/references/examples
Session Handoff
- Handoff Writer
skills/handoff/SKILL.md
Intent Structuring
- Intent Structurer
skills/word-vomit/SKILL.md - Choreography and Examples
skills/word-vomit/references
Other components
- User
- Execution Work
- Handoff Document
- Parked Intent
Connections 19
- User → Plan Generator: requests plan
README.md - Plan Generator → Execution Work: produces plan
README.md - User → Campaign Controller: starts campaign
README.md - Campaign Controller → Bug Hunt: governs phase
README.md - Campaign Controller → Fix Execution: governs phase
README.md - Campaign Controller → Dev-Run Bundle: generates bundle
README.md - Campaign Controller → Finding Synthesis: synthesizes findings
README.md - Campaign Controller → Plan Generator: uses for planning
README.md - Campaign Controller → Campaign State: tracks campaign
README.md - Campaign Templates → Dev-Run Bundle: templates artifacts
- Campaign Examples → Campaign Controller: illustrates practice
README.md - State Validator → Campaign State: validates state
skills/butterfly-collector/scripts/validate_state.py - User → Handoff Writer: requests handoff
README.md - Handoff Writer → Handoff Document: produces document
README.md - User → Intent Structurer: provides raw thought
README.md - Intent Structurer → Choreography and Examples: uses references
- Intent Structurer → Execution Work: routes to execution
README.md - Intent Structurer → Handoff Document: routes to handoff
README.md - Intent Structurer → Parked Intent: routes to park
README.md