Skill Forge
A tool I built that makes other AI skills to one house standard, so each new one starts tested and documented.
- Skills packaged to the standard
- 6
- Checks each skill must pass
- 12
Python standard library, Claude Code skills
A skill is a folder of instructions and code that teaches an AI assistant to do one job the way I do it. By June 2026 I had five that worked and none that I could hand to a colleague. Each one was a thin front on a development folder of 300 to 500 MB, with a path to my own Mac written into it. I wrote down what a skill has to be before it can leave my machine, and then I built the tool that makes skills that way.
What I built
- The Standard
- Every skill carries the same eight files: a short router the assistant reads first, a manifest that accounts for every file, a guide written for users and for developers, a read-me, a learnings file, a small configuration file, the self-check and the packager.
- The self-check
- One script runs 12 named checks, and it is byte for byte the same in every skill. A file cannot sit in a package without a manifest line that explains it. Leftover build folders fail the check, and every path the documentation names has to exist. The tests have to pass. The shipped words have to address “the user”, which means the check fails on my name or a client’s.
- Two modes
- Skill Forge brings an existing skill up to the Standard, or it creates a new one from an empty folder. It runs the whole recipe and stops for four decisions that are mine: where the skill lives, which names to scrub, whether to bundle an outside dependency, and what to archive.
- It learns
- At the end of every run Skill Forge saves the corrections I approve, and it reads them at the start of the next one. It refuses to save a lesson that names a person.
What it delivers
Six skills are packaged to the Standard: Bob, Smith, Lens, two HLDD tools and Skill Forge, which passes its own check. A fresh skeleton from the forge fails that check on one thing only: nobody has written its guide yet. The engines I made afterwards, the Learner Guide Engine and Reed among them, pass the same check.
