skill-forge
/skill-forge
Promote a procedure that was worked out end-to-end and verified into a reusable skill file, so the next similar task starts from the solved path. Use when a hard-won procedure succeeds with evidence, when the same multi-step task appears a second time, or when the user says "make this repeatable".
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 25.08.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Promote a procedure that was worked out end-to-end and verified into a reusable skill file, so the next similar task starts from the solved path. Use when a hard-won procedure succeeds with evidence, when the same multi-step task appears a second time, or when the user says "make this repeatable".
Triggers from the description
Original author description
Promote a procedure that was worked out end-to-end and verified into a reusable skill file, so the next similar task starts from the solved path. Use when a hard-won procedure succeeds with evidence, when the same multi-step task appears a second time, or when the user says "make this repeatable".
How it works
- When to forge
- What goes in the file
- Relation to pin
- Freshness
SKILL.md preview
--- name: skill-forge description: Promote a procedure that was worked out end-to-end and verified into a reusable skill file, so the next similar task starts from the solved path. Use when a hard-won procedure succeeds with evidence, when the same multi-step task appears a second time, or when the user says "make this repeatable". --- # Skill forge Some tasks are solved once and then re-solved forever: the deploy that took an afternoon of trial and error, the migration that only worked in one specific order, the flaky test that needed three environment tweaks. The solving was real work; letting it evaporate means paying for it again. When a procedure has been driven from start to finish and the success was **checked, not declared**, forge it into `.claude/skills/<name>/SKILL.md` — the next similar task starts where this one ended. ## When to forge Both conditions, not either: 1. **It will recur.** The task shape is likely to come back — same project or same class of problem. One-off procedures stay in the session log. 2. **Success was verified.** A check passed: the build is green, the endpoint responds, the output was inspected. "It seemed to work" forges nothing — a skill built on an unverified run teaches the next session a guess. ## What goes in the file The skill file records the procedure **as it actually ran**, not as it should have run in theory: - **When to use** — the task shape that triggers it, specific enough that the wrong task won't match. - **Procedure** — the steps in the order that worked, including the traps hit along the way (`step 3 fails silently if the cache wasn't cleared first` is the most valuable line in the file). - **Verified** — the date the procedure last succeeded. - **Evidence** — what confirmed success: the test that passed, the file that existed, the output that was checked. This line is what separates a skill from a hopeful note. - **Source** — the `memory/knowledge/` entry the procedure rests on, when there is one. Include this line only in that case; it is what makes the third freshness trigger below reachable. Frontmatter follows the usual shape: `name` matching the directory, `description` saying what it does and when to use it. ## Relation to pin pin promotes a **one-line rule** — a correction or preference that should arrive with matching messages. skill-forge promotes an **entire procedure** — multiple steps, ordering, traps. When a lesson fits in a sentence, pin it; when it only fits in a walkthrough, forge it. A forged skill often yields one pin as a by-product: the single sharpest trap, delivered even when the skill isn't opened. ## Freshness A procedure is a claim that these steps still work. Three triggers force a refresh: the verification date is more than 90 days old, the procedure fails when followed, or the knowledge entry this procedure rests on changed. Any of them, re-run it, fix what changed, and update the date and evidence — a skill that silently stopped working is worse than no skill, because it carries the authority of a past success. --- *Part of [ballast](https://github.com/svy04/ballast) — foundations first, every solved path kept, done means checks pass.*
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · svy04/ballast | 90 | MIT |
| tonydzi/second-brain-starter-kit | 100 | MIT |
| frankxai/starlight-intelligence-system | 100 | MIT |
| antoniocascais/claude-code-toolkit | 100 | AGPL-3.0 |
| Adit-Jain-srm/skill-forge | 100 | MIT |
| sanyuan0704/sanyuan-skills | 100 | MIT |
| mphinance/alpha-skills | 98 | MIT |
| devpilotX/ai-skill-ai | 98 | MIT |
| rune-kit/rune | 95 | MIT |
Database snapshot: 13.11.2026 · package version 1654d8f42f9a (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90codifying-tasks
Turns recurring work into reusable skills. Use when a task being done now has been done before in this project, when the user says "make this repeatable", "turn this into a skill", "we'll be doing this again", or at the natural end of a multi-step task that will clearly recur.… - 90skill-distill
Turns the workflow just completed in the current session into a reusable Agent Skill, capturing the steps that worked, the dead ends, the user's corrections and the verification into a new SKILL.md with supporting scripts. Use when the user says to save this as a skill, make a… - 100skillify
Turn something you just did into a reusable skill and register it in the resolver. Use when the user says "skillify this", "make that a skill", or after completing a non-trivial procedure worth repeating. - 100continuous-learning
Turn a hard-won, multi-step procedure from the current session into its own small skill at ~/.claude/skills/learned-<slug>/SKILL.md, so future sessions load it when the same trigger shows up again (an exact error, a tool limitation, a recurring debugging situation, a multi-step… - 95workflow-skill-creator
Distills a completed user workflow or interaction into a reusable agent skill. Use when the user asks to turn their workflow, interaction, or multi-step process into a skill, or when they say "make this a skill", "create a skill from what we just did", "package this workflow" or… - 100workflow-skill-creator
Distills a completed user workflow or interaction into a reusable agent skill. Use when the user asks to turn their workflow, interaction, or multi-step process into a skill, or when they say "make this a skill", "create a skill from what we just did", "package this workflow" or…