project-setup

fltman's avatarfrom fltman

Set up new Claude Code projects with CLAUDE.md, slash commands, and proper structure

⭐34stars🔀9forks📁View on GitHub🕐Updated Dec 6, 2025

When & Why to Use This Skill

The Project Setup skill automates the initialization of Claude Code environments by generating essential configuration files like CLAUDE.md and custom slash commands. It streamlines project scaffolding across various frameworks including React, Python, Go, and Rust, ensuring a consistent structure that optimizes AI-assisted development and improves agentic workflow efficiency.

Use Cases

  • New Project Scaffolding: Quickly initialize new repositories with standardized structures for React, Python, Go, or Rust, including pre-configured dependencies and boilerplate.
  • Legacy Codebase Integration: Automatically analyze existing projects to generate tailored CLAUDE.md files that help Claude understand local conventions, build scripts, and architecture.
  • Custom Workflow Automation: Set up specialized slash commands (e.g., /review, /test-and-commit) to standardize quality checks and git workflows within the Claude Code interface.
  • Standardizing Team Practices: Deploy uniform project guidelines and instructions across multiple repositories to ensure consistent AI behavior and coding standards for all team members.
nameproject-setup
descriptionSet up new Claude Code projects with CLAUDE.md, slash commands, and proper structure

Project Setup Skill

When to Use This Skill

Activate this skill when:

  • User asks to "set up a new project"
  • User asks to "create a CLAUDE.md"
  • User asks to "initialize Claude Code" for a project
  • User asks to "scaffold" a project
  • User wants to add Claude Code support to existing code

Do NOT use for:

  • General coding questions
  • Editing existing CLAUDE.md (see optimize-claude-md skill)
  • Running or testing projects

Prerequisites

  • Write access to target directory
  • For existing projects: ability to read config files (package.json, pyproject.toml, etc.)

Instructions

Step 1: Determine Project Type

Analyze the target directory:

# Check for Node.js/TypeScript
ls package.json 2>/dev/null && echo "Node.js project"

# Check for Python
ls pyproject.toml requirements.txt setup.py 2>/dev/null && echo "Python project"

# Check for Go
ls go.mod 2>/dev/null && echo "Go project"

# Check for Rust
ls Cargo.toml 2>/dev/null && echo "Rust project"

If no config files exist, ask the user what type of project they want to create.

Step 2: Gather Project Information

For new projects, ask:

  1. Project name
  2. Project description
  3. Primary language/framework
  4. Any special requirements

For existing projects, extract from:

  • README.md (description)
  • Package config (dependencies, scripts)
  • Existing folder structure

Step 3: Generate CLAUDE.md

Use the appropriate template:

  • React/TypeScript → /templates/claude-md/react-typescript.md
  • Python API → /templates/claude-md/python-api.md
  • Full Stack → /templates/claude-md/fullstack.md
  • Other → /templates/claude-md/minimal.md

Fill in all {{PLACEHOLDER}} values with actual project information.

Step 4: Create Slash Commands

Set up .claude/commands/ with useful commands:

Essential commands:

  • review.md - Code review
  • test-and-commit.md - Quality check and commit

Copy from /templates/commands/ and customize.

Step 5: Verify Setup

  1. Ensure CLAUDE.md is valid markdown
  2. Check that referenced commands/paths exist
  3. Test that any scripts are executable

Step 6: Provide Next Steps

Tell the user:

  1. How to use the generated configuration
  2. How to customize further
  3. Recommended MCP servers for their stack

Examples

Example 1: New React Project

User says: "Set up a new React TypeScript project called my-app"

Actions:

  1. Create my-app/ directory
  2. Run npm create vite@latest . -- --template react-ts
  3. Generate CLAUDE.md from react-typescript template
  4. Create .claude/commands/ with review.md and test-and-commit.md

Result:

my-app/
├── CLAUDE.md
├── .claude/
│   └── commands/
│       ├── review.md
│       └── test-and-commit.md
├── src/
├── package.json
└── ...

Example 2: Existing Python Project

User says: "Add Claude Code support to my Django project"

Actions:

  1. Read existing pyproject.toml and requirements.txt
  2. Analyze project structure
  3. Generate CLAUDE.md tailored to Django
  4. Add relevant slash commands

Verification

After setup is complete:

  1. Read CLAUDE.md - Ensure it's coherent and accurate
  2. Check commands - Verify slash commands are recognized
  3. Test a command - Try /project:review or similar
  4. Run verification - Execute any verification commands listed

Reference Files

  • Templates: /templates/claude-md/
  • Command templates: /templates/commands/
  • Best practices: /docs/best-practices.md