add-component
Skill8 starsChanged 4 days agoMITView on GitHub
Add a component to the austere-axi OpenUI library, add a prop to one, or re-enable a stock OpenUI component. Maintainer-only (not shipped). Use for any change under src/runtime/components/ or src/runtime/stock.ts.
9 other projects use a version of this.
Adopted by
Most recently taken up by
- davision0102/fabriktheir own version, first seen Nov 15, 2026
- IntelliHelper/agent-skillstheir own version, first seen Oct 20, 2026
- jpicklyk/task-orchestratortheir own version, first seen Oct 17, 2026
- DailybotHQ/deepworkplan-websitetheir own version, first seen Oct 9, 2026
- Azure-Samples/art-voice-agent-acceleratortheir own version, first seen Oct 8, 2026
- lbedner/aegis-stacktheir own version, first seen Oct 8, 2026
Other versions9 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 9
- signerlabs/ShipSwift★ 3.3ksame name
- jpicklyk/task-orchestrator★ 214same name
- lbedner/aegis-stack★ 146same name
- ahpxex/open-dashboard★ 136same name
- Azure-Samples/art-voice-agent-accelerator★ 74same name
- DailybotHQ/deepworkplan-website★ 15same name
- dperezcabrera/pico-skills★ 4same name
- davision0102/fabrik★ 3same name
- IntelliHelper/agent-skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository5 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- review-changeSkill
- austere-setupSkill
- austereSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
16 rules. 0 are common, 9 are distinctive, and 7 are very specific to this project.
0
Common
Most of the 8 edited versions we read keep these.
9
Distinctive
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 11
Read this whole file before writing code.
- Very specific: line 15
Every component's signature, description and notes are part of the reference every agent reads (austere-axi spec).
- Distinctive: line 17
Add a component only when all three hold:
- Distinctive: line 23
Prefer, in this order:
- Distinctive: line 33
Never add raw HTML or JS escape hatches, components that fetch data, or theming knobs.
- Distinctive: line 35
If a request fails the bar, say so and propose the cheaper option instead of building it.
- Distinctive: line 41
Argument order: put the most-used arguments first, required before optional.
- Very specific: line 42
Input format: prefer one string or string array in a format agents already know (git diff, git status --short, markdown) over nested …
- Distinctive: line 79
Static: no fetching and no timers.
- Very specific: line 81
Dark only: use the --openui-* and --austere-* variables.
- Distinctive: line 106
Run all of these:
- Distinctive: line 119
no horizontal-scroll warning, no render errors and no page errors
- Very specific: line 131
remove it from REMOVED
- Very specific: line 132
add it to a group in STOCK_GROUPS
- Very specific: line 133
add it to STOCK_UNTAGGED if it is value-only
- Very specific: line 139
Commit the component file, its CSS, test/fixtures/signatures.json, and any example change together.
“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Adding a component to austere-axi
Read this whole file before writing code. The tests enforce the mechanical rules (grouping, token budget, append-only props, valid example). This file covers the decisions they can't make.
1. Does it earn its place?
Every component's signature, description and notes are part of the reference every agent reads (austere-axi spec). They cost tokens in every session, in every agent, for good. The budget is 5.8k tokens, enforced in test/library.test.ts; the build prints the current size.
Add a component only when all three hold:
- Real demand: review artifacts (plans, comparisons, decisions, code reviews, reports) keep needing it. Name two concrete artifacts that would use it.
- Composition falls short: existing components can't express it, or can only do it badly enough that agents get it wrong. A file tree built from nested Accordions is an example.
- Better targets: it gives the reviewer something more precise to point at than "the whole card" (see section 4).
Prefer, in this order:
- A note on an existing component.
- A new optional prop on an existing component.
- Re-enabling a stock OpenUI component from
REMOVEDinsrc/runtime/stock.ts. - A new component with
tier: "extended": in the library andcomponents search, out ofspec(one name in its group's notes). - A new core component.
A component only some users need belongs in a pack, not here: austere-axi components new scaffolds one, and it can live in its own repo. Bundle a pack with austere-axi (packs/<id>/, like shadcn) only when it is core-worthy but heavy, so pages that do not use it should not load it.
Never add raw HTML or JS escape hatches, components that fetch data, or theming knobs.
If a request fails the bar, say so and propose the cheaper option instead of building it.
2. Design the call the agent will write
Agents write positional calls, and saved artifacts keep those calls forever.
- Argument order: put the most-used arguments first, required before optional. The first one or two arguments should cover 90% of uses.
- Input format: prefer one string or string array in a format agents already know (git diff,
git status --short, markdown) over nested objects.FileTree(["M src/a.ts", ...])beatsFileTree([{path, status}]). - Enums: lowercase strings, few values.
- Name: a PascalCase noun that does not collide with a stock OpenUI component (the build throws if it does).
- After release: props are append-only, and every appended prop must be optional.
npm run signaturesand the tests enforce this. - Description: one line, at most 280 characters. Say what it is, what input it takes, and what a click on it reaches the agent as.
- Notes: optional
"- "lines, only for things an author would otherwise get wrong. Every line costs tokens.
3. Write the file
A component is one file: src/runtime/components/<Name>.tsx, default-exporting austereComponent({...}). The contract is documented in src/runtime/define.ts. The build picks the file up automatically, so there is no list to edit. Files whose names start with _ are helpers, not components.
A family, meaning a container and its value-only parts, shares one file and default-exports an array in the order the spec should list them. Architecture.tsx is the example: it exports [Architecture, Node, Edge, Group]. Parts reference each other's definition.ref. A part that sits inside another part's prop (an Edge naming two Nodes) reaches the renderer as the parsed element, and its statementId is the name the agent gave it. Use that as its id, and as its own click target with data-oui-id and data-oui-c.
import React from "react";
import { z } from "zod";
import { austereComponent } from "../define.ts";
function ThingView({ props }) {
return <div className="austere-thing">…</div>;
}
export default austereComponent({
name: "Thing",
group: "Content", // Layout | Content | Data | Charts | Forms | Buttons
props: z.object({ items: z.array(z.string()), title: z.string().optional() }),
description: "…one line…",
notes: ["- …only if needed…"],
renderer: ThingView,
example: `myThing = Thing(["…realistic…"])`,
stress: `stressThing = Thing(["…hostile…"])`, // optional; see section 5
// slots: null, tagged: false ← only for value-only sub-components (like Series)
});Renderer rules:
- Static: no fetching and no timers. The only state allowed is UI state, such as expanded or collapsed.
- Lenient: render whatever you can from malformed input, and never throw. Show an inline
.austere-render-erroronly when nothing at all can render. Also callreportRuntimeErrorfrom../env.tsso the error reaches the reviewer's panel. - Dark only: use the
--openui-*and--austere-*variables. Put CSS insrc/runtime/austere.cssunder a/* ── Thing ── */section, with anaustere-thing-class prefix. - Never overflow the column: long paths and code must wrap or scroll inside the component. Check this at 390px.
- No interactive DOM for feedback: let the annotation layer and OpenUI forms carry feedback. A toggle that only changes local UI state is fine.
- Testable parsing: keep input parsing in a plain TypeScript helper (no JSX) next to the component, named
_<name>-parse.ts, so Node can import it. Unit-test it intest/components.test.tsagainst the near-miss shapes agents actually write, such as markdown bullets, lowercase codes, long-form variants, absolute paths and duplicates._filetree-parse.tsand_diff-parse.tsare the existing examples.
4. Make it annotatable
The whole component is already a target, through its statement name. Mark the smaller things a reviewer would point at with data-austere-part="<what the agent should hear>":
- a diff line, as
src/retry.ts:+15 - a node label
- a file path
The part nearest the click wins, and its text becomes the quote. Keep chrome out of that text, including line numbers, status letters, counts and icons. Draw such labels with CSS content: attr(data-…), as Diff does for line numbers and FileTree does for status letters and folder counts, and make icons aria-hidden SVGs.
Plain <table>s get row and column detail automatically, so don't mark their cells.
5. Example and stress
example holds one or more statements. The first one calls the component with realistic content, and every other statement must be reachable from it. When the component has distinct modes worth showing (Architecture's automatic layout and its lanes), example can be a list of such programs; each gets its own gallery card and its own part-click check. Value-only parts (slots: null) may omit example, because their container's example shows them. The example is checked by the tests, rendered in the gallery, and serves as your design review: if it reads awkwardly, the call design is wrong.
stress is optional, but add it whenever the component takes free-form input. It has the same shape as example (a program or a list of them), filled with hostile input: very long unbroken tokens in every text slot, deep nesting, many items, empty values, and the malformed shapes agents write. It never appears in the prompt. The tests check it, and the browser suite renders it at phone width, where overflow bugs hide; realistic examples are too tidy to expose them.
6. Verify
Run all of these:
npm run build # prints prompt tokens; note before/after
npm run signatures # records the new signature; refuses breaking changes
npm test # groups, budget, signatures, example check
npm run gallery -- Thing
npm run shot -- .dev/gallery.html --full --parts
npm run shot -- .dev/gallery.html --full --width 390 --out .dev/shot-390.pngshot needs Chrome, or CHROME_PATH pointing at a Chromium binary. Open both PNGs and look at them. Check for:
- no horizontal-scroll warning, no render errors and no page errors
- readable contrast in the dark theme
- the listed parts are exactly what a reviewer would point at, worded the way the agent should hear them
Then use it the way an agent would. Add it to a realistic page in examples/ and run node dist/cli.mjs check on that page. If you have a browser, also run the loop once: node dist/cli.mjs <page> (with --no-open, open the link from node dist/cli.mjs login <page> instead of the printed url), click a part in Annotate mode, press Send, and confirm that node dist/cli.mjs poll <page> shows detail: {part: …}.
Finally, run the review-change skill. It runs the browser suite (npm run test:browser), which clicks every part through the real review loop, and launches the change-reviewer, visual-qa and cold-start-author agents.
Other changes
- New prop on an existing component: append it, make it optional, then run
npm run signatures. Never reorder, rename or remove a prop. - Re-enabling a stock component:
- remove it from
REMOVED - add it to a group in
STOCK_GROUPS - add it to
STOCK_UNTAGGEDif it is value-only - run
npm run signatures
- remove it from
- Stock renderer behaves wrongly on a static page: override the renderer in
src/runtime/overrides/and register it inSTOCK_RENDERERS, keeping the props unchanged.Tabsis the existing example.
Commit
Commit the component file, its CSS, test/fixtures/signatures.json, and any example change together. State the prompt-token delta in the commit message.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

