Back to all resources
RESOURCE LIVE

Write a skill once and stop re-explaining yourself.

A skill is a piece of your judgment written down where the agent reads it. Done properly they compose, they version, and they hold up months later. Done the usual way they drift, break quietly, and nobody touches them again. This is the difference.

Raj Singh By Raj Singh · August 2026 · 9 min read
A SKILL, IN THE WILDWhat the agent reads before it starts
SKILL.md · frontmatter
v2.1 · 14 uses this week
name — deploy-check. Loads on any deploy or release request.
triggers — Six phrasings, including the two people actually type.
body — Nine steps, one rollback rule, three worked examples.
Written once. Read every time.Versioned · tested
THE TELL

You write a skill, it drifts, you never open it again.

  • A skill is the difference between an agent that helps today and one that is better in three months. Almost nobody treats them that way.
  • Most published skill content is a list of prompts. Nobody shows the architecture, so nobody's second skill fits alongside their first.
  • Two skills that overlap will fight, and the agent will pick one at random. You find out from an output that is subtly wrong.
  • Skills regress silently. Nothing tells you a skill stopped firing, it just quietly stops being used.
WHAT'S INSIDE

Anatomy, composition, versioning, tests.

  • 01
    The anatomy
    Frontmatter, triggers, examples and version, and what each part does to whether the skill actually loads when it should.
  • 02
    Triggers that fire
    Writing the description so the skill loads on the phrasing people use, not the phrasing you had in mind when you wrote it.
  • 03
    Composition
    Structuring skills so they stack instead of competing, including the scoping rule that stops two from claiming the same job.
  • 04
    The seven to ship first
    The foundational set that pays for itself fastest, in the order I would add them to a new setup.
  • 05
    Tests and versions
    How to catch a skill that has silently stopped firing, and the versioning habit that makes a rollback one line.
BUILT FOR

You, if you keep re-typing the same correction.

If you find yourself telling an agent the same thing every week, that correction is a skill you have not written yet. Start with one, and the pattern is obvious after that.

Why now Skills only recently became worth engineering properly. Once agents began loading them reliably from a description alone, the design of that description turned into the whole game.

The compounding is the real thing. Every correction you write down once is a correction you never make again, and after a few months the agent argues with you less because it already knows the answer.

Person writing notes on paper at a desk
Photo: Hadis Malekie / Unsplash
UNLOCKS WITH YOUR EMAIL
  • 01skills-anatomy.md2.8 KB
  • 02frontmatter-spec.md1.6 KB
  • 03seven-foundational.md3.4 KB
  • 04versioning.md2.0 KB
  • 05testing-skills.md2.2 KB
Get the resource

Drop your email, get the full tool.

One email. Instant access. No sequence, no upsell, no list-trap. I'll only ping you if I ship something that fits.

One email. No follow-up unless I ship something that fits.

The Hook: Superset is a free, open-source code editor built to run 10+ AI coding agents at once, each in its own isolated Git worktree. Pair it with Claude Opus 5 inside Claude Code and Codex agents on GPT-5.5, and you've got an AI dev team running on one Mac.

  • One agent = one task at a time. That's the real bottleneck, not the model.
  • Superset isolates every agent in its own Git worktree, so 10 agents can build features, fix bugs, and write tests simultaneously with zero file conflicts.
  • For solo founders: this is how you deliver client builds in days, not weeks. Same team, 5-10x throughput. That's infrastructure, not tools.
  • Client dashboards: One agent builds the frontend, one wires up Supabase, one writes tests. A week-two deliverable becomes a day-two deliverable
  • macOS (Apple Silicon or Intel). Windows and Linux coming soon
  • Git installed
  • GitHub CLI authenticated. Verify with:
  • Download the macOS app from superset.sh/download and drag it into Applications
  • Open source (12.5K+ GitHub stars) and local-first: works offline, syncs when connected
  • Log into each one once (run claude, then codex) so Superset can launch them already authenticated

↑ Unlocks the moment you submit the form above.

RS
WRITTEN BY

Raj Singh

I'm Raj Singh, founder of DebtOps.ai and a Claude certified partner. Over the last five years I've managed $25M in ads, built AI solutions for Fortune 100 companies, and installed AI operating systems and AI brains inside small businesses. Everything here is something I've shipped, debugged, or watched a client ship. My goal with AgileSingh is to make you irreplaceable in this AI age.

$25M
Ads managed · 5 yrs
F100
Enterprise AI builds
Claude
Certified partner
18
Guides shipped
More guides

Now put the skills in front of a swarm.

Skills scale better than agents do, because twenty agents read the same file. The agent swarm guide is where that pays off, and the setup guide is the config underneath. Browse the library, or pin a slot and we will write your first three.