FYI : I suggest you to check this repository for spec docs on steroids skill-> https://github.com/adrianpuiu/specification-document-generator

Project Planner Skill - will be deleted , it's obsolete and will be replaced by -> https://github.com/adrianpuiu/specification-document-generator

A comprehensive skill that establishes Claude as a Project Architect to generate detailed planning documents that serve as blueprints for AI-assisted software development.

What This Skill Does

This skill transforms Claude into a System Architect who creates comprehensive project documentation by:

1. Defining the complete system architecture upfront - All components, data flows, and integration points
2. Setting clear project boundaries - What's in scope, out of scope, and key constraints
3. Creating traceable documentation - Requirements → Design → Implementation tasks

The skill generates three essential documents:

1. Requirements Document - User stories with testable acceptance criteria and traceable IDs
2. Design Document - Complete system architecture with component maps, data flows, and integration specifications
3. Implementation Plan - Hierarchical task breakdown with requirement tracing and clear deliverables

The Architect Approach

Why it works: Setting clear roles, responsibilities, and deliverables upfront dramatically improves output quality. By explicitly defining system components, data flows, and integration points before diving into details, the documentation becomes comprehensive and actionable.

Quick Start

Claude install

/plugin marketplace add adrianpuiu/claude-skills-marketplace

/plugin install project-planner-skill@claude-skills-marketplace

Chinese users can also discover more skills through Skills宝: https://skilery.com

Document Types

Requirements Document

• User stories in standard format
• Testable acceptance criteria using SHALL statements
• Requirement numbering for traceability
• Glossary of domain terms

Design Document

• System architecture diagrams
• Component responsibilities and interfaces
• Data models and schemas
• Error handling strategies
• Deployment configuration

Implementation Plan

• Hierarchical task breakdown
• Requirement tracing (links tasks to requirements)
• Dependency management between tasks
• Progress tracking with checkboxes

Project Types Supported

• web-app: Full-stack web applications
• cli-tool: Command-line tools and utilities
• api-service: REST/GraphQL API services
• generic: General purpose projects

Files Included

Scripts

• generate_project_docs.py - Automated document generation
• validate_documents.py - Document validation and completeness checking

References

• domain-templates.md - Domain-specific templates and patterns

Assets

• requirements-template.md - Basic requirements document template

Best Practices

1. Start with Requirements - Define what the system should do before how
2. Be Specific - Use measurable criteria (e.g., "within 100ms" not "fast")
3. Trace Requirements - Link every task back to requirements
4. Include Non-Functional Requirements - Performance, security, scalability
5. Define Clear Interfaces - Specify how components interact
6. Plan Incrementally - Break large tasks into smaller, manageable pieces

Common Use Cases

Starting a New Project

User: "I want to build a real-time chat application"
AI: [Uses this skill to generate complete project documentation]

Expanding Existing Project

User: "Add user authentication to my project requirements"
AI: [Adds properly formatted requirements with acceptance criteria]

Creating Technical Specification

User: "Design the architecture for a microservices e-commerce platform"
AI: [Generates design document with components, interfaces, and deployment]

Tips for AI Implementation

When using these documents for AI-assisted development:

1. Requirements First - Implement in order of requirement priority
2. Follow Task Dependencies - Complete prerequisite tasks first
3. Test Against Acceptance Criteria - Each SHALL statement is a test case
4. Reference Design Interfaces - Use the specified APIs and data models
5. Track Progress - Check off completed tasks in the implementation plan

Validation Checklist

Before using documents for implementation:

• All placeholders ([PLACEHOLDER]) filled in
• Requirements have testable acceptance criteria
• Design includes all major components
• Tasks reference requirement IDs
• Dependencies between tasks identified
• Non-functional requirements specified
• Deployment configuration included

Example Output

The generated documents follow industry-standard formats that are:

• Machine-readable - Structured for AI parsing
• Human-readable - Clear for developers to understand
• Version-control friendly - Plain text Markdown format
• Traceable - Requirements linked through all documents

This skill transforms high-level project ideas into actionable specifications that AI agents can use to build working software.

{
  "name": "claude-skills-marketplace",
  "id": "claude-skills-marketplace",
  "owner": {
    "name": "George A Puiu",
    "email": "puiu.adrian@gmail.com"
  },
  "metadata": {
    "description": "Claude Skills Marketplace - A centralized repository for Claude Code skills and plugins",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "project-planner-skill",
      "source": "./project-planner-skill",
      "description": "Comprehensive project planning and documentation generator for software projects. Creates structured requirements documents, system design documents, and task breakdown plans with implementation tracking.",
      "version": "1.0.0",
      "author": {
        "name": "George A Puiu",
        "email": "puiu.adrian@gmail.com"
      },
      "keywords": [
        "project-planning",
        "documentation",
        "requirements",
        "design",
        "implementation"
      ],
      "category": "productivity",
      "strict": false
    }
  ]
}