gen-plan

Generate sequential plan-N.md files in the repository root.

66|2|Updated Feb 18, 2015
One-click install
npx skills add https://github.com/tkersey/dotfiles --skill gen-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gen-plan
Source: https://github.com/tkersey/dotfiles/tree/main/codex/skills/gen-plan
Command: npx skills add https://github.com/tkersey/dotfiles --skill gen-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates and manages sequential plan-N.md files in the repository root, enabling incremental planning across a project without confusion.

Core Features & Use Cases

  • Incremental planning: Creates plan-1.md through plan-5.md according to the highest existing suffix, ensuring a single source of truth for repo-level planning.
  • Safety and scope: Restricts operations to the repository root and strictly handles files matching plan-(N).md, avoiding overwrites and illegal filenames.
  • Use case: When starting a new planning cycle, run the skill to produce plan-1.md and iterate through plan-2.md, etc., preserving an auditable history of planning steps.

Quick Start

Create a request to generate the first plan-1.md; the skill will prompt for clarification if no plan-*.md matches.

Frequently Asked Questions about gen-plan

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

FAQPage Schema
How do I generate sequential plan files in a repository?

To generate sequential plan files, the skill analyzes existing plan-N.md files in the repository root, determines the highest suffix N, and writes the next plan-(N+1).md file automatically.

What is the maximum number of plan-N.md files I can create?

The maximum number of plan-N.md files you can create is five. The skill halts and stops generating new files when plan-5.md already exists in the repository root.

Can I use this to automatically write planning files outside the repository root?

No, you cannot write planning files outside the repository root. The skill enforces strict safeguards, restricting all plan-N.md file generation strictly to the repository root directory.

Does generating a new plan file overwrite existing markdown files?

No, generating a new plan file does not overwrite existing markdown files. The skill enforces safeguards to prevent overwriting existing targets and strictly handles only plan-N.md filenames.

What happens if I request a new plan file but no plan files exist yet?

If no plan-N.md files exist yet, the skill will prompt for clarification. Once clarified, it generates the initial plan-1.md file to start your incremental planning cycle.