Nehad Al Ghadri on stage, holding a microphone

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.

All work