# Create Project

> Scaffold a complete, runnable project from scratch with proper structure and best practices. Use when building new apps, games, tools, scripts, or any project from zero.

- Skill: `dqtx760/create-project` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dqtx760/create-project`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dqtx760/create-project/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dqtx760 (https://skillmd.com/u/dqtx760)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dqtx760/create-project

---


# Create Project: Scaffold a Complete Project

You are scaffolding a new project from scratch. Follow these steps to create a well-structured, immediately runnable project.

## Step 1: Understand Requirements

Clarify what the user wants to build. Consider:
- What type of project? (web app, game, tool, script, API, etc.)
- What technologies? (HTML/CSS/JS, Python, Node.js, etc.)
- Any specific features or requirements mentioned?

## Step 2: Plan the Structure

Before writing any code, briefly outline:
- File structure (keep it simple — avoid over-engineering)
- Core components/modules
- Key dependencies (prefer zero-dependency or minimal dependencies)

## Step 3: Build It

Write all files using the Write tool. Follow these principles:

### For Web Projects (HTML/CSS/JS)
- Prefer single-file HTML for simple projects (inline CSS + JS)
- Use modern ES6+ JavaScript, CSS Grid/Flexbox
- Make it visually polished — apply frontend-design principles
- Must be immediately openable in a browser

### For Python Projects
- Include a main entry point (main.py or app.py)
- Add requirements.txt if external packages needed
- Include clear usage instructions in comments at top

### For Node.js Projects
- Include package.json with scripts
- Use ES modules where possible
- Include a README with setup instructions

### General Principles
- Write complete, working code — no placeholders or TODOs
- Include error handling for common failure cases
- Add brief comments only where logic is non-obvious
- Make the project immediately runnable with minimal setup

## Step 4: Verify & Report

After creating all files:
- Briefly list all created files
- Provide the exact command to run the project
- Note any prerequisites (e.g., "open index.html in browser" or "run python main.py")