next-steps
Skill0 starsChanged 6 months agoMITView on GitHub
Use when the user wants to turn findings, review output, audit results, brainstorming notes, retrospective outcomes, or other analysis into a dependency-aware strategic action plan. Trigger on requests like "what do we do about this", "plan this out", "what's the sequence here", "how should we tackle these findings", "action plan", "create an action plan", or "what's the plan of attack". Also trigger after a review, audit, retrospective, or brainstorming session completes and the natural next step is deciding what to do about the findings. Use for strategic tasks where done means the approach is agreed and ready for a focused follow-up session. Do not use for session-sized implementation planning, step-by-step coding plans, or direct execution work.
We split this skill into the rules it gives an agent
13 rules. 0 are common, 11 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 6 edited versions we read keep these.
11
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 28
If the conversation already has a clear implementation path, use session-sized implementation planning instead.
- Distinctive: line 32
If there is no clear set of findings to plan from, ask what artifact or discussion should be turned into a plan.
- Distinctive: line 33
If the analysis contains only one obvious next step, say so directly instead of fabricating a multi-phase plan.
- Distinctive: line 34
If the work is already implementation-ready, say that this skill is the wrong level and switch to normal implementation planning.
- Distinctive: line 35
If several independent problem areas are mixed together, separate them into named strategic tasks instead of blending them into one vague …
- Distinctive: line 36
If sequencing is uncertain, state what missing information would resolve the ordering instead of guessing.
- Distinctive: line 42
Keep the task list as small as reality allows.
- Distinctive: line 44
Prefer the order that resolves blocking decisions earliest, not the order that feels easiest.
- Distinctive: line 50
Write one short paragraph that states:
- Very specific: line 60
Use short task IDs such as T1, T2, and T3.
- Very specific: line 101
If there are no meaningful decision points, say: None - all tasks have a single forward path.
- Distinctive: line 153
Before finalizing, verify that the critical path is derivable from the dependency map.
- Distinctive: line 157
If you have a follow-up advisor skill, dispatch it here.
“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Action Plan
Produce a dependency-aware, gated plan of high-level strategic tasks from existing findings or analysis. Turn a pile of issues into an ordered plan for what to resolve first, what can run in parallel, and where decisions can change the path.
Quick start
- Identify the findings, problems, or themes that the plan is meant to address.
- Separate strategic tasks from implementation tasks. Keep this plan at the "what and why" level, not the "how" level.
- Build a dependency map before sequencing phases.
- Surface decision gates explicitly instead of pretending the plan is linear when it is not.
- Derive the critical path from the dependency map, then name the single highest-risk task.
- Park non-critical items instead of bloating the immediate plan.
When this skill applies vs. when it doesn't
| Use action-plan | Use session-sized implementation planning instead |
| Findings from a review, audit, or brainstorm need to become coordinated work | A design decision is made and you need session-sized implementation tasks |
| "Done" = approach agreed, ready for follow-up session | "Done" = verifiable condition (tests pass, file exists) |
| Tasks are strategic: what should change and why | Tasks are tactical: how to change it, step by step |
| Output feeds into deeper planning sessions | Output feeds directly into coding work |
If the conversation already has a clear implementation path, use session-sized implementation planning instead.
Defaults and failure modes
- If there is no clear set of findings to plan from, ask what artifact or discussion should be turned into a plan.
- If the analysis contains only one obvious next step, say so directly instead of fabricating a multi-phase plan.
- If the work is already implementation-ready, say that this skill is the wrong level and switch to normal implementation planning.
- If several independent problem areas are mixed together, separate them into named strategic tasks instead of blending them into one vague item.
- If sequencing is uncertain, state what missing information would resolve the ordering instead of guessing.
Non-negotiables
- Stay strategic. Each task must name what should change and why it matters, not how to implement it.
- Define task completion as
approach agreed,question resolved, orready for a focused follow-up session. - Keep the task list as small as reality allows. Do not pad the plan.
- Surface dependencies explicitly. If two tasks can start now, say so.
- Prefer the order that resolves blocking decisions earliest, not the order that feels easiest.
Workflow
1. Summarize the current state
Write one short paragraph that states:
- What findings or themes are being acted on
- What is being parked for later
- Any hard constraints, dependencies, or scope boundaries already known
2. Build the dependency map
List every discrete strategic task needed to address the active findings.
Use short task IDs such as T1, T2, and T3.
For each task, state:
- The task itself
- What it depends on, or
none - can start now
Use this format:
T1: <task> - depends on: noneT2: <task> - depends on: T1T3: <task> - depends on: none (parallel to T1)
3. Sequence the plan
Group tasks into phases derived from the dependency map.
- Tasks in the same phase are parallelizable.
- A later phase must only contain tasks blocked on earlier phases.
For each task, include a done when clause that stays at the strategic level.
Use this format:
**Phase 1** (can start now):
- T1: <task> - done when: <approach agreed / question resolved / ready for follow-up session>
- T3: <task> - done when: <approach agreed / question resolved / ready for follow-up session>
**Phase 2** (after Phase 1):
- T2: <task> - done when: <approach agreed / question resolved / ready for follow-up session>4. Call out decision gates
State where the plan branches based on an outcome.
Use this format:
After T1: if <condition>, then <path A>; otherwise <path B>
If there are no meaningful decision points, say: None - all tasks have a single forward path.
5. Identify the critical path
State the longest dependency chain, such as T1 -> T3 -> T5.
Then name the single highest-risk task and state:
- Which task it is
- The likelihood it stalls the plan
- The impact if it does
- Whether it is on the critical path
- Why it deserves priority
Recommend starting there unless another task must precede it.
6. Park out-of-scope items
List findings worth revisiting later but not required for the immediate goal. Keep this to 3-5 items max.
Output format
Use this structure:
### 1. Current State
[one paragraph]
### 2. Dependency Map
- T1: <task> - depends on: none
- T2: <task> - depends on: T1
### 3. Sequenced Plan
**Phase 1** (can start now):
- T1: <task> - done when: <strategic completion condition>
**Phase 2** (after Phase 1):
- T2: <task> - done when: <strategic completion condition>
### 4. Decision Gates
- After T1: if <condition>, then <path A>; otherwise <path B>
### 5. Critical Path
**Scheduling:** <critical path chain>
**Highest-risk task:** <task> - likelihood: <low/medium/high>; impact: <low/medium/high>; on critical path: <yes/no>; why: <reason>
### 6. Out of Scope (Parked)
- <item>
- <item>Before finalizing, verify that the critical path is derivable from the dependency map. Every link in the chain must correspond to a declared dependency.
After producing the plan
If you have a follow-up advisor skill, dispatch it here.
Anti-patterns
| Pattern | Problem | Fix |
| Turning the plan into implementation steps | It makes the plan brittle and too detailed for this stage. | Stay at the level of strategic tasks and follow-up sessions. |
| Listing tasks without dependencies | It hides sequencing and parallelism. | Make every dependency explicit, including none - can start now. |
| Sequencing by comfort | Easy work first can delay the real blocker. | Order the plan around decision resolution and dependency removal. |
| Treating all tasks as equal | It obscures the real schedule driver. | Name the critical path and highest-risk task explicitly. |
| Padding the plan | It dilutes signal and slows execution. | Keep only the tasks required to move from findings to an agreed approach. |
| Hiding uncertainty | A fake linear plan creates rework later. | Use decision gates and state what could branch the plan. |
Example
User: "We just finished a security review and a reliability audit. What should we tackle first?"
1. Current State
The active findings are weak service-to-service trust boundaries, incomplete rollback procedures, and unclear ownership of incident recovery. Cosmetic cleanup items and low-value documentation improvements are parked. The main constraint is that production changes cannot proceed until the trust and rollback approach is agreed.
2. Dependency Map
- T1: define the target trust-boundary model for service-to-service calls - depends on: none
- T2: define the rollback and recovery strategy for high-risk deployments - depends on: none
- T3: assign ownership and escalation paths for incident recovery - depends on: T2
- T4: decide whether the current rollout plan can continue or must be re-scoped - depends on: T1, T2
3. Sequenced Plan
Phase 1 (can start now):
- T1: define the target trust-boundary model for service-to-service calls - done when: the security model is agreed and ready for focused design work
- T2: define the rollback and recovery strategy for high-risk deployments - done when: the rollback approach is agreed and ready for operational planning
Phase 2 (after Phase 1):
- T3: assign ownership and escalation paths for incident recovery - done when: ownership is agreed and escalation gaps are closed
- T4: decide whether the current rollout plan can continue or must be re-scoped - done when: the go/no-go criteria are agreed
4. Decision Gates
- After T1 and T2: if the security model or rollback plan requires architectural change, then re-scope the rollout; otherwise continue with focused implementation planning.
5. Critical Path
Scheduling: T2 -> T3
Highest-risk task: T2 - likelihood: high; impact: high; on critical path: yes; why: the plan cannot safely move forward without a credible rollback and recovery strategy.
6. Out of Scope (Parked)
- clean up non-critical internal docs
- standardize low-risk dashboard naming
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- swyxio/skills★ 189same name
- a-lottes/aSPARK★ 24same name
- jelbirt/LLM-Skill-Build★ 1same name
- ac5tin/skills★ 0same name
- TucsenRoman/claude-skills★ 0same name
- YoniChechik/claude-code-config★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository5 other files it gives its agents.
- git-hygieneSkill
- making-recommendationsSkill
- scrutinizeSkill
- system-design-reviewSkill
- writing-principlesSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

