plan-scripts

Create, read, update, and delete coding plan files under CODEX_HOME/plans.

8|1|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/akiojin/llm-router --skill plan-scripts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-scripts
Source: https://github.com/akiojin/llm-router/tree/main/.codex/skills/.system/plan/scripts/create_plan.py
Command: npx skills add https://github.com/akiojin/llm-router --skill plan-scripts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires plan_utils, and includes scripts (resource) components.

What problem does it solve?

Provides tooling to create, read, list, and manage plan files under the plans directory.

Core Features & Use Cases

  • Create new plans with frontmatter (name, description)
  • List plans and read frontmatter metadata
  • Overwrite or append plan bodies via templates

Quick Start

Use the script to create a new plan: python scripts/create_plan.py --name sample-plan --description "A concise example plan" --template

Frequently Asked Questions about plan-scripts

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

FAQPage Schema
How do I create a plan markdown file for a coding project?▼

Create a plan markdown file by running the create script with a name and description. The Skill generates a plan file with frontmatter (name, description) under ~/.codex/plans, enforcing consistent file naming and structure for your project workflow.

What's the best way to organize and manage multiple plan files?▼

List and read plan frontmatter metadata across your plans directory to organize projects. The Skill manages the full plan lifecycle—create, read, update, and delete—keeping all plans centralized under CODEX_HOME/plans with enforced naming rules and frontmatter structure.

Can I update an existing plan or append content to it?▼

Yes, update or append plan bodies via templates. The Skill supports overwriting or extending plan files while preserving frontmatter metadata, letting you evolve plans as your coding task develops.

Do I need to manually manage frontmatter when saving plan files?▼

No, frontmatter is enforced automatically. The Skill validates and maintains frontmatter structure (name, description) on every save, removing the burden of manual formatting when creating or updating plans.

How do I find and read an existing plan from my plans directory?▼

List all plans to browse available files, then read any plan to access its frontmatter metadata and body content. The Skill resolves CODEX_HOME/plans directory automatically, making plan discovery and retrieval straightforward.

What happens if my plan file doesn't follow the naming or structure rules?▼

The Skill enforces file naming rules and frontmatter structure on save, preventing malformed plans. If a file violates these rules, the operation fails with validation feedback, ensuring all plans in your directory remain consistent and parseable.