planning

$npx mdskill add langchain-ai/deepagents/planning

Decompose complex coding tasks into structured implementation plans.

  • Transforms vague requirements into actionable steps with file identification.
  • Integrates with grep for code search and write_todos for plan creation.
  • Evaluates breaking changes and edge cases before execution.
  • Outputs clear, numbered steps for review and risk assessment.

SKILL.md

.github/skills/planningView on GitHub ↗
---
name: planning
description: Break down a coding task into a structured implementation plan with clear steps, file identification, and risk assessment.
---

# Planning Skill

Use this skill when starting a new coding task to create a thorough implementation plan.

## Steps

### 1. Understand the Task
- Read the issue/task description completely
- Identify the expected outcome and acceptance criteria
- Note any constraints or requirements mentioned

### 2. Explore the Codebase
- Find the repository root and read the project structure
- Identify the tech stack (language, framework, test runner)
- Read README, CONTRIBUTING, or similar docs if they exist
- Find existing tests to understand testing patterns

### 3. Identify Relevant Files
- Use `grep` to find code related to the task
- Read the most relevant files (entry points, related modules)
- Identify which files need to be modified vs. created
- Check for existing patterns you should follow

### 4. Write the Plan
Use `write_todos` to create a structured plan:

```
write_todos([
    "1. <specific change in specific file>",
    "2. <next specific change>",
    "3. Write tests for <feature>",
    "4. Run test suite and fix failures",
    "5. Review all changes"
])
```

### 5. Assess Risks
- Are there breaking changes?
- Are there edge cases to handle?
- Does this affect other parts of the codebase?
- Flag anything uncertain for review

## Guidelines

- Plans should have 3-10 concrete steps
- Each step should be specific enough to execute without further planning
- Include test writing and test running as explicit steps
- End with a review/verification step

More from langchain-ai/deepagents

SkillDescription
analyze-market>-
arxiv-searchSearches arXiv for preprints and academic papers, retrieves abstracts, and filters by topic. Use when the user asks to find research papers, search arXiv, look up preprints, find academic articles in physics, math, CS, biology, statistics, or related fields.
blog-postWrites and structures long-form blog posts, creates tutorial outlines, and optimizes content for SEO with cover image generation. Use when the user asks to write a blog post, article, how-to guide, tutorial, technical writeup, thought leadership piece, or long-form content.
code-reviewPerform a structured code review of changes, checking for correctness, style, tests, and potential issues.
coding-prefsRead the user's coding preferences from /memory/coding-prefs.md before making non-trivial style decisions, and append new preferences when the user gives durable feedback.
competitor-analysis>-
cudf-analyticsUse for GPU-accelerated data analysis on datasets, CSVs, or tabular data using NVIDIA cuDF. Triggers when tasks involve groupby aggregations, statistical summaries, anomaly detection, or large-scale data profiling.
cuml-machine-learningUse for GPU-accelerated machine learning on tabular data using NVIDIA cuML. Triggers when tasks involve classification, regression, clustering, dimensionality reduction, or model training on datasets.
data-visualizationUse for creating publication-quality charts and multi-panel analysis summaries. Triggers when tasks involve visualizing data, plotting results, creating charts, or producing visual reports from analysis output.
gpu-document-processingUse when processing large PDFs, document collections, or bulk text extraction tasks that benefit from GPU-accelerated processing. Triggers when the user provides large documents or needs bulk document analysis.