dryui-init

/dryui:init

Bootstrap DryUI in the current project, or scaffold a new SvelteKit app when the user asks for a new project.

Install Or Refresh This Skill

The durable install path for DryUI skills is:

npx skills add rob-balfre/dryui

Skill Discipline

This is a short, linear flow. Do not create per-step TaskCreate items — the bookkeeping costs more than the work it tracks. One intent line up front and one summary line at the end is enough.

First tool call is always the script. Do not run an explicit pre-triage ls/[ -f X ] call — the script self-triages and routes via exit code:

bash <skill-base-dir>/scripts/bare-skeleton.sh "$PWD"

• Exit 0 → done. Print one summary line and stop.
• Exit 2 with route=existing-sveltekit → follow Apply Setup below.
• Exit 2 with route=ambiguous → ask the user one question (scaffold over / integrate / abort), then act on the answer.
• Any other non-zero → read the message, fix the specific issue, do not re-run the whole thing manually.

Do not Read any file you just copied from templates/ to verify it — those files are validated by bun run check at the end of the script. Do not run bunx sv@latest create into a temp dir. Do not overwrite package.json with Write — the script uses jq to merge so user-set keys (especially overrides) are preserved.

What The Script Does

scripts/bare-skeleton.sh is the single entry point. It self-triages and either bootstraps a bare skeleton or exits 2 with a routing hint. Steps in order:

1. Triage — exits 2 with route=existing-sveltekit if svelte.config.* is present, or route=ambiguous if src/ exists without a config.
2. Removes index.ts / index.js from the bun init skeleton.
3. Copies every file in templates/ into the project root, including local AGENTS.md / CLAUDE.md instructions that force UI agents through dryui-build.
4. Merges scripts, lucide-svelte into dependencies, devDependencies, and type: "module" into package.json via jq. Preserves existing overrides and any other dependency keys.
5. Appends SvelteKit/Vite ignores to .gitignore (idempotent — checks for /.svelte-kit first).
6. Detects a local dryui workspace at $DRYUI_LOCAL, ../dryui, ~/dryui, ~/src/dryui, or ~/code/dryui. If found, runs bun link in each packages/{ui,lint,primitives,feedback,feedback-server} and writes overrides with link:@dryui/<pkg> so the consumer pulls the local workspace. If not found, falls back to bun add @dryui/ui + bun add -d @dryui/lint @dryui/feedback @dryui/feedback-server against npm.
7. Runs scripts/setup-feedback-agents.sh "$PWD" to copy project-local DryUI skills, detect installed feedback agents, merge project-local MCP config files where possible, and write dryui.config.json.
8. Runs bun run check to validate the contract end-to-end.