building-adom-apps

The Adom developer skillpack: how to build software the AI-first way, so every app, CLI, and tool an Adom user writes is a joy for an AI agent to drive.

The centerpiece is hints. The AI tends to never read skills all the way through, and skills get compacted out of context. So your tool teaches the agent from its own output, at the moment of need:

ERROR: skill packages must include a SKILL.md at the package root.
Hint: Move your SKILL.md to the package root, then re-run.
Hint: Run `adom-wiki pkg lint` to see all blockers before publishing.

Every CLI returns OK: / ERROR: + Hint: lines (and a {status, data, hints[]} JSON envelope). Hints carry what the agent cannot be expected to remember: the next command, how long a call takes and when it times out, how to poll a long-running call, pitfalls, which folder to write files to, that an async screenshot/recording will land later (watch with a Monitor), and the shape of what is coming back (e.g. a screenshots[] array with parent and child windows).

Routes to the four pillars: hints, adom-cli-design, app-creator, and the UI design system + adom-ui-linter. Docs get skipped, so the pattern is also enforced by the linter (CLI-02..05) and should be a publish gate.

Install

adom-wiki pkg install adom/building-adom-apps

Installs to ~/.claude/skills/building-adom-apps/. Ships in the adom/core baseline. See SKILL.md.