This is for breaking down work into short, verifiable tasks without drowning in template bloat. The core idea is solid: keep plans under a page, make each task take 2-5 minutes, and always know how to verify you're done. It pushes you to be specific (not "add authentication" but "install next-auth, create the API route") and only include scripts that matter for your project type. Plans go in the project root with dynamic names, not hidden in docs folders. It's opinionated about staying minimal, which is refreshing when most planning frameworks encourage overthinking. Best for feature work, refactors, or complex bugs where you need structure without ceremony.

skills.sh installs
358
GitHub stars
33.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add davila7/claude-code-templates --skill plan-writing --agent claude-code

Installs into .claude/skills of the current project.

Files

Plan Writing

Source: obra/superpowers

Overview

This skill provides a framework for breaking down work into clear, actionable tasks with verification criteria.

Task Breakdown Principles

1. Small, Focused Tasks

  • Each task should take 2-5 minutes
  • One clear outcome per task
  • Independently verifiable

2. Clear Verification

  • How do you know it's done?
  • What can you check/test?
  • What's the expected output?

3. Logical Ordering

  • Dependencies identified
  • Parallel work where possible
  • Critical path highlighted
  • Phase X: Verification is always LAST

4. Dynamic Naming in Project Root

  • Plan files are saved as {task-slug}.md in the PROJECT ROOT
  • Name derived from task (e.g., "add auth" → auth-feature.md)
  • NEVER inside .claude/, docs/, or temp folders

Planning Principles (NOT Templates!)

🔴 NO fixed templates. Each plan is UNIQUE to the task.

Principle 1: Keep It SHORT

❌ Wrong✅ Right
50 tasks with sub-sub-tasks5-10 clear tasks max
Every micro-step listedOnly actionable items
Verbose descriptionsOne-line per task

Sponsors

Details

Repository
github.com/davila7/claude-code-templates
Categories
Documentation, Code Review & Quality, Productivity & Planning
First seen
Jun 3, 2026

More from davila7/claude-code-templates

All 618
1pr-pm avatarhuman-writingpr-pm/prpmWrite content that sounds natural, conversational, and authentically human - avoiding AI-generated patterns, corporate speak, and generic phrasing316skills.sh installs
2davila7 avatarenvironment-setup-guidedavila7/claude-code-templatesGuide developers through setting up development environments with proper tools, dependencies, and configurations311skills.sh installs
3incept5 avatareve-read-eve-docsincept5/eve-skillpacksLoad first. State-today index of distilled Eve Horizon system docs with task-based routing for CLI/API usage, manifests, pipelines, jobs, secrets, agents, build305skills.sh installs
4rightcapitalhq avatarchinese-style-guiderightcapitalhq/chinese-style-guidechinese style guide293skills.sh installs
5yoanbernabeu avatarslidev-syntax-guideyoanbernabeu/slidev-skillsMaster Slidev's extended Markdown syntax. Use this skill to write slides with advanced formatting, frontmatter, and special features.292skills.sh installs
6crazynomad avatardoc-mindmapcrazynomad/skills文档智能整理助手 - 批量转换办公文档为 Markdown,本地模型生成摘要,三维度软链接分类288skills.sh installs