Skill Evolver
Solve first. Materialize later.
Workflow
Phase 0: Setup Output Directory
Create a timestamped output directory for this session:
# Format: output/MM-DD-<feature-slug>/
# Example: output/03-09-pdf-translate/
mkdir -p "output/$(date +%m-%d)-<feature-slug>"
Tip: Use a short slug derived from the task (e.g.,
pdf-translate,data-export,api-integration)
Store the output path for subsequent phases:
OUTPUT_DIR=output/<created-directory>
Phase 1: Intent Analysis
Analyze the user task and output ${OUTPUT_DIR}/01-intent.md.
See template: references/templates/01-intent.md
Phase 2: Skill Search
Follow the complete skill search workflow: → references/skill-search.md
This workflow covers:
- CLI prerequisites and installation
- Local + Registry (dual-track) search
- Skill selection checkpoint
- Installation and verification
- Security audit
Output files:
${OUTPUT_DIR}/02-candidates.md- Merged search results${OUTPUT_DIR}/02-verify.md- Installation verification (if installed)${OUTPUT_DIR}/02-audit.md- Security audit report (if installed)
Phase 3: Deep Inspection
For each candidate skill, perform deep analysis:
Follow the workflow: references/skill-inspector.md
Output: ${OUTPUT_DIR}/03-inspection.md
Checkpoint: Approach Decision
After inspection, evaluate whether skills can solve the task:
LLM evaluates:
- Do skill capabilities match task requirements?
- Is modification needed?
- Is fusion beneficial?
LLM Recommendation:
- Orchestration (skills match well, no major modification)
- Fusion (skills partially match, combining creates new value)
- Native (no suitable skills found)
Options for user:
- A: Orchestration (LLM recommended)
- B: Skill Fusion (enter coding mode)
- C: Use native abilities instead
- D: Re-analyze (return to Phase 3)
Phase 3.5: Skill Fusion (Conditional)
Only if approach is Fusion
Follow the complete skill fusion workflow: → references/skill-fusion.md
This workflow covers:
- Fusion spec design
- Invoke skill-creator
- Audit fused skill
Output files:
${OUTPUT_DIR}/03-fusion-spec.md- Fusion specification${OUTPUT_DIR}/03-fusion-audit.md- Security audit (if fusion)
Phase 4: Orchestration
Design execution plan and output ${OUTPUT_DIR}/04-orchestration.md.
See template: references/templates/04-orchestration.md
Checkpoint: Plan Confirmation
Use AskUserQuestion tool (or similar tool to Human-in-the-Loop) to confirm plan:
- A: Proceed with this plan
- B: Modify the plan
- C: Show alternatives
- D: Additional requirements (then revise)
Phase 5: Execution
Execute the plan. For each step:
- Native: use your own reasoning
- Skill: invoke the skill with appropriate input
Checkpoint: Materialization Decision
Use AskUserQuestion tool (or similar tool to Human-in-the-Loop) to ask about preservation:
- A: Yes, create a new skill (invoke
skill-creator) - B: No, this was one-time
- C: Save as draft for later review
- D: Additional requirements (then adjust scope)
Principles
Priority: native > orchestration > temporary > persistent
- Prefer native for simple tasks
- Prefer orchestration when existing skills can solve it
- Materialize only after validation + proven reuse value
- Always provide option [D] for additional input
- Re-optimize when user provides new information