Spec to Repo
Spec to Repo turns a natural-language project specification into a complete, runnable starter repository for any stack. It interprets the spec, designs the architecture, generates real code (not stubs), and validates the output.
✨ What it does
- Parses specs to extract app name, features, stack, auth, database, API, and deploy target.
- Infers tech stack from signals like 'web app' or 'API' when not specified.
- Generates real, syntactically valid code with no placeholders.
- Creates README, .env.example, .gitignore, CI config, and tests.
- Validates output with a script checking for common issues.
- Supports progressive enhancement for complex specs.
🎯 When to use it
- User provides a text description of an app and wants code.
- User has a PRD, requirements doc, or feature list and needs a codebase.
- User says 'build me an app that...', 'scaffold this', or 'bootstrap a project'.
- User wants a working starter repo, not just a file tree.
🚀 How to use
Trigger by asking to build an app from a spec, e.g., 'build me an app that...' or 'create a project from this spec'. Provide a natural-language description of the app, including features, tech stack preferences, and any specific requirements. The skill will present an interpretation and file tree for confirmation before generating.
Example prompts:
Build me a task management API with FastAPI and SQLite.
I want a recipe sharing website using Next.js and PostgreSQL.
📄 Output: A complete, runnable starter repository with source code, configuration files, tests, and documentation.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/product-team/skills/spec-to-repo .claude/skills/spec-to-repoSkill source: product-team/skills/spec-to-repo/SKILL.md
⚠️ Good to know
Not for SaaS apps with Stripe and Auth specifically; use the saas-scaffolder skill instead. Requires a clear spec; ambiguous specs may need up to three clarifying questions.
❓ FAQ
What stacks does this skill support?
It is stack-agnostic and supports Next.js, FastAPI, Rails, Go, Rust, Flutter, and more, inferring the stack from the spec if not specified.
Does it generate placeholder code?
No, it generates real, working code with no TODO or pass placeholders; every function has a real implementation.
What if the user wants a SaaS app with Stripe and Auth?
The skill directs to use the product-team/saas-scaffolder skill instead, as this skill is not intended for that specific use case.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.