# AI Project Starter Kit — CLAUDE.md + MCP + Skills

> Ready-to-use starter kit for AI-powered projects. Pre-configured CLAUDE.md, essential MCP servers, recommended skills, and project structure templates. Clone and start coding with Claude Code in 2 minutes.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
# Create a new project with AI-ready configuration
mkdir my-project && cd my-project
git init

# 1. Create CLAUDE.md
cat > CLAUDE.md << 'EOF'
# Project: My App

## Stack
- Framework: Next.js 14 (App Router)
- Language: TypeScript (strict mode)
- Styling: Tailwind CSS + shadcn/ui
- Database: PostgreSQL with Drizzle ORM
- Auth: Auth.js (NextAuth v5)

## Commands
- `npm run dev` — Start dev server (port 3000)
- `npm run build` — Production build
- `npm run test` — Run Vitest tests
- `npm run lint` — Run Biome linter

## Code Conventions
- Functional components only
- Server Components by default, Client Components with "use client"
- Use Zustand for client state, React Query for server state
- All API routes return { data, error } shape
- Database queries use Drizzle ORM (no raw SQL)

## File Structure
- src/app/ — Pages and layouts (App Router)
- src/components/ — Shared UI components
- src/lib/ — Utilities, database, auth config
- src/server/ — Server-side logic

## Do NOT
- Do not use Redux, Context API, or class components
- Do not create CSS modules or styled-components
- Do not add comments explaining obvious code
- Do not use any as a TypeScript type
EOF

# 2. Configure essential MCP servers
cat > .mcp.json << 'MCPEOF'
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "POSTGRES_CONNECTION_STRING": "${DATABASE_URL}" }
    }
  }
}
MCPEOF

echo "Done! Open Claude Code and start building."
```

---

## Intro

AI Project Starter Kit is a ready-to-use configuration bundle that sets up Claude Code for maximum productivity in 2 minutes. It includes a battle-tested CLAUDE.md template, essential MCP server configurations, recommended skill installations, and project structure guidelines. Instead of spending 30 minutes configuring each new project, clone this starter kit and immediately have a fully AI-optimized development environment. Best for developers starting new projects with Claude Code who want instant productivity. Works with: Claude Code. Setup time: 2 minutes.

---

## What is Included

### 1. CLAUDE.md Templates

**Web App (Next.js):**
- Stack, commands, conventions, file structure
- Do/Don't rules for consistent AI output
- Database and auth patterns

**API Server (Hono/Express):**
- REST conventions, error handling patterns
- Middleware patterns, validation rules
- Testing and deployment commands

**Python Project (FastAPI):**
- Type hints everywhere, async patterns
- Pydantic models for I/O
- Testing and linting commands

### 2. MCP Configuration (.mcp.json)

Essential servers for every project:

```json
{
  "mcpServers": {
    "github": { "...": "PR management, issue tracking" },
    "postgres": { "...": "Database queries and schema" },
    "filesystem": { "...": "Access to shared config dirs" }
  }
}
```

Optional servers by use case:

| Use Case | MCP Server |
|----------|-----------|
| Web scraping | Firecrawl MCP |
| Search | Tavily MCP |
| Monitoring | Sentry MCP |
| Payments | Stripe MCP |
| Team chat | Slack MCP |
| Diagrams | Excalidraw |

### 3. Recommended Skills

```bash
# Install from TokRepo
npx skills install react-best-practices
npx skills install api-security
npx skills install git-workflow
```

### 4. Git Hooks (via Claude Code Hooks)

```json
{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "command": "npx biome check --write $CLAUDE_FILE_PATH 2>/dev/null || true"
    }]
  }
}
```

### 5. Environment Template

```bash
# .env.example
DATABASE_URL=postgresql://localhost:5432/myapp
GITHUB_TOKEN=ghp_xxx
ANTHROPIC_API_KEY=sk-ant-xxx
```

## Project Templates

### Minimal (any project)
```
CLAUDE.md          # Project conventions
.mcp.json          # MCP servers
.env.example       # Required env vars
```

### Full Stack (Next.js + Postgres)
```
CLAUDE.md
.mcp.json
.env.example
biome.json         # Linter config
drizzle.config.ts  # ORM config
```

### Python API
```
CLAUDE.md
.mcp.json
.env.example
pyproject.toml     # UV/pip config
ruff.toml          # Linter config
```

### Key Stats
- Templates for 3+ project types
- Essential MCP server configs
- Claude Code hooks for auto-formatting
- Environment variable templates
- 2-minute setup

### FAQ

**Q: What is the AI Project Starter Kit?**
A: A pre-configured bundle of CLAUDE.md, MCP servers, skills, and hooks that makes any new project instantly productive with Claude Code.

**Q: Do I need all the MCP servers?**
A: No, start with GitHub and your database. Add others as needed.

**Q: Can I customize the templates?**
A: Yes, the templates are starting points. Modify CLAUDE.md to match your project conventions.

---

## Source & Thanks

> Community-maintained starter kit for Claude Code projects.
>
> Related: [CLAUDE.md Best Practices](https://tokrepo.com), [Claude Code Hooks](https://tokrepo.com), [MCP Building Guide](https://tokrepo.com)

---

<!-- ZH -->

## 快速使用

```bash
mkdir my-project && cd my-project && git init
# 创建 CLAUDE.md（项目规范）
# 创建 .mcp.json（MCP 服务器）
# 创建 .env.example（环境变量）
# 2 分钟内完成 AI 开发环境配置
```

---

## 简介

AI Project Starter Kit 是一个即用配置包，2 分钟为新项目配置好 Claude Code。包含 CLAUDE.md 模板、MCP 服务器配置、推荐 Skill 和项目结构指南。适合用 Claude Code 开始新项目的开发者。

---

## 来源与感谢

> 社区维护的 Claude Code 项目启动套件。

---
Source: https://tokrepo.com/en/workflows/d1a894ea-3455-47dc-be6c-6fcc6e56110d
Author: Skill Factory