Skip to content
Skills Library
AI & agents · Building & coding

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".

Author
svy04 ↗
Repository
ballast ↗
Licence
MIT
Last repository change
25.08.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 25.08.2026, without references to retired models or APIs.

Licence

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

make this repeatable
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

  1. When to forge
  2. What goes in the file
  3. Relation to pin
  4. Freshness
Original SKILL.md headings · 36 lines, 482 words
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

RepositoryScoreLicence
This page · svy04/ballast90MIT
tonydzi/second-brain-starter-kit100MIT
frankxai/starlight-intelligence-system100MIT
antoniocascais/claude-code-toolkit100AGPL-3.0
Adit-Jain-srm/skill-forge100MIT
sanyuan0704/sanyuan-skills100MIT
mphinance/alpha-skills98MIT
devpilotX/ai-skill-ai98MIT
rune-kit/rune95MIT

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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.