Project Scaffolder
Generate production-ready starter repositories with best-practice conventions for any tech stack.
Core Workflow
- Determine stack: Ask user to specify or infer from context (Next.js, Vite, Nest, FastAPI, etc.)
- Select template: Use references/templates.md to choose the appropriate project structure
- Generate structure: Create complete folder tree with all necessary files
- Add baseline code: Include working "hello world" route/page as proof of concept
- Configure tooling: Add package.json/requirements.txt, tsconfig, linting, formatting configs
- Create scripts: Include dev, build, test, and deployment scripts
- Document setup: Generate comprehensive README with setup steps and next actions
Key Deliverables
Every scaffolded project must include:
- Folder tree: Well-organized src/, lib/, config/, tests/ structure
- Baseline code: Working hello world endpoint or page
- Package files: package.json, requirements.txt, Cargo.toml, etc.
- Configs: TypeScript, ESLint, Prettier, environment files (.env.example)
- Scripts: npm scripts or Makefile for common tasks
- README: Setup instructions, tech stack overview, next steps
- Git setup: .gitignore configured for the stack
Stack-Specific Patterns
See references/templates.md for detailed patterns per stack:
- Next.js App Router
- Vite + React
- NestJS
- FastAPI
- Express + TypeScript
- Vue + Vite
- SvelteKit
Best Practices
- Use absolute imports (@/ alias) where supported
- Include environment variable templates
- Add basic error handling and logging setup
- Configure path mappings in tsconfig
- Include Docker files for containerization (optional)
- Add GitHub Actions or CI workflow templates (optional)
Progressive Enhancement
Start with minimal viable structure, then add:
- Database setup (Prisma, TypeORM, SQLAlchemy)
- Auth scaffolding (NextAuth, Passport, JWT)
- API client setup (Axios, Fetch wrapper)
- State management (Zustand, Redux, Pinia)
- Testing setup (Jest, Vitest, Pytest)
Output Structure
Present the complete project tree first, then create all files in proper locations. Always provide a summary of what was created and next steps to run the project.
1---
2name: project-scaffolder
3description: Generates complete starter repositories for various tech stacks (Next.js, Vite, Nest, FastAPI, etc.) with best-practice conventions, folder structure, baseline code, configs, scripts, and setup documentation. Use when users request to "scaffold a project", "create a starter repo", "initialize a new project", or specify a tech stack to begin with.
4metadata:
5 source: https://skillmd.com/skills/patricio0312rev/project-scaffolder
6---
7
8# Project Scaffolder
9
10Generate production-ready starter repositories with best-practice conventions for any tech stack.
11
12## Core Workflow
13
141. **Determine stack**: Ask user to specify or infer from context (Next.js, Vite, Nest, FastAPI, etc.)
152. **Select template**: Use references/templates.md to choose the appropriate project structure
163. **Generate structure**: Create complete folder tree with all necessary files
174. **Add baseline code**: Include working "hello world" route/page as proof of concept
185. **Configure tooling**: Add package.json/requirements.txt, tsconfig, linting, formatting configs
196. **Create scripts**: Include dev, build, test, and deployment scripts
207. **Document setup**: Generate comprehensive README with setup steps and next actions
21
22## Key Deliverables
23
24Every scaffolded project must include:
25
26- **Folder tree**: Well-organized src/, lib/, config/, tests/ structure
27- **Baseline code**: Working hello world endpoint or page
28- **Package files**: package.json, requirements.txt, Cargo.toml, etc.
29- **Configs**: TypeScript, ESLint, Prettier, environment files (.env.example)
30- **Scripts**: npm scripts or Makefile for common tasks
31- **README**: Setup instructions, tech stack overview, next steps
32- **Git setup**: .gitignore configured for the stack
33
34## Stack-Specific Patterns
35
36See `references/templates.md` for detailed patterns per stack:
37
38- Next.js App Router
39- Vite + React
40- NestJS
41- FastAPI
42- Express + TypeScript
43- Vue + Vite
44- SvelteKit
45
46## Best Practices
47
48- Use absolute imports (@/ alias) where supported
49- Include environment variable templates
50- Add basic error handling and logging setup
51- Configure path mappings in tsconfig
52- Include Docker files for containerization (optional)
53- Add GitHub Actions or CI workflow templates (optional)
54
55## Progressive Enhancement
56
57Start with minimal viable structure, then add:
58
59- Database setup (Prisma, TypeORM, SQLAlchemy)
60- Auth scaffolding (NextAuth, Passport, JWT)
61- API client setup (Axios, Fetch wrapper)
62- State management (Zustand, Redux, Pinia)
63- Testing setup (Jest, Vitest, Pytest)
64
65## Output Structure
66
67Present the complete project tree first, then create all files in proper locations. Always provide a summary of what was created and next steps to run the project.