Skill Factory

Proposes and scaffolds new skills from observed patterns in transcripts and brain state.

Outputs

• •.claude/skills/generated/<skill-name>/ — scaffolded skill folders
• •.claude/voyager/skill_proposals.json — latest skill proposals
• •.claude/voyager/generated_skills_index.json — index of generated skills

Safe Two-Step Loop

Always follow this workflow:

Step 1: Propose Candidates

Analyze patterns and present 3-5 skill candidates to the user:

voyager factory propose

• •Creates skill_proposals.json with candidates
• •Present each with name, description, triggers, and rationale
• •Wait for user selection before proceeding

Step 2: Scaffold User's Choice

Only scaffold the skill the user explicitly selects:

# List available proposals
voyager factory list

# Scaffold by name (after user selects)
voyager factory scaffold --name <selected-skill>

# Or by index
voyager factory scaffold --index <n>

Important: Never scaffold multiple skills automatically. Let the user pick.

Common Queries

"What skills could I create?"

1. •Read .claude/voyager/brain.json to understand recent patterns
2. •Run voyager factory propose --dry-run to see proposals
3. •Present the top 3 proposals with rationale

"Turn this workflow into a skill"

1. •Ask user to describe the workflow
2. •Create a manual proposal based on their description
3. •Run scaffold_skill.py with the proposal
4. •Review and refine the generated SKILL.md

"Generate a skill for X"

1. •Analyze what "X" involves (tools needed, triggers, workflow)
2. •Create or find a matching proposal
3. •Scaffold the skill
4. •Add it to the generated skills index

Files

Guardrails

• •Never overwrite existing skills without explicit confirmation
• •Validate YAML frontmatter before scaffolding
• •Check duplicates against existing generated skills
• •Keep SKILL.md concise (< 100 lines, point to references)

See reference.md for full implementation details.