work_plan

Manage tasks in WORK_PLAN.md with detailed content and status tracking.

Updated Oct 18, 2025
One-click install
npx skills add https://github.com/Kiikurage/Claude-Code-Sample --skill work-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: work_plan
Source: https://github.com/Kiikurage/Claude-Code-Sample/tree/main/.claude/skills/work_plan
Command: npx skills add https://github.com/Kiikurage/Claude-Code-Sample --skill work-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Streamlines task management by providing a structured way to define, track, and complete work items, ensuring clarity and progress in development workflows. It helps break down complex tasks into manageable, verifiable steps, so you never lose sight of your goals.

Core Features & Use Cases

  • Task Definition: Add new work items with titles and detailed bodies, following a specific markdown checklist format.
  • Progress Tracking: Get the next pending task, mark tasks as complete, and view a list of all tasks with their completion status.
  • Workflow Enforcement: Encourages detailed task breakdown, including integrated testing and verification steps, as per the PLAN.md guidelines.
  • Use Case: Plan out a new feature implementation, breaking it into sub-tasks like "Create UI component," "Implement API endpoint," and "Add unit tests," then execute and mark them complete sequentially, ensuring a smooth development cycle.

Quick Start

Add a new task with detailed steps

python3 .claude/skills/work_plan/work_plan.py add "Implement User Profile" "- Create UserProfile component - Display user info - Add edit form

  • Create /api/v1/users/:id endpoint
  • Add UserProfile unit tests
  • Verify all tests pass"

Get the next task to work on

python3 .claude/skills/work_plan/work_plan.py next

Mark a task as complete (e.g., task with ID 1)

python3 .claude/skills/work_plan/work_plan.py complete 1

Frequently Asked Questions about work_plan

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

FAQPage Schema
How do I organize and track tasks in a markdown-based workflow?

Task tracking in markdown lets you define work items with detailed steps, inline tests, and completion status in a structured file. This Skill manages tasks by adding items to WORK_PLAN.md, retrieving pending tasks, marking them complete, and listing all items with their status to keep projects organized.

Can I break down complex features into smaller verified steps?

Yes. Define tasks with titles and detailed bodies that include sub-steps, testing requirements, and validation checks. Each task enforces breakdown into manageable, verifiable pieces—like UI components, API endpoints, and unit tests—so every step is testable and traceable.

What's the best way to manage project progress without external tools?

Use a markdown checklist format to define, track, and complete work items locally. This approach keeps your plan version-controlled alongside code, requires no external dependencies, and enforces clear task boundaries with integrated verification steps.

How do I mark tasks complete and see what's next to work on?

Retrieve the next pending task to start work, then mark it complete by ID when finished. The Skill tracks completion status for all tasks and surfaces the next item automatically, creating a streamlined execution flow through your project plan.

Does this work with developer workflows that require inline testing?

Yes. The task format enforces integrated testing and validation within each step, following PLAN.md guidelines. This ensures every completed task includes verification, keeping quality checks built into the workflow rather than deferred.