project-spec

Generate CLAUDE.md project files with structured scope, constraints, and Done criteria.

4|1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/Soborbo/claudeskills --skill project-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-spec
Source: https://github.com/Soborbo/claudeskills/tree/main/project-spec-v4
Command: npx skills add https://github.com/Soborbo/claudeskills --skill project-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates CLAUDE.md project files to remove ambiguity in project briefs by codifying goals, scope, constraints, and acceptance criteria.

Core Features & Use Cases

  • Template-driven CLAUDE.md skeletons (template-minimal.md, template-full.md) for quick or complex projects.
  • Mandatory frontmatter & sections: enforces a standardized structure with at least name and description, plus Critical Rules, Project Overview, Scope, Constraints, and Definition of Done.
  • Guided Quick Start: provides a ready-to-use setup guide for initiating CLAUDE.md creation in new or existing projects.

Quick Start

Create a CLAUDE.md skeleton for your project by selecting a template and populating the required fields in the frontmatter and sections.

Frequently Asked Questions about project-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a CLAUDE.md file to define project scope and constraints?

To generate a CLAUDE.md file, select a minimal or full template and populate the required frontmatter and sections, including Project Overview, Scope, Constraints, and Definition of Done, to eliminate ambiguity in your project brief.

What is a definition of done in a CLAUDE.md project contract?

A definition of done in a CLAUDE.md project contract is a mandatory section that codifies acceptance criteria. It establishes strict boundaries to ensure both quick-build and complex multi-page projects meet structured scope requirements.

Can I use a CLAUDE.md template for complex multi-page projects across any domain?

Yes, you can use the full CLAUDE.md template for complex multi-page projects across any domain. It enforces standardized structures with mandatory Critical Rules and optional references folders to organize supplementary details.

What's the best way to structure project briefs to remove ambiguity?

The best way to structure project briefs is codifying goals, scope, constraints, and acceptance criteria using a CLAUDE.md skeleton. This enforces a standardized structure with mandatory frontmatter containing name and description fields.

Do I need any dependencies to create CLAUDE.md project files?

No dependencies are required to create CLAUDE.md project files. You can immediately initiate CLAUDE.md creation in new or existing projects by selecting a template and populating the required fields using the guided quick start setup.

When should I not use a full CLAUDE.md template for my project?

You should not use a full CLAUDE.md template for quick-build projects requiring rapid setup. Instead, use the template-minimal.md skeleton to enforce only the mandatory frontmatter and critical sections without supplementary details overhead.