gh-atournayre-claude-marketplace-dev/skills/prepare/SKILL.md

name, description, allowed-tools, model

name	description	allowed-tools	model
prepare	Creates a concise engineering implementation plan based on user requirements and saves it to specs directory	Read Write Edit Grep Glob MultiEdit	claude-opus-4-1-20250805

Quick Plan

Create a detailed implementation plan based on the user's requirements provided through the USER_PROMPT variable. Analyze the request, think through the implementation approach, and save a comprehensive specification document to PLAN_OUTPUT_DIRECTORY/<name-of-plan>.md that can be used as a blueprint for actual development work.

Variables

USER_PROMPT: $ARGUMENTS PLAN_OUTPUT_DIRECTORY: docs/specs/

Instructions

• Carefully user's requirements provided in the USER_PROMPT variable
• Think deeply about the best approach to implement the requested functionality or solve the problem
• Create a concise implementation plan that includes:
• Clear problem statement and objectives
• Technical approach and architecture decisions
• Step-by-step implementation guide
• Actionable todo list with markdown checkboxes that can be tracked and updated during implementation
• Potential challenges and solutions
• Testing strategy
• Success criteria
• Generate a descriptive, kebab-case filename based on the main topic of the plan
• Save the complete implementation plan to PLAN_OUTPUT_DIRECTORY/<descriptive-name>.md
  • Ensure the plan is detailed enough that another developer could follow it to implement the solution
  • Include code examples or pseudo-code where appropriate to clarify complex concepts
  • The todo list must use markdown checkboxes - [ ] with granular, actionable tasks in logical implementation order
• Consider edge cases, error handling, and scalability concerns
  • Structure the document with clear sections and proper markdown formatting

Workflow

1. Analyze Requirements - THINK HARD and parse the USER_PROMPT to understand the core problem and desired outcome
2. Design Solution - Develop technical approach including architecture decisions and implementation strategy
3. Document Plan - Structure a comprehensive markdown document with problem statement, implementation steps, and testing approach
4. Generate Filename - Create a descriptive kebab-case filename based on the plan's main topic
5. Save & Report - Write the plan to PLAN_OUTPUT_DIRECTORY/<filename>.md and provide a summary of key components

Report

After creating and saving the implementation plan, provide a concise report with the following format:

✅ Implementation Plan Created

File: PLAN_OUTPUT_DIRECTORY/<filename>.md

Topic: <brief description of what the plan covers>

Key Components:
- <main component 1>
- <main component 2>
- <main component 3>