THE DESCRIPTION CARD · the words a router reads to wake a skill
WAKES WHEN a skill wakes at the wrong time, or someone writes or reviews a SKILL.md description
THE LOOP
describe.py lint · the eight checks
draft · from the body, if there is none
write the Use-when in the person's words
collide · the pairs that share too much
THE TRIGGER TEST CARD proves it on prompts
NEVER
Open a description on "this skill helps"
Leave out when to use it
Let two skills share a description
IT MAKES lint — the eight checks, a mark out of 8 each; draft — a description from the body: what, when, what it runs; collide — the pairs whose distinctive words overlap past the line.
THE STANDARD the description is the only thing the router reads; third person, what it does, first; use when, in their words; vague words match everything; twelve distinctive words; the draft is a start.
PROOF SELFTEST 10/10 · witnessed in Claude 2026-10-09 · Edition 1.
THE SEAL 98 of 100 · LEGENDARY · WITNESSED · Trigger 5 · Machinery 5 · Law 5 · Portability 5 · Proof 5
IT CAN BE WRONG an AI reading a text file: it can be wrong and can invent a number, a rule, a name or a date; check what matters against your own records and the source; the risk is yours. THE-CLAUSES.md rides in the packet and is part of the licence.
THE PUNCH · SHA-256 OF SKILL.MD · 578AFAE38C8E4071684DDCFB
CITE THIS CARDTHE DESCRIPTION CARD, Edition 1. Lund Studio LLC, Westminster, Colorado. https://lundr.tech/?view=description-card. Punch 578AFAE38C8E4071684DDCFB. Retrieved 2026-10-10.
What it is.
Lints a skill's description against the eight checks a router cares about — present, the right length, opens on what it does in the third person, says when to use it in the words a person would say, no vague words, not first person, names what it runs, enough distinctive words — drafts one from the skill's own body, and finds the pairs of skills in a folder whose descriptions overlap enough to be picked for the same ask.
It carries a machine that shows its working: lint — the eight checks, a mark out of 8 each; draft — a description from the body: what, when, what it runs; collide — the pairs whose distinctive words overlap past the line — 10 checks in its selftest, every command on the record. It will never open a description on "this skill helps"; never leave out when to use it; never let two skills share a description.
Six laws, written into the card.
They are in the card itself, so the AI follows them.
THE DESCRIPTION IS THE ONLY THING THE ROUTER READSEvery word in it is a routing word; every word not in it is unreachable.
THIRD PERSON, WHAT IT DOES, FIRST"Checks a brief…" — the first verb is the first match.
USE WHEN, IN THEIR WORDSThe ask as a person says it, not the feature as the builder names it.
VAGUE WORDS MATCH EVERYTHINGand therefore nothing: powerful, various, helps with — out.
TWELVE DISTINCTIVE WORDSor the router cannot tell this skill from the next; collide names the pairs.
THE DRAFT IS A STARTThe draft is a start, never the end: the Use-when clause is written by someone who has heard the ask.
What rides in the card.
In the card’s own voice, with a machine that shows its working.
THE GUIDEreferences/THE-EIGHT-CHECKS.md
THE MACHINEdescribe.py · three commandslint — the eight checks, a mark out of 8 each; draft — a description from the body: what, when, what it runs; collide — the pairs whose distinctive words overlap past the line. Every command prints its working and refuses a bad input; 10 checks in its selftest, every command on the record.
What it does once your AI has it.
lint The eight checks, a mark out of 8 each
draft A description from the body: what, when, what it runs
collide The pairs whose distinctive words overlap past the line
On the record Two descriptions linted — the real one 8/8, the "powerful helper" failing five of eight by name; a description drafted for the helper from its own body with the Use-when left for a person to write; the folder of three checked for collisions, and the two brief cards found waking on the same words.
What it will never do.
It will never open a description on "this skill helps"; never leave out when to use it; never let two skills share a description.
The checks are a floor for form; they cannot tell a true description from a false one. collide measures shared words, not shared meaning: two skills can collide in words and differ in purpose. THE TRIGGER TEST CARD runs the real prompts. It is an AI reading a text file: it can be wrong, so check what matters against your own records and the source.
What’s in the buy.
CARD.md — the whole card: who it is, its laws, when it says no, what it carries · SKILL.md — the door your AI reads first · START-HERE.md — the first five minutes, for you
THE-EIGHT-CHECKS.md — the guide in references/, in the card's own voice
scripts/describe.py — the machine: lint · draft · collide, standard library only, selftest 10/10
WITNESS.md + SELFTEST.md — every command on the record, as it printed · MANIFEST.md, every file hashed · AUDIT.md, the twelve checks
MY-LEDGER.md — the card's memory, on your own machine · TIN.md · LICENSE-NOTE.md · THE-CLAUSES.md · HOSTS.md
card.svg + card-machine.svg + card.json · card.html, the card as one offline file · the doors for ChatGPT, Gemini, Cursor, Claude Code and MCP hosts (rules/, system/, mcp/)
PROOF · SELFTEST 10/10 · 3 COMMANDS ON THE RECORD · WITNESSED IN CLAUDE 2026-10-09 · EDITION 1 · PUNCH 578AFAE38C8E4071684DDCFB
ON EVERY DOOR · A CARD FOR YOUR AI, A FILE FOR YOUR COMPUTER
In Claude: turn on code execution under Settings › Capabilities, then Customize › Skills › + › Create skill, and upload the zip as it is — START-HERE.md in the box walks you through it, and tells you how to keep the ledger. In ChatGPT, Gemini and the rest: a Project, a GPT or a Gem with the card’s files attached and the short door in the box pasted as its instructions. The words run anywhere an AI reads Markdown; the machines run wherever the host runs Python. Witnessed in Claude only. The host marks →
Take it.
Nº 901 PROPOSED — LAUNCHING SOON
Sold as is under the term printed. A card instructs an AI you operate; results depend on your model, your files and your judgement. Not medical, legal, tax or financial advice, never the person’s boss, and not a licence to practise. The terms →
One payment. The file is yours to keep and keeps working at its edition; new editions issued in the year after you buy reach you by email as replacement files. Tax is added at checkout where it applies. Nothing auto-renews.
A TERM, NOT A SUBSCRIPTION: NOTHING RENEWS ITSELF AND NOBODY IS CHARGED AGAIN. WHEN A TERM ENDS THE FILES STAY ON YOUR COMPUTER AND STAY READABLE — FREEZE, NOT LOSS.
THE MACHINE · IN THE OPEN · FROM THE WITNESSED RUN OF 2026-10-09
describe.py, every command showing its working.
A small Python program, standard library only. Your AI runs it; you can too. Every block below is pasted from the card’s own WITNESS.md, as printed.
lint
the eight checks, a mark out of 8 each
draft
a description from the body: what, when, what it runs
collide
the pairs whose distinctive words overlap past the line
selftest
10 checks that prove the machine; it must print 10/10
lint · THE EIGHT CHECKS, A MARK OUT OF 8 EACH
$ python3 scripts/describe.py lint skills/brief-card skills/helper-card
brief-card · 8/8 · skills/brief-card/SKILL.md
PASS · has a description at all
PASS · between 60 and 1024 characters (216)
PASS · opens on what it does, in the third person (Builds…, Checks…), not on a noun or "helps with"
PASS · says when to use it (a "Use when…" clause with the words a person would actually say)
PASS · no vague or sales words
PASS · not in the first person
PASS · names what it runs, if it runs anything
PASS · carries at least twelve distinctive words a router can match (19)
helper-card · 2/8 · skills/helper-card/SKILL.md
PASS · has a description at all
FAIL · between 60 and 1024 characters (59)
FAIL · opens on what it does, in the third person (Builds…, Checks…), not on a noun or "helps with"
FAIL · says when to use it (a "Use when…" clause with the words a person would actually say)
FAIL · no vague or sales words (helps with, powerful, various)
PASS · not in the first person
FAIL · names what it runs, if it runs anything
FAIL · carries at least twelve distinctive words a router can match (5)
draft · A DESCRIPTION FROM THE BODY: WHAT, WHEN, WHAT IT RUNS
$ python3 scripts/describe.py draft skills/helper-card
name: helper-card
description: Checks a hand-off brief for the seven parts an agent needs. Use when someone is about to hand work to another agent. Runs scripts/brief.py (check · cut).
the draft marks 8/8 — read it, then write the Use-when clause in the words a person would say
collide · THE PAIRS WHOSE DISTINCTIVE WORDS OVERLAP PAST THE LINE
$ python3 scripts/describe.py collide skills
3 skills · 3 pairs · 1 past the line at 0.50
brief-card ↔ brief-twin-card · containment 0.71 · jaccard 0.43 · shared: agent, brief, check, checks, missing, names, parts, scripts
THE NUMBERS, NAMES AND DATES IN THESE RUNS ARE THE STUDIO’S OWN EXAMPLES, INVENTED FOR THE RECORD; NO REAL COMPANY, PERSON OR PROPERTY IS NAMED.
QUESTIONS AT THE TABLE
Asked before the wire.
What does it need from me?
Describe.py lint · the eight checks. It asks first for the SKILL.md files, and the words people actually say when they want each one.
Does it send anything anywhere?
No. The machine is a standard-library Python program that runs on your own computer and sends nothing anywhere; the words run wherever an AI reads Markdown. No server, no account, no key.
What is on the record?
The self-test (10/10) and every command run on real example inputs, pasted into WITNESS.md as they printed; the punch on the face is the SHA-256 of SKILL.md, so a downloaded copy can be checked against this room.
Can it be wrong?
Yes — it is an AI reading a text file. The checks are a floor for form; they cannot tell a true description from a false one. collide measures shared words, not shared meaning: two skills can collide in words and differ in purpose. THE TRIGGER TEST CARD runs the real prompts.
What will it never do?
It will never open a description on "this skill helps"; never leave out when to use it; never let two skills share a description.
