One command, many verbs
beginner·8 min·Markdown for agents
What this lesson teaches
Learn how /design-engineering reads its first word, what happens with no word at all, which aliases mean the same verb, and the short verbs that route a job and stop.
Type /design-engineering into your agent and press Enter, with nothing after it. Nothing runs.
That's on purpose. Watch what it does instead.
One entry, one word
The skill has a single . Everything else is the first word you type after it, the , followed by a target: a file, a folder, a symptom in quotes.
$ /design-engineering review src/PricingCard.tsxThe skill reads that first word and looks it up in its . If it's a verb, it opens that verb's and follows it exactly. Each command file is a whole procedure on its own: what to read, in what order, what to return, where to hand off.
The four rules of dispatch
A verb (or its alias)
Open its command file. The rest of your words are the target.A plain request
"Why does this card feel flat" isn't a verb, so the router runs: it finds your design contract, works out the phase, and names one or two owners.No words, but a design request already in the chat
Treat that request as the plain request.No words, no request
Show the menu, lead with the 2–3 verbs that fit what's in front of it, and wait.
What "fits" means: a diff on your branch leads with review; a .design file leads with tokens; a video file leads with film review; launch week leads with ship. A bare command never auto-runs a verb. A wrong guess spends a whole pass, and surprises nobody wants.
If two verbs fit your words, it asks once. If none fits and the job isn't design (backend logic, data, build tooling), it says no skill applies.
Which verb? Describe it
You don't need to memorise the table. Describe your situation in your own words and see which verb answers it.
/design-engineering polish app/settings/page.tsx- Posture
- Build: edits, then shows
- Returns
- The edits and up to five rows of what changed
Aliases: other names for the same verb
Most verbs answer to a second or third name, an , so whatever word comes to you first works.
| Verb | Also answers to |
|---|---|
review | review-ui, critique |
polish | finish |
motion | motion-audit, animate |
mobile | native-feel |
break | worst-case, break-ui |
tells | unslop, scan-ai-tells |
a11y | accessibility |
tokens | contract, apply-design-md |
ship | prep, prod, launch |
film | film-review, video |
stage | faux-ui, demo, bento, product-shot |
help | menu, ? |
The short verbs
A handful of verbs are small: each hands the job to one owner and stops where that owner says stop.
| Verb | Does | Stops after |
|---|---|---|
options | three to five real directions behind a picker | your pick |
name | the precise word for a thing | one line, no code |
which | who owns a job, and why | three lines; it doesn't do the job |
pick | one maintained library for a task | one recommendation, or "a few lines of code would do" |
diagram | whether to draw at all, and where | the figure or the canvas |
agentation | the fix loop for browser annotations | one annotation at a time |
pov | fork your taste file, or draft a gotcha | your yes, never an overwrite |
options has its own small modes once you've seen the first three:
riff
Three more directions near the one you liked.tune
A control panel on the kept direction, and nothing else.mix
Parts of the other variants carried onto your chosen base, as a list of portable features.keep
Write the decision down, delete the harness, keep the worst-case data.
/design-engineering name "the menu grows out of the button that opened it" /design-engineering which "a toast that screen readers never announce" /design-engineering options riff
pick reads your package.json first. It never adds a rival to something you already have.
Every verb keeps its posture
Each verb names a and holds it. review, tells and a11y judge: they report and never edit unless you ask afterwards. polish, mobile and ship fix. break is an adversary that reports and stops. name answers and stops.
And every verb applies your two override files, gotchas and pov, plus your project's design contract, which outranks both.
Quick check
You type /design-engineering with no words. You're on a branch with four changed files. What happens?
In the skill
The nodes your agent reads when it does this work.
- MOC — CommandsThe verbs behind the single entry `/design-engineering [verb] [target]` — one command file per job, each a whole procedure that points into the graph.
commands/MOC-commands - The short verbsThe short verbs — diagram, options, name, which, agentation, pov — each one owner and a stop condition.
commands/cmd-small
Connected lessons
What this lesson builds on and leads to, across every course.