
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- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads project-planner automatically when relevant.
- 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:
-
Check for active plan:
test -f docs/plan.md && cat docs/plan.md -
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
-
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
- Vision & Objectives - What and why
- Scope & Deliverables - Specific outcomes
- Action Steps - Sequenced tasks with owners
- Resources Required - People, budget, materials, time
- Timeline & Milestones - Deadlines and checkpoints
- Risks & Contingencies - What could go wrong
- 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:
- Generate plan file in
docs/plans/ - Update
docs/plan.md:- Set
active_planto new plan ID - Add to appropriate category section
- Update
last_updatedtimestamp
- Set
When completing plan:
- Update plan file
status: completed - Update
docs/plan.md:- Move to "Completed" with ✅
- Update statistics
When pausing plan:
- Update plan file
status: on_hold - Update
docs/plan.md:- Move to "On Hold" section
- Clear
active_planif it was active
Core Planning Principles
- Clarity over complexity - Simple, understandable plans
- Action-oriented - Every section leads to concrete actions
- Flexibility - Plans adapt to changing circumstances
- Accountability - Clear ownership and deadlines
- 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:
- Dependencies first - Complete prerequisites before dependent tasks
- Quick wins early - Build momentum with achievable tasks
- Parallel work - Identify tasks that can happen simultaneously
- 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":
- Load active plan from
docs/plan.md - Check phase:
- Planning: Add details, refine sections
- Execution: Update progress, mark steps complete
- Monitoring: Review metrics, adjust timeline
- 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:
- Checks
docs/plan.md- no active plan - Asks clarifying questions:
- Who is the target audience?
- What's the launch date goal?
- What's the budget?
- 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
- Updates
docs/plan.mdwith active plan
Scenario: Personal Learning Goal
User: "Help me plan learning Python for data science"
Claude:
- Checks for active plan
- 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:
-
Use this skill for overall project planning:
- Business objectives
- Stakeholder management
- Resource allocation
- Timeline
-
Use
implementation-plannerfor technical implementation:- Code architecture
- File changes
- Testing strategy
- Deployment
-
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
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.
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.
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.
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.
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.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
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.