MCPInstall

project-planner

Universal project planning for non-technical projects. Domains: business, personal, creative, academic, organizational, events. Capabilities: goal setting, milestone planning, resource allocation, timeline creation, risk assessment, progress tracking. Actions: create, plan, structure, breakdown, track projects. Keywords: project plan, roadmap, strategy, goal setting, milestones, timeline, action plan, project management, business plan, personal goals, creative project, academic planning, event planning, organizational change, OKRs, SMART goals, Gantt chart. Use when: creating project plans, setting goals/milestones, planning business initiatives, organizing events, structuring academic work, developing strategies/roadmaps.

Installs
181
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/samhvw8/dot-claude --skill project-planner
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads project-planner automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Project Planner Skill

Universal planning methodology for creating structured, actionable plans for any project type. Works for business initiatives, personal goals, creative projects, academic work, event planning, and organizational change.

When to Use This Skill

Activate this skill when planning:

  • Business Projects: Product launches, marketing campaigns, process improvements
  • Personal Goals: Career development, learning objectives, lifestyle changes
  • Creative Projects: Writing projects, art installations, content creation
  • Academic Work: Research projects, thesis planning, study programs
  • Event Planning: Conferences, weddings, community events
  • Organizational Change: Restructuring, culture initiatives, policy changes

NOT for software development - Use implementation-planner skill instead

Pre-Planning Protocol

ALWAYS execute before creating new plan:

  1. Check for active plan:

    test -f docs/plan.md && cat docs/plan.md
    
  2. If active plan exists:

    • Ask user: "Active plan found: [PLAN-ID]. Continue this plan or create new one?"
    • If continue: Load active plan and continue from current phase
    • If new: Mark current plan as paused/completed and create new
  3. If no active plan:

    • Proceed with new plan creation

Plan Format Standards

Naming Convention

  • Format: PLAN-YYYYMMDD-HHMM-{project-slug}.md
  • Example: PLAN-20251118-1430-product-launch.md
  • Location: docs/plans/

Required Frontmatter

---
plan_id: PLAN-YYYYMMDD-HHMM-{slug}
title: [Project Name]
created: YYYY-MM-DD HH:MM
status: draft | active | completed | on_hold | cancelled
category: business | personal | creative | academic | event | organizational
phase: planning | execution | monitoring | complete
priority: critical | high | medium | low
---

Required Sections

  1. Vision & Objectives - What and why
  2. Scope & Deliverables - Specific outcomes
  3. Action Steps - Sequenced tasks with owners
  4. Resources Required - People, budget, materials, time
  5. Timeline & Milestones - Deadlines and checkpoints
  6. Risks & Contingencies - What could go wrong
  7. Success Metrics - Measurable outcomes

Master Plan Tracker (docs/plan.md)

Same structure as implementation-planner, tracks all project plans.

Update Workflow

When creating new plan:

  1. Generate plan file in docs/plans/
  2. Update docs/plan.md:
    • Set active_plan to new plan ID
    • Add to appropriate category section
    • Update last_updated timestamp

When completing plan:

  1. Update plan file status: completed
  2. Update docs/plan.md:
    • Move to "Completed" with ✅
    • Update statistics

When pausing plan:

  1. Update plan file status: on_hold
  2. Update docs/plan.md:
    • Move to "On Hold" section
    • Clear active_plan if it was active

Core Planning Principles

  1. Clarity over complexity - Simple, understandable plans
  2. Action-oriented - Every section leads to concrete actions
  3. Flexibility - Plans adapt to changing circumstances
  4. Accountability - Clear ownership and deadlines
  5. Measurable - Success criteria are objective

Planning Methodology

Step 1: Vision & Objectives (< 5 minutes)

Purpose: Define what you want to achieve and why

Questions to answer:

  • What is the desired end state?
  • Why is this project important?
  • Who benefits from this project?
  • What problem does this solve?

Output format:

## Vision & Objectives

### Vision Statement
[One paragraph describing the ideal outcome]

### Primary Objective
[Main goal - SMART format: Specific, Measurable, Achievable, Relevant, Time-bound]

### Secondary Objectives
- Objective 1: [SMART format]
- Objective 2: [SMART format]

### Alignment
- **Strategic Fit**: [How this aligns with broader goals]
- **Stakeholders**: [Who cares about this and why]
- **Value Proposition**: [Why now, why this approach]

Step 2: Scope & Deliverables (< 5 minutes)

Purpose: Define boundaries and specific outputs

Questions to answer:

  • What's included in this project?
  • What's explicitly excluded?
  • What tangible deliverables will we produce?
  • What are the acceptance criteria?

Output format:

## Scope & Deliverables

### In Scope
- [Specific activity/outcome 1]
- [Specific activity/outcome 2]

### Out of Scope
- [What we're NOT doing 1]
- [What we're NOT doing 2]

### Deliverables
1. **Deliverable 1**: [Description]
   - Acceptance Criteria: [How we know it's done]
   - Format: [Document, event, product, etc.]

2. **Deliverable 2**: [Description]
   - Acceptance Criteria: [How we know it's done]
   - Format: [Format]

### Constraints
- **Budget**: [Budget limitation]
- **Time**: [Time constraint]
- **Resources**: [Resource constraints]
- **Quality**: [Non-negotiable quality standards]

Step 3: Action Steps (< 10 minutes)

Purpose: Break down work into executable tasks

Sequencing principles:

  1. Dependencies first - Complete prerequisites before dependent tasks
  2. Quick wins early - Build momentum with achievable tasks
  3. Parallel work - Identify tasks that can happen simultaneously
  4. Critical path - Highlight tasks that determine overall timeline

Output format:

## Action Steps

### Phase 1: [Phase Name] (Weeks 1-2)

#### Step 1.1: [Action Verb] [What]
- **Description**: [What needs to be done]
- **Owner**: [Who is responsible]
- **Duration**: [Estimated time]
- **Dependencies**: [What must be done first]
- **Output**: [What this produces]
- **Verification**: [How to confirm completion]

#### Step 1.2: [Action Verb] [What]
[Same structure]

### Phase 2: [Phase Name] (Weeks 3-4)
[Continue with steps]

### Critical Path
Tasks that determine overall timeline:
1. Step X.X → Step Y.Y → Step Z.Z

Step 4: Resources Required (< 5 minutes)

Purpose: Identify what's needed to execute

Categories:

  • People: Skills, roles, time commitment
  • Budget: Money for materials, services, licenses
  • Materials: Physical items, equipment, supplies
  • Time: Duration, deadlines, availability
  • Knowledge: Training, expertise, information
  • Tools: Software, platforms, systems

Output format:

## Resources Required

### People
- **Role 1**: [Skills needed], [Time commitment], [Availability]
- **Role 2**: [Skills], [Time], [Availability]

### Budget
| Category | Item | Estimated Cost | Status |
|----------|------|----------------|--------|
| Materials | [Item] | $X,XXX | Approved/Pending |
| Services | [Service] | $X,XXX | Approved/Pending |

**Total Budget**: $X,XXX

### Materials & Equipment
- [Item 1]: [Quantity], [Specifications], [Source]
- [Item 2]: [Quantity], [Specifications], [Source]

### Knowledge & Training
- [Skill/Knowledge 1]: [Who needs it], [How to acquire]
- [Skill/Knowledge 2]: [Who needs it], [How to acquire]

### Tools & Systems
- [Tool 1]: [Purpose], [License/Access], [Cost]
- [Tool 2]: [Purpose], [License/Access], [Cost]

Step 5: Timeline & Milestones (< 5 minutes)

Purpose: Set deadlines and create accountability

Milestone criteria:

  • Significant progress point
  • Measurable completion
  • Enables next phase
  • Stakeholder visibility

Output format:

## Timeline & Milestones

### Overall Timeline
**Start Date**: YYYY-MM-DD
**End Date**: YYYY-MM-DD
**Total Duration**: [X weeks/months]

### Milestones

#### Milestone 1: [Name] - [Date]
- **Criteria**: [What must be complete]
- **Deliverables**: [What to show]
- **Checkpoint**: [Review meeting/decision point]

#### Milestone 2: [Name] - [Date]
[Same structure]

### Gantt Chart (Text-based)

Week 1 : [█████████░░░] Phase 1 (Step 1.1-1.3) Week 2 : [░░░░█████████] Phase 1 (Step 1.4-1.6) Week 3 : [█████████░░░] Phase 2 (Step 2.1-2.3) Week 4 : [░░░░█████████] Phase 2 Complete


### Key Dates
- [YYYY-MM-DD]: [Event/Deadline]
- [YYYY-MM-DD]: [Event/Deadline]

Step 6: Risks & Contingencies (< 5 minutes)

Purpose: Anticipate problems and plan responses

Risk categories:

  • External: Market changes, regulations, competition
  • Resource: Budget cuts, people unavailable, materials
  • Technical: Complexity, dependencies, unknowns
  • Stakeholder: Resistance, competing priorities, misalignment
  • Timeline: Delays, scope creep, optimism bias

Output format:

## Risks & Contingencies

### Risk 1: [Description]
**Category**: [External/Resource/Technical/Stakeholder/Timeline]
**Probability**: [High/Medium/Low]
**Impact**: [High/Medium/Low]
**Risk Score**: [Probability × Impact = Score]

**Mitigation**: [How to prevent]
**Contingency**: [What to do if it happens]
**Early Warning Signs**: [Indicators this is occurring]
**Owner**: [Who monitors this]

### Risk 2: [Description]
[Same structure]

### Risk Matrix

Impact High │ R3 │ R1 │ R1 │ Medium │ R5 │ R2 │ R1 │ Low │ R7 │ R5 │ R2 │ └────┴────┴────┘ L M H Probability

Step 7: Success Metrics (< 3 minutes)

Purpose: Define measurable outcomes

SMART criteria:

  • Specific: Exact metric
  • Measurable: Quantifiable
  • Achievable: Realistic
  • Relevant: Aligned with objectives
  • Time-bound: By when

Output format:

## Success Metrics

### Primary Metrics
- **Metric 1**: [Name]
  - **Target**: [Specific number/outcome]
  - **Measurement**: [How to measure]
  - **Frequency**: [How often to check]
  - **Baseline**: [Current state]

- **Metric 2**: [Name]
  [Same structure]

### Secondary Metrics
- [Metric 3]: [Target]
- [Metric 4]: [Target]

### Completion Criteria
- [ ] All deliverables accepted by stakeholders
- [ ] Primary metrics meet/exceed targets
- [ ] Budget within ±10% of estimate
- [ ] Timeline within ±10% of estimate
- [ ] Stakeholder satisfaction ≥ 8/10
- [ ] No critical issues remaining

### Post-Project Review
- **Review Date**: [2-4 weeks after completion]
- **Participants**: [Who attends]
- **Topics**: Lessons learned, metrics achieved, improvements

Complete Plan Template

---
plan_id: PLAN-YYYYMMDD-HHMM-{slug}
title: [Project Name]
created: YYYY-MM-DD HH:MM
status: draft
category: [business|personal|creative|academic|event|organizational]
phase: planning
priority: [critical|high|medium|low]
---

# 🎯 Project Plan: [Project Name]

## Vision & Objectives
[Vision statement and SMART objectives]

## Scope & Deliverables
[What's included, excluded, and delivered]

## Action Steps
[Phased, sequenced tasks with owners]

## Resources Required
[People, budget, materials, time, knowledge, tools]

## Timeline & Milestones
[Dates, milestones, Gantt chart]

## Risks & Contingencies
[Identified risks with mitigation strategies]

## Success Metrics
[Measurable outcomes and completion criteria]

## Notes & Considerations
[Additional context, assumptions, dependencies]

Quality Standards

Completeness

  • All 7 sections present and filled
  • Each action step has owner and deadline
  • Resources are realistic and available
  • Risks have mitigation plans
  • Success metrics are SMART

Clarity

  • Anyone can understand the plan
  • No jargon without explanation
  • Concrete examples provided
  • Ambiguity eliminated

Actionability

  • Next steps are clear
  • Owners know what to do
  • Timeline is realistic
  • Resources are secured

Common Project Types

Business Project Example Triggers

  • Product launch, marketing campaign, sales initiative
  • Process improvement, efficiency project
  • Market expansion, partnership development

Personal Project Example Triggers

  • Career transition, skill development
  • Health/fitness goal, lifestyle change
  • Financial goal, savings plan

Creative Project Example Triggers

  • Book/article writing, content creation
  • Art project, exhibition planning
  • Music production, album release

Academic Project Example Triggers

  • Research project, thesis planning
  • Study program, exam preparation
  • Conference presentation, paper publication

Event Planning Example Triggers

  • Conference/workshop organization
  • Wedding/celebration planning
  • Community event, fundraiser

Organizational Change Example Triggers

  • Team restructuring, role changes
  • Culture initiative, value implementation
  • Policy change, process adoption

Continue Planning Workflow

When user says "continue plan":

  1. Load active plan from docs/plan.md
  2. Check phase:
    • Planning: Add details, refine sections
    • Execution: Update progress, mark steps complete
    • Monitoring: Review metrics, adjust timeline
  3. Update status as work progresses

Format Validation

Before finalizing:

  • Frontmatter complete (plan_id, title, status, category, phase, priority)
  • All 7 sections present
  • Vision is inspiring and clear
  • Objectives are SMART
  • Action steps have owners and deadlines
  • Resources identified and available
  • Timeline is realistic
  • Risks have contingencies
  • Success metrics are measurable
  • Master tracker updated

Example Usage

Scenario: Product Launch Plan

User: "Create a plan for launching our new mobile app"

Claude:

  1. Checks docs/plan.md - no active plan
  2. Asks clarifying questions:
    • Who is the target audience?
    • What's the launch date goal?
    • What's the budget?
  3. Creates PLAN-20251118-1430-mobile-app-launch.md:
    • Vision: Achieve 10K downloads in first month
    • Objectives: SMART goals for downloads, revenue, engagement
    • Scope: Features in v1.0, marketing channels, launch events
    • Action Steps: Development, testing, marketing, launch
    • Resources: Team roles, budget, tools
    • Timeline: 12-week timeline with milestones
    • Risks: Technical delays, market reception, competition
    • Metrics: Downloads, DAU, revenue, ratings
  4. Updates docs/plan.md with active plan

Scenario: Personal Learning Goal

User: "Help me plan learning Python for data science"

Claude:

  1. Checks for active plan
  2. Creates structured learning plan:
    • Vision: Become job-ready data scientist in 6 months
    • Objectives: Complete courses, build portfolio projects
    • Scope: Topics to cover, projects to build
    • Action Steps: Weekly study schedule, hands-on practice
    • Resources: Courses, books, datasets, tools
    • Timeline: Month-by-month progression
    • Risks: Time management, motivation, difficulty
    • Metrics: Courses completed, projects finished, job applications

Integration with Implementation Planner

When planning involves software development:

  1. Use this skill for overall project planning:

    • Business objectives
    • Stakeholder management
    • Resource allocation
    • Timeline
  2. Use implementation-planner for technical implementation:

    • Code architecture
    • File changes
    • Testing strategy
    • Deployment
  3. Cross-reference plans:

    • Implementation plan referenced in technical deliverables
    • Project plan tracks implementation as one action step

This skill creates actionable, complete plans for any project type while maintaining consistent format and tracking.

FAQ

What does the project-planner skill do?

Universal project planning for non-technical projects. Domains: business, personal, creative, academic, organizational, events. Capabilities: goal setting, milestone planning, resource allocation, timeline creation, risk assessment, progress tracking. Actions: create, plan, structure, breakdown, track projects. Keywords: project plan, roadmap, strategy, goal setting, milestones, timeline, action plan, project management, business plan, personal goals, creative project, academic planning, event planning, organizational change, OKRs, SMART goals, Gantt chart. Use when: creating project plans, setting goals/milestones, planning business initiatives, organizing events, structuring academic work, developing strategies/roadmaps.

How do I install project-planner?

Run npx skills add https://github.com/samhvw8/dot-claude --skill project-planner in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/project-planner/ (personal) or .claude/skills/project-planner/ (project).

Which AI agents can use project-planner?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is project-planner safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains project-planner?

It is published by samhvw8 in samhvw8/dot-claude. It has 181 recorded installs.

More from samhvw8/dot-claude

View all →

ui-design-system

samhvw8/dot-claude

React UI component systems with TailwindCSS + Radix + shadcn/ui. Stack: TailwindCSS (styling), Radix UI (primitives), shadcn/ui (components), React/Next.js. Capabilities: design system architecture, accessible components, responsive layouts, theming, dark mode, component composition. Actions: review, design, build, improve, refactor UI components. Keywords: TailwindCSS, Radix UI, shadcn/ui, design system, component library, accessibility, ARIA, responsive, dark mode, theming, CSS variables, component architecture, atomic design, design tokens, variant, slot, composition. Use when: building component libraries, implementing shadcn/ui, creating accessible UIs, setting up design systems, adding dark mode/theming, reviewing UI component architecture.

Frontend & Design3.2K installs

ui-ux-design

samhvw8/dot-claude

UI/UX design reference database. 50+ styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.

Frontend & Design206 installs

claude-md-architect

samhvw8/dot-claude

CLAUDE.md file generation and optimization for Claude Code projects. Capabilities: initialize project instructions, analyze codebase context, optimize existing CLAUDE.md, apply Anthropic best practices, reduce token usage, improve effectiveness. Actions: init, create, optimize, enhance CLAUDE.md files. Keywords: CLAUDE.md, project instructions, Claude Code setup, project context, codebase analysis, Anthropic best practices, token optimization, project configuration, AI instructions, coding guidelines, project rules, workspace setup. Use when: initializing CLAUDE.md for new projects, optimizing existing project instructions, setting up Claude Code for a codebase, improving AI coding guidelines.

nextjs-turborepo

samhvw8/dot-claude

Full-stack web development with Next.js and Turborepo. Stack: Next.js 14+ (App Router, RSC, Server Actions, PPR, SSR, SSG, ISR), Turborepo (monorepo, pipelines, remote caching), RemixIcon (3100+ icons). Capabilities: server components, API routes, middleware, caching strategies, build optimization, monorepo management. Actions: create, build, deploy, optimize Next.js apps, setup monorepo, configure caching. Keywords: Next.js, App Router, Server Components, RSC, Server Actions, SSR, SSG, ISR, PPR, Turborepo, monorepo, remote cache, build pipeline, parallel execution, workspace, pnpm, icons. Use when: building Next.js apps, implementing SSR/SSG, setting up monorepos, optimizing build performance, configuring caching strategies, managing shared dependencies.

Frontend & Design136 installs

aesthetic

samhvw8/dot-claude

Visual design intelligence and UI aesthetics. Integrates: chrome-devtools, ai-multimodal, media-processing. Capabilities: design analysis, visual hierarchy, color theory, typography, micro-interactions, animation, design systems, accessibility. Actions: analyze, design, create, capture, evaluate, implement UI aesthetics. Keywords: Dribbble, Behance, Mobbin, design inspiration, visual hierarchy, color palette, typography, spacing, animation, micro-interaction, design system, style guide, accessibility, WCAG, contrast ratio, golden ratio, whitespace, visual rhythm. Use when: building beautiful UIs, analyzing design inspiration, implementing visual hierarchy, adding animations/micro-interactions, creating design systems, evaluating aesthetic quality, capturing design screenshots.

Frontend & Design119 installs

mobile-development

samhvw8/dot-claude

Cross-platform and native mobile development. Frameworks: React Native, Flutter, Swift/SwiftUI, Kotlin/Jetpack Compose. Capabilities: mobile UI, offline-first architecture, push notifications, deep linking, biometrics, app store deployment. Actions: build, create, implement, optimize, test, deploy mobile apps. Keywords: iOS, Android, React Native, Flutter, Swift, Kotlin, mobile app, offline sync, push notification, deep link, biometric auth, App Store, Play Store, iOS HIG, Material Design, battery optimization, memory management, mobile performance. Use when: building mobile apps, implementing mobile-first UX, choosing native vs cross-platform, optimizing battery/memory/network, deploying to app stores, handling mobile-specific features.

Mobile110 installs

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.