dev-ready

Scaffold FastAPI and React full-stack projects with selectable engineering flows and agent targets.

2|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/MoofonLi/dev-ready --skill dev-ready-moofonli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-ready
Source: https://github.com/MoofonLi/dev-ready/tree/main/skills/dev-ready
Command: npx skills add https://github.com/MoofonLi/dev-ready --skill dev-ready-moofonli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a production-grade FastAPI + React project with AI-agent-ready configuration involves many manual decisions: choosing an engineering workflow, security and quality tooling, design references, and agent integrations. This Skill turns that into a single guided interview that produces one non-interactive dev-ready init command. ## Core Features & Use Cases - Guided Interview: Resolves seven must-ask questions (project name, engineering flow, security needs, testing, design language, token optimization, coding agents) and maps answers to catalog ids. - Catalog Mapping: Translates developer intent into exact flags for Categories, Engineering Flows (mattpocock, superpowers, addyosmani), Enhancements, and Agent Targets, with strict handling of unknown or conflicting ids. - Safe Execution: Verifies destination safety, runs exactly one approved command with --yes, and interprets exit codes 0-5 with explicit failure reporting. - Use Case: A developer says "I want a polished design-focused app with token-conscious agents using Claude" and receives a validated command like uvx dev-ready init focused-app --yes --flow mattpocock --categories dev,design,token-optimize .... ## Quick Start Ask the agent to scaffold a new FastAPI full-stack project with dev-ready, answer its interview questions, and approve the proposed init command.

Frequently Asked Questions about dev-ready

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a FastAPI React full-stack project with dev-ready?

Run `uvx dev-ready init my-app --yes --dir ./my-app` for the default set, or answer the skill's interview to select an engineering flow, categories, enhancements, and agent targets. The skill composes one approved non-interactive command and runs it exactly once.

What engineering flows does dev-ready support?

Dev-ready offers three flows: mattpocock (user-driven, single working session), superpowers (model-driven with subagent fan-out), and addyosmani (spec-driven through production and shipping). The old id spec-loop was renamed to mattpocock and now exits with code 2.

Can dev-ready modify or upgrade an existing project?

No, `dev-ready init` only creates new projects and must never target an existing generated project. For existing projects, use the `check` or `upgrade` commands instead.

Which coding agents work with dev-ready agent targets?

Dev-ready supports dozens of agent targets such as claude, cursor, windsurf, and goose via `--agents`. Standard-compliant agents like Codex, Cline, and GitHub Copilot read `.agents/skills/` directly and need no target flag.

Why does dev-ready init fail with exit code 2?

Exit code 2 means invalid arguments: an unknown category, item, flow, or agent id, conflicting flags, or a removed flag like --no-mcp. Surface the error as reported and do not guess replacement ids or retry with aliases.