plan-utils

Generate structured plans with YAML frontmatter for software projects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Central utilities for reading, validating, and writing plan files under the plans directory.

Core Features & Use Cases

  • Determine CODEX_HOME and plans directory paths
  • Validate plan names and frontmatter structure
  • Parse frontmatter from plan files

Quick Start

Use within other plan scripts to ensure consistent plan handling.

Frequently Asked Questions about plan-utils

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

FAQPage Schema
How do I structure plan files with frontmatter for coding projects?

Plan files use YAML frontmatter containing name and description metadata, followed by the plan body. plan-utils provides validation and parsing utilities to ensure consistent frontmatter structure across all plans stored in your CODEX_HOME/plans directory.

What utilities are available for managing plan files?

plan-utils offers core helpers for reading, validating, and writing plan files. It handles path resolution, frontmatter parsing, plan name validation, and supports complete plan lifecycle operations including create, read, update, and delete workflows.

How do I determine the correct plans directory path?

plan-utils automatically determines CODEX_HOME and derives the plans directory path, eliminating manual path configuration. Use these utilities within other plan scripts to ensure consistent directory handling across your planning workflows.

Can I validate plan names and frontmatter before saving?

Yes, plan-utils validates both plan names and frontmatter structure to catch issues before writing. This ensures all plans meet metadata requirements—single-line name and description fields—before being saved to the plans directory.

Do I need plan-utils if I'm building custom plan management scripts?

Yes. plan-utils provides shared helpers that standardize plan file handling across multiple scripts. Using it ensures consistent validation, parsing, and directory management rather than duplicating logic in each custom script.