A Stario app has one predictable shape: a small bootstrap, routes as values, one folder per page, views that are pure functions. That shape is what makes agents good at it. The rest is giving the agent the rules once, in a file it reads before it writes.
Those rules live in stariodev/stario-create: an AGENTS.md that states the layout, the live-page default, what a signal holds, and the test shape; a set of skills for optional stacks; and the stario-create CLI that installs all of it.
A new app#
uvx stario-create new my-appcd my-appjust devstario-create new creates a runnable project: a uv project, the folder layout from the guide with one static page, AGENTS.md at the root, lint and test configuration, the skills under .agents/skills/ with a link to each one from .claude/skills/, and a justfile of dev tasks (just dev reloads on change, just check runs every check). From git, uvx --from git+https://github.com/stariodev/stario-create stario-create new my-app does the same thing.
An existing app#
curl -o AGENTS.md https://stario.dev/AGENTS.mdnpx skills add stariodev/stario-createThe second command copies every skill into your agent’s skill folder: .agents/skills/, .cursor/skills/, .claude/skills/, and so on. Without Node, uvx stario-create sync does the same for .agents/skills/ and links each skill from .claude/skills/.
Claude Code 2.1.277 and later reads AGENTS.md when the repo has no CLAUDE.md. Claude Code reads skills from .claude/skills/ only, so the links are how it finds them.
Keep your own notes in the ## This app section at the end of AGENTS.md. stario-create sync --check tells you when the guide or a skill is stale, and stario-create sync replaces everything above that section and re-copies the skills without losing your notes.
The skills#
| Skill | Use it when |
|---|---|
stario-feature | You add or remove one page: a resource with its own URL. |
stario-auth | The app needs login: a signed session cookie, current_user(c), protected pages. |
stario-litewriter | The app stores data in SQLite through litewriter. |
stario-tailwind-daisyui | The app is styled with Tailwind v4 and DaisyUI through the standalone binary. |
An agent loads a skill when the task matches its description. You can also open one yourself; each is a short procedure.
What stario.dev serves#
For tools that read web context:
/AGENTS.md — the guide.
/llms.txt — a short index of the guide, the skills, and these docs.
/llms-full.txt — the guide and all skills in one file.
/skills/ and
/skills/<name>/SKILL.md— each skill on its own.
By the way#
Point the agent at the closest example when it starts a feature. Chat room is the reference layout; Realtime tiles is the one-file form.
The guide and the docs say the same things in two voices. The docs explain; the guide instructs. When they disagree, the guide is older or newer than the docs, and an issue on either repository is welcome.