Drop the awkward "Working with X" naming for the using-* skills in favor
of names that describe what each teaches (e.g. testing-best-practices,
drizzle-queries, ralph-loop-workflow). Rename the skills/ folders,
frontmatter, and H1 headings; update titles, slugs, and cookbook
references in data.tsx; and add redirects for every old using-* slug.
Make skills/ the hand-authored source of truth: point the recipe loader
at skills/ instead of .agents/skills, delete the outdated skills-build.ts
generator and its package script, refresh the authoring-recipes guidance,
and remove the stale using-* copies under .agents/skills.
The using-* items are now skills, not recipes. Their authored source of
truth moves to .agents/skills/<slug>/SKILL.md; the docs/recipes/using-*.md
files are removed. skills-build.ts publishes every authored skill (including
cookbook members) verbatim into skills/, so the `bunx skills add -s <slug>`
install commands now resolve. The loader, recipe page, API, and MCP read
skill bodies from the authored files.
Reclassify env-validation from skill to setup recipe (it installs a package
and prebuild scripts). Add an install-command CTA on skill pages. Rewrite
all 10 skills for concise, agent-oriented wording per skill-creator
guidance, and update authoring-recipes to document skills as authored
.agents/skills files.
Add an explicit setup vs skill type to recipes (derived from the Skills
tag) so cookbooks can treat using-* skills as an install step rather than
inlined content. Cookbooks now render setup recipes in full and skill
recipes as a compact title + motivation + `bunx skills add` section, and
the skills-install command targets only skill recipes.
Centralize prerequisite injection in loadRecipeMarkdown from the requires
metadata so every using-* recipe lists its setup prerequisites across the
markdown API, MCP, and generated skills (removing the duplicate per-recipe
prereq blocks in the MCP server). Clean up the using-* docs by dropping the
redundant heading and See block, and resync the installed skill copies.
Also fix the Dev Workflow to push directly to main (drop the dead feature
branch step) and codify the recipe tier contract in authoring-recipes and
use-fullstackrecipes.
Reframe the Ralph recipe from a setup ceremony into a "using" workflow
centered on the autonomous loop: context -> tools -> build -> verify ->
iterate. Add a /ralph slash command (prompts for the wide prompt) and a
preflight check that infers active infra from the codebase and verifies
every CLI is installed, linked, and authenticated before the loop starts,
reporting fix commands for anything missing.
Remove user stories entirely (recipes, skills, verify script, and the
docs/user-stories content) since the agent harness manages its own todo
list and tests are the durable acceptance criteria. Remove the ralph
runner scripts and registry item. Add redirects for the old slugs.
Also includes incidental formatting from prior fmt/registry:build runs.
Andre Landgraf