plan-review
What this skill does
Plans are written to ./.agents/sessions/{date}-{xxx feature}/plan.md. Use the current date for {date} in YYYY-MM-DD form and a short kebab-case feature label for {xxx feature}. Review comments live inline in that same file — no separate threads, no external tools. The file is the single source of truth for both the plan and its review history.
Writing a plan
A useful plan explains why, not just what. Anyone reading it later — including a reviewer or a future you — should be able to reconstruct the reasoning without access to the original conversation.
For each significant decision, cover:
- What you decided
- What alternatives you considered and why you ruled them out
- What tradeoffs you accepted and why they're acceptable
This is more work upfront but eliminates the most common review failure mode: "why did you do it this way?" when the answer was obvious in context but undocumented.
Structure to follow:
More from vaayne/agent-kit
code-simplifier
Simplifies and refines code for clarity, consistency, and maintainability while preserving functionality. Triggers on "simplify this code", "clean up", "refactor for readability", "make this cleaner", or after implementing features when code polish is needed.
15mcp-jetbrains-ide
Control JetBrains IDE (IntelliJ, WebStorm, PyCharm) via MCP. Use when manipulating IDE files, running configurations, searching code, or performing refactoring. Triggers on "open in IDE", "run configuration", "refactor code", "IDE search", "JetBrains".
10web-fetch
Fetch and extract clean content from URLs using Jina Reader API. Use when users need to read webpage content, extract article text, or fetch URL content for analysis. Triggers on "fetch this page", "read this URL", "extract content from", "get the content of", "what does this page say".
10changelog-automation
Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.
9ui-skills
Opinionated constraints for building better interfaces with agents.
7specs-dev
Plan-first development workflow with review gates. Use when implementing features, refactoring, or any task requiring structured planning, iterative implementation with reviews, and clean commits. Triggers on requests like "implement feature X", "plan and build", "spec-driven development", or when user wants disciplined, reviewed code changes.
3