scaffold

Scaffold Tool

Quick-start generator for wicked-garden components. The plugin is skills-only: the former commands/ and agents/ trees were absorbed into skills/, so this tool scaffolds skills, workers, and hooks — never a commands/ or agents/ file.

Purpose

Generates production-ready component structures within the unified plugin:

• Skills — a sub-skill skills/{domain}/{name}/SKILL.md (Tier-2 navigation + refs/)
• Worker skills — a standalone context: fork worker skills/{domain}-{role}/SKILL.md (the former "agent"), dispatched via Skill(skill="wicked-garden-{domain}-{role}")
• Hooks — hooks.json entries with Python scripts

Former commands are now actions of the consolidated per-domain router skill (skills/{domain}/SKILL.md); the command subcommand is retired and only prints guidance for adding an action.

All scaffolded components pass validation immediately.

Usage

Interactive Mode

python .claude/skills/scaffolding/scripts/scaffold.py

# Interactive prompts:
# > Component type? (1 skill / 2 worker / 3 action-guidance / 4 hook)
# > Domain? (crew, engineering, platform, ...)
# > Name? (kebab-case)
# > Description?

# Result (skill):
# Skill created: skills/crew/my-skill/
# Skill id: my-skill (routed by the crew domain skill)

Command Line Mode

# Skill (a sub-skill under a domain)
python .claude/skills/scaffolding/scripts/scaffold.py skill \
  --name my-skill \
  --domain crew \
  --description "What this skill does" \
  --use-when "trigger conditions"

# Worker skill (context:fork — the former agent). `agent` is a back-compat alias.
python .claude/skills/scaffolding/scripts/scaffold.py worker \
  --name my-worker \
  --domain platform \
  --description "What this worker does" \
  --tools "Read,Write,Bash"

# Action (former command) — RETIRED. Prints guidance to add the action to the
# domain router skill; writes no file.
python .claude/skills/scaffolding/scripts/scaffold.py command \
  --name my-action \
  --domain engineering \
  --description "What this action does"

# Hook
python .claude/skills/scaffolding/scripts/scaffold.py hook \
  --event PreToolUse \
  --script validate-tool-use \
  --description "Validates tool usage"