skill-forge

Overview

skill-forge is a self-learning meta-skill. When an agent hits a knowledge gap on a topic — a library, framework, tool, or domain — it invokes skill-forge to produce a focused, portable skills/<slug>/SKILL.md. skill-forge first looks for existing published skills to use as source material, researches the topic on the web, verifies the findings against their sources, then synthesizes a new skill (or improves a related skill it made earlier) following the canonical standard template. Every skill it produces is project-agnostic and agent-agnostic, carries a forge: mark so it can be improved later, and is returned inline for immediate same-turn use. A broad topic that warrants several skills is handled by recommending and forging multiple skills in parallel.

When to activate

• ✅ An agent or user hits a knowledge gap on a specific topic/library/framework/tool/domain and wants a reusable skill for it.
• ✅ "Research X and turn it into a skill."
• ✅ Extending a related forge-made skill with new coverage (improve mode).
• ✅ A broad topic that should become several focused skills (multi-skill fan-out).

Do NOT activate when:

• The topic is project-specific and cannot be generalized — write a project-local note instead.
• The topic is skill-forge itself or a self-recursion alias — the recursive-forge guard refuses; edit skills/skill-forge/SKILL.md directly to improve it.
• The topic is too vague to name a concrete subject — ask the user to refine it first.