How do I install the Project Spec skill?

Run npx skillmds@latest add majiayu000/project-spec in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Project Spec skill do?

Generate CLAUDE.md project files. Execution contracts that eliminate ambiguity. It is listed under Coding & Dev Tools on SkillMD.

Is Project Spec safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Project Spec?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Project Spec free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Project Spec?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Project Spec by majiayu000 — Agent Skill

Name: Project Spec
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

Project Spec Skill

Core Principle: A good CLAUDE.md means Claude never has to guess.

Template Selection

Project	Use
Quick build (<8h)	template-minimal.md
Complex / Calculator / Multi-page	template-full.md

Defaults (Don't specify if these apply)

Code maturity: Production
Maintainer: Solo dev
Lifetime: Multi-year
Tech debt: Minimal, documented
Failure impact: Business-impacting
Code ownership: Shared
Review strictness: Standard
Error handling: Fail fast
Logging: Basic (errors)
Data sensitivity: Personal
UI tolerance: Visually close
Refactor permission: None
Dependency policy: Well-known only
Human review: Detailed
Output timing: Correctness first (not fast draft)
Partial completion: Not acceptable
Session: Expect interruptions, be resumable

Only specify deviations from defaults.

Required Sections (Every CLAUDE.md)

[CRITICAL] Critical Rules (stop-on-missing, non-goals)
[CRITICAL] Project Overview (type, goal, timeline)
[CRITICAL] Scope (in/out/future)
[CRITICAL] Constraints
[CRITICAL] Definition of Done

Critical Rules Block (Copy to every CLAUDE.md)

## ⚠️ Critical Rules

**If info missing:** STOP → List missing → Ask → Do NOT assume

**Claude must NOT:**
- Add features outside this document
- Add dependencies without approval
- Refactor unrelated code
- Make "improvements" outside scope

**Authority:** CLAUDE.md > skills > comments > chat > assumptions (FORBIDDEN)

Anti-Patterns

❌ Bad	✅ Good
"Make it look professional"	"#1a1a1a text, Inter 700, 48px H1"
"Standard contact form"	"Fields: Name, Email, Phone, Message*"
"Similar to competitor"	"Hero: 60/40 split, CTA left"
"Client will provide"	"Copy pending by [date]"
"Modern design"	"Tailwind, rounded-lg, shadow-sm"

Tier Markers

Marker	Meaning
`[CRITICAL]`	Read before coding
`[REFERENCE]`	Read when needed
`[NO-IMPL]`	Doesn't affect code

References

template-minimal.md — Quick builds
template-full.md — Complex projects
examples.md — Real examples

---name: project-specdescription: Generate CLAUDE.md project files. Execution contracts that eliminate ambiguity.--- # Project Spec Skill **Core Principle:** A good CLAUDE.md means Claude never has to guess. ## Template Selection | Project | Use | |---------|-----| | Quick build (<8h) | template-minimal.md | | Complex / Calculator / Multi-page | template-full.md | ## Defaults (Don't specify if these apply) ``` Code maturity: Production Maintainer: Solo dev Lifetime: Multi-year Tech debt: Minimal, documented Failure impact: Business-impacting Code ownership: Shared Review strictness: Standard Error handling: Fail fast Logging: Basic (errors) Data sensitivity: Personal UI tolerance: Visually close Refactor permission: None Dependency policy: Well-known only Human review: Detailed Output timing: Correctness first (not fast draft) Partial completion: Not acceptable Session: Expect interruptions, be resumable ``` Only specify **deviations** from defaults. ## Required Sections (Every CLAUDE.md) ``` [CRITICAL] Critical Rules (stop-on-missing, non-goals) [CRITICAL] Project Overview (type, goal, timeline) [CRITICAL] Scope (in/out/future) [CRITICAL] Constraints [CRITICAL] Definition of Done ``` ## Critical Rules Block (Copy to every CLAUDE.md) ```markdown ## ⚠️ Critical Rules **If info missing:** STOP → List missing → Ask → Do NOT assume **Claude must NOT:** - Add features outside this document - Add dependencies without approval - Refactor unrelated code - Make "improvements" outside scope **Authority:** CLAUDE.md > skills > comments > chat > assumptions (FORBIDDEN) ``` ## Anti-Patterns | ❌ Bad | ✅ Good | |--------|---------| | "Make it look professional" | "#1a1a1a text, Inter 700, 48px H1" | | "Standard contact form" | "Fields: Name*, Email*, Phone, Message*" | | "Similar to competitor" | "Hero: 60/40 split, CTA left" | | "Client will provide" | "Copy pending by [date]" | | "Modern design" | "Tailwind, rounded-lg, shadow-sm" | ## Tier Markers | Marker | Meaning | |--------|---------| | `[CRITICAL]` | Read before coding | | `[REFERENCE]` | Read when needed | | `[NO-IMPL]` | Doesn't affect code | ## References - [template-minimal.md](references/template-minimal.md) — Quick builds - [template-full.md](references/template-full.md) — Complex projects - [examples.md](references/examples.md) — Real examples

Frequently asked questions

Project Spec