Our review
This skill creates a structured plan for implementing a new feature by following a detailed template and analyzing the existing codebase.
Strengths
- Step-by-step guide for planning complex features
- Encourages reuse of existing patterns
- Includes sections for testing and validation
Limitations
- Requires a well-structured codebase to be effective
- Can be overly rigid for very simple features
Use this skill when you need to implement a non-trivial feature and want a clear plan before coding.
Do not use it for minor bug fixes or refactoring tasks that don't require a formal plan.
Security analysis
SafeThe skill only generates a planning document in markdown format; it does not execute any commands or require external tools. There is no risk of destructive actions.
No concerns found
Examples
Create a feature plan for implementing user authentication with email and password, including login, signup, and password reset.Plan the implementation of a new dashboard overview page that shows key metrics and recent activity from the database.name: feature description: Create a feature plan for implementing a new feature
Feature Planning
Create a new plan in specs/*.md to implement the Feature using the exact specified markdown Plan Format. Follow the Instructions to create the plan use the Relevant Files to focus on the right files.
Instructions
- You're writing a plan to implement a net new feature that will add value to the application.
- Create the plan in the
specs/*.mdfile. Name it appropriately based on theFeature. - Use the
Plan Formatbelow to create the plan. - Research the codebase to understand existing patterns, architecture, and conventions before planning the feature.
- IMPORTANT: Replace every <placeholder> in the
Plan Formatwith the requested value. Add as much detail as needed to implement the feature successfully. - Use your reasoning model: THINK HARD about the feature requirements, design, and implementation approach.
- Follow existing patterns and conventions in the codebase. Don't reinvent the wheel.
- Design for extensibility and maintainability.
- If you need a new library, use
npm addand be sure to report it in theNotessection of thePlan Format. - Respect requested files in the
Relevant Filessection. - Start your research by reading the
README.mdfile.
Relevant Files
Focus on the following files:
README.md- Contains the project overview and instructions.convext_rules.txt- Contains Convex rules for backend.src/**- Contains the NextJS application with app router.
Ignore all other files in the codebase.
Plan Format
# Feature: <feature name>
## Feature Description
<describe the feature in detail, including its purpose and value to users>
## User Story
As a <type of user>
I want to <action/goal>
So that <benefit/value>
## Problem Statement
<clearly define the specific problem or opportunity this feature addresses>
## Solution Statement
<describe the proposed solution approach and how it solves the problem>
## Relevant Files
Use these files to implement the feature:
<find and list the files that are relevant to the feature describe why they are relevant in bullet points. If there are new files that need to be created to implement the feature, list them in an h3 'New Files' section.>
## Implementation Plan
### Phase 1: Foundation
<describe the foundational work needed before implementing the main feature>
### Phase 2: Core Implementation
<describe the main implementation work for the feature>
### Phase 3: Integration
<describe how the feature will integrate with existing functionality>
## Step by Step Tasks
IMPORTANT: Execute every step in order, top to bottom.
<list step by step tasks as h3 headers plus bullet points. use as many h3 headers as needed to implement the feature. Order matters, start with the foundational shared changes required then move on to the specific implementation. Include creating tests throughout the implementation process. Your last step should be running the `Validation Commands` to validate the feature works correctly with zero regressions.>
## Testing Strategy
### Unit Tests
<describe unit tests needed for the feature>
### Integration Tests
<describe integration tests needed for the feature>
### Edge Cases
<list edge cases that need to be tested>
## Acceptance Criteria
<list specific, measurable criteria that must be met for the feature to be considered complete>
## Validation Commands
Execute every command to validate the feature works correctly with zero regressions.
<list commands you'll use to validate with 100% confidence the feature is implemented correctly with zero regressions. every command must execute without errors so be specific about what you want to run to validate the feature works as expected. Include commands to test the feature end-to-end.>
## Notes
<optionally list any additional notes, future considerations, or context that are relevant to the feature that will be helpful to the developer>
Feature
$ARGUMENTS
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.