Agent skill
quick-plan
This skill should be used when the user asks to "create a quick plan", "draft a plan", "capture this idea", "plan this feature", or wants a lightweight plan without full feature planning. Creates concise plans in backlog/plans/ for later expansion.
Install this agent skill to your Project
npx add-skill https://github.com/ianphil/my-skills/tree/main/quick-plan
SKILL.md
Quick Plan
Create a lightweight plan document for: $ARGUMENTS
Overview
This skill creates concise plan documents in backlog/plans/ using the standard template. Suitable for:
- Capturing ideas quickly before context is lost
- Scoping small-to-medium features
- Creating starting points for later
/plannerexpansion
For complex features requiring full analysis, spec, research, and TDD task breakdown, use /planner instead.
Workflow
Step 1: Generate Filename
Create filename using today's date and a slug derived from the input:
- Format:
YYYYMMDD-short-description.md - Example:
20260127-add-user-authentication.md
Step 2: Gather Context (Optional)
When input references existing code or systems:
- Briefly scan relevant files to understand current state
- Note obvious constraints or dependencies
Limit context gathering to under 2 minutes. Extensive research indicates /planner may be more appropriate.
Step 3: Create Plan
Create the plan file at backlog/plans/{filename}:
---
title: "{Descriptive title}"
status: open
priority: {low|medium|high|critical}
created: {YYYY-MM-DD}
---
# {Plan Title}
## Summary
{1-2 sentences describing what this plan achieves}
## Motivation
{Why is this needed? What problem does it solve? 2-3 sentences.}
## Proposal
### Goals
- {Primary goal}
- {Secondary goal if applicable}
### Non-Goals
- {What this explicitly does NOT cover}
## Design
{High-level approach in 3-5 sentences or bullet points. Include key technical decisions if obvious.}
## Tasks
- [ ] {Task 1}
- [ ] {Task 2}
- [ ] {Task 3}
## Open Questions
- {Any uncertainties requiring resolution}
Step 4: Output Summary
After creating the plan:
Created: backlog/plans/{filename}
{title}
Priority: {priority}
Tasks: {count}
Next steps:
- Review and refine the plan
- Adjust priority if needed
- Expand with /planner if complexity warrants
- Or start implementation directly for simple plans
Guidelines
| Guideline | Detail |
|---|---|
| Concise | Quick capture, not exhaustive planning |
| Priority inference | Blocking issues = high, nice-to-have = low |
| Task count | 3-7 tasks; more than 7 suggests /planner |
| Optional sections | Omit "Open Questions" if none exist |
| Time limit | Context gathering under 2 minutes |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
commit
This skill should be used when the user asks to "commit changes", "push my code", "commit and push", "save my work", or wants to stage all changes and push to remote.
prime-feat
This skill should be used when the user asks to "load feature context", "resume feature work", "prime feature N", "continue feature N", or wants to load all planning artifacts for a specific feature number.
implement-agents
This skill should be used when the user asks to "implement in parallel", "run phases concurrently", "parallel implement", "implement-agents phase X phase Y", or wants to orchestrate multiple agents running /implement simultaneously.
code-walkthrough
Generate structured, hallucination-proof code walkthroughs using Showboat. Use when the user asks to "walk me through this code", "explain this codebase", "create a walkthrough", "document how this works", "give me a tour of this repo", or wants a readable narrative document that explains code with real verified snippets. Also triggers on "showboat", "linear walkthrough", or "code documentation". Not for quick code questions — this produces a full markdown document.
ainotes
This skill should be used when the user asks to "consolidate notes", "summarize ainotes", "clean up notes", "ainotes", or wants to consolidate accumulated agent observations into a compact summary.
implement
This skill should be used when the user asks to "implement phase N", "implement task T001", "do TDD for phase", "implement T001-T009", or wants to execute tasks following strict TDD red-green-refactor workflow.
Didn't find tool you were looking for?