skills/planning/SKILL.md
Use when explicitly instructed to create an plan (feature, bug fix, or refactor). Not for automatic use—only when directly requested.
npx skillsauth add LandonSchropp/agent-toolkit skills/planningInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
If the scope of the plan is not clear from the arguments or previous context, ask the user: "Please describe the plan or provide a Linear issue ID, Linear issue URL, Linear branch name, or Sentry issue URL (for bug-fix)." If the user responds with a Linear issue or branch name, fetch the issue details using the Linear MCP server. Linear branch names follow the pattern [team-prefix]/[ISSUE-ID]-description or [ISSUE-ID]-description (e.g., landon/eng-123-fix-login or eng-123-fix-login) — extract the issue ID with the regex [A-Za-z]+-\d+ and uppercase it. If the user provides a Sentry issue URL (bug-fix only), store it for use in the plan template.
Determine the feature branch. If the user provided a Linear branch name, use it as the feature branch. If the user provided a Linear issue (without a branch), use the branch specified in the issue. If the current branch is the default branch (main/master), ask the user: "What feature branch would you like to use?" Otherwise, ask the user: "Would you like to use {current_branch} as the feature branch?"
If the current branch is the feature branch, move on to step 4. Otherwise, ask the user: "Would you like to use {current_branch} as the base branch?". Then call scripts/create-feature-branch.sh with the feature branch and the base branch.
Create a plan file using scripts/generate-plan-template.ts. This will generate a pre-populated plan for you to fill out. Read the resulting file.
Identify relevant skills for executing the plan. Review the available skills and determine which apply to the work (e.g., git-commit, git-pull-request, testing-typescript). Replace example in the Skills section with each applicable skill on its own list item.
Fill out each section of the plan one at a time. Follow the instructions in the template for each section.
.claude/plans. Only edit the plan template file that was generated.git log and git diff to see commits and changes.After the plan is complete, invoke the neovim skill and open the plan file in Neovim so the user can review it.
ultrathink
tools
Use when working with a stack of GitHub pull requests — creating branches, keeping the stack in sync, or merging in order. Covers Git Town setup, PR targeting, rebasing, and landing the stack.
tools
Use when writing or modifying tests in a Bun project
tools
Use when publishing or releasing a new version of an npm/pnpm/yarn/bun package to the registry. Covers package-manager detection, semver bump selection, tagging, pushing, scoped-package access, authentication, and one-time passwords (OTP).
tools
Use when a finished worktree's branch has been reviewed and committed and needs to land. Rebases onto the latest default branch, then either fast-forwards it into the default branch (personal direct-to-main repos) or pushes it for a pull request (shared feature-branch repos).