SKILL.md
The complete 4AF Components workflow and repository contract for coding agents.
4AF Components
4AF is a public shadcn registry at https://4af.selfsimilar.dev. Install and inspect it with
the shadcn CLI. Do not copy component files by hand or guess registry URLs.
Route the task
- To choose or compare components, or answer feature/API questions, read references/component-catalog.md.
- To read one component's complete, agent-friendly reference, fetch
https://4af.selfsimilar.dev/docs/<component>.md: the page's API and notes with separate install and usage code blocks.https://4af.selfsimilar.dev/llms.txtlists every page. - To install into another project, use the workflow below.
- For the exact current component list, run
npx shadcn@latest search https://4af.selfsimilar.dev/r/registry.json -t ui. It needs no setup and prints each component's description and install URL. Treat the reference catalog as a fast guide, not a replacement for it.
Install into a project
Run in the target project:
npx shadcn@latest info
npx shadcn@latest add https://4af.selfsimilar.dev/r/<component>.json --dry-run
npx shadcn@latest add https://4af.selfsimilar.dev/r/<component>.jsonThe target needs a shadcn components.json with ui and lib aliases; run
npx shadcn@latest init first if it has none. info shows the project's setup and resolved
paths. --dry-run lists every file, package, and theme variable the install adds or changes;
--diff shows changes to existing files. The theme, shared utilities, and component
dependencies install with the component. Existing files are skipped unless --overwrite is
passed, which discards local edits, so check --diff first.
To use short names, register the namespace once per project:
npx shadcn@latest registry add @4af=https://4af.selfsimilar.dev/r/{name}.jsonThen npx shadcn@latest add @4af/<component>, search @4af, and view @4af/<component> work.
Afterwards inspect the diff and run the target's own typecheck or build.