Forge Skill -- Self-Improvement System

Forge Protocol

Step 1: Detect

Identify the improvement opportunity. Forge recognizes these patterns:

Automatic Detection (AI-initiated):

1. Repeated Pattern -- AI handles the same type of task ad-hoc 3+ times across sessions
2. Mistake Prevention -- AI makes an error that a permanent rule would prevent
3. Workflow Automation -- A multi-step process AI does manually that could be a skill
4. Level-Up Opportunity -- An existing skill has a gap or could handle more cases

Manual Trigger (User-initiated):

• "create skill", "new skill", "forge this"
• "level up [skill]", "upgrade [skill]"
• "self improve", "improve skill"

Step 2: Analyze

Before proposing, gather evidence:

TYPE: [New Skill / Level-Up / New Rule]
TARGET: [Skill name if level-up, or proposed name if new]
TRIGGER: [What pattern/mistake/workflow was detected]
EVIDENCE: [At least 2 concrete examples from conversation or session history]
IMPACT: [What improves if this is implemented]

Step 3: Propose

Present to user in this format:

Forge Detected an Opportunity
==============================

Type: [New Skill / Level-Up]
Name: [proposed-name]
Purpose: [what it would do]
Trigger: [what activates it]
Evidence:
  1. [First concrete example]
  2. [Second concrete example]
Impact: [what improves]

Draft ready -- approve to forge?

Step 4: Await Approval

• User approves -- proceed to Step 5
• User adjusts -- incorporate feedback, re-propose
• User rejects -- note the rejection, do NOT create

CRITICAL: NEVER create or modify skill files without explicit user approval.

Step 5: Create or Update

For NEW skill:

1. Create skill folder: plugins/[plugin-name]/skills/[skill-name]/
2. Write SKILL.md following the standard skill format:
   • YAML frontmatter with name + description (trigger phrases)
   • Activation section (what the AI says when triggered)
   • Context Guard table (when active vs dormant)
   • Protocol steps (step-by-step execution)
   • Mandatory rules
   • Level History (starting at Lv.1)
3. Verify file was created successfully

For LEVEL-UP:

1. Read existing SKILL.md
2. Add new capability section
3. Update description in frontmatter if trigger phrases changed
4. Add new Level History entry with:
   • Level number
   • Capability added
   • Origin (what conversation/incident triggered it)
5. Save updated file

Step 6: Update System Records

After forging, update relevant system files:

• master-memory.md -- add new skill command or update existing
• Skill Plugin System manifest if applicable
• Note the forge in current session memory

Step 7: Confirm

Forge Complete!
================

[New Skill / Level-Up]: [name] Lv.[X]
Location: skills/[name]/SKILL.md
Capability: [what was added]
Origin: [the moment that triggered this]

Your AI evolved!

Forge Principles

1. Human-in-the-loop -- AI proposes, user approves. Always
2. Evidence-based -- never propose without at least 2 concrete examples
3. Origin stories -- every skill and level-up traces back to a real moment
4. Minimal viable skill -- start at Lv.1, evolve organically through use
5. No over-engineering -- only forge what is genuinely needed
6. Respect existing skills -- level-up before creating duplicates. Check if an existing skill could handle the case first
7. Level history is permanent -- append-only record of how the skill evolved

Skill File Template

When Forge creates a new skill, use this structure:

---