change-outline

Generates persistent step-by-step change checklists anchored to files, symbols, and line ranges.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/jakestrouse00/opencode-toolkit --skill change-outline-jakestrouse00
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change-outline
Source: https://github.com/jakestrouse00/opencode-toolkit/tree/main/skills/change-outline
Command: npx skills add https://github.com/jakestrouse00/opencode-toolkit --skill change-outline-jakestrouse00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Losing track of a multi-file code change across sessions is common: you forget which files to touch, which symbols to edit, and what was already done. This Skill turns a desired change into a durable, resumable checklist stored at .opencode/plans/<slug>.md, so the plan survives across sessions and can be executed later on demand. ## Core Features & Use Cases - Three firewalled modes: PLAN writes the outline then hard-stops, RESUME reconciles the checklist against the live codebase without editing, and EXECUTE runs remaining steps only when the user literally says "execute <slug>". - Repo-grounded planning: reads AGENTS.md first, explores the codebase with grep/read or explore subagents, and anchors every step to a file, symbol, and approximate line range verified against the live tree. - Automatic archiving: when all steps are done and whole-change verification passes, it sets Status: complete and moves the plan into .opencode/plans/archive/ without overwriting existing archives. - Use Case: You ask to "plan adding caching to the validator". The Skill explores the repo, writes a numbered checklist of every file and symbol to change with per-step verification commands, then stops. Days later, in a new session, you say "execute add-validator-caching" and it reconciles what is already done, applies the remaining edits step by step, verifies each, and archives the completed plan. ## Quick Start Ask the assistant to plan a specific code change, for example: plan the steps to add request logging to the API handlers.

Frequently Asked Questions about change-outline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a step-by-step plan for a code change?

Describe the change you want, for example "plan this change" or "outline the steps to add caching". The Skill explores the repository, reads AGENTS.md, and writes a numbered checklist to .opencode/plans/<slug>.md with file, symbol, and line-range anchors, then stops without editing anything.

How do I resume a code change plan in a new session?

Say "resume <slug>" or "what's left on <slug>". The Skill re-reads the plan file from disk, re-greps each cited symbol against the live tree, marks completed steps done, updates drifted line ranges, and prints only the remaining steps.

Does the planning skill automatically make the code edits?

No. PLAN and RESUME modes never edit source files. Execution begins only when you literally say "execute <slug>", which triggers a separate EXECUTE mode that walks the remaining steps, verifies each one, and re-saves the plan after every step.

What happens when a change plan is fully completed?

When all steps are checked off and the plan's whole-change verification passes, the Skill sets Status: complete and moves the file to .opencode/plans/archive/<slug>.md. If an archive with the same slug exists, it suffixes -2, -3, and so on instead of overwriting.

Why does the plan file use line ranges if they go stale?

Line ranges are snapshots marked approximate with ~ because they drift as earlier edits land. On resume or execute, the Skill re-greps each symbol in the live tree and refreshes the ranges rather than trusting the stale numbers.