Planning templates that help AI write production-ready code on the first attempt.

Installation • Usage • How It Works • Templates • Roadmap

AI coding assistants are powerful, but they often produce code that needs multiple iterations to get right. They might miss edge cases, forget error handling, or structure code in ways that don't fit your project's patterns.

Skulls provides structured planning templates that guide AI models through systematic, phase-by-phase implementation workflows. Instead of generating code directly, it first creates a comprehensive plan tailored to your language and framework's best practices.

The result? Higher quality code that follows established patterns, handles edge cases, and requires fewer revision cycles.

• Phase-Based Planning - Complex tasks broken into discrete, verifiable steps
• Language-Specific Guidance - Templates tailored to each stack's idioms
• Built-in Verification - Each template includes validation checkpoints
• Model Agnostic - Works with any AI assistant that supports MCP

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "skulls": {
      "command": "npx",
      "args": ["-y", "skulls"]
    }
  }
}

claude mcp add skulls -- npx -y skulls

Or add to your project's .mcp.json:

{
  "skulls": {
    "command": "npx",
    "args": ["-y", "skulls"]
  }
}

Add this to your project's CLAUDE.md or root instruction file:

## Planning

You MUST use the Skulls MCP for all planning tasks. No exceptions.

When you ask the AI to implement something, it will:

1. Initialize a planning session
2. Select the appropriate language and template
3. Create a structured plan with phase-by-phase guidance
4. Execute each phase with built-in verification

Skulls exposes an MCP server with tools organized into three phases:

• Rust (Axum backend)
• TypeScript (Node.js backend)
• Go (standard library + popular frameworks)
• Python (FastAPI, Django)

• API endpoint planning
• Service/module creation
• Database migrations
• Authentication flows
• Testing strategies
• Refactoring guides

• Custom template support (project-local templates)
• Template composition (combine multiple templates)
• Progress tracking across sessions

Want to add templates for your favorite language or framework? See CONTRIBUTING.md.

Building locally? Check out DEVELOPMENT.md.

MIT