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.