plan-list

Generate and manage coding task plans in CODEX_HOME/plans.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Quickly summarize available plans by reading frontmatter only.

Core Features & Use Cases

  • Read name and description from each plan
  • Optional JSON output for programmatic consumption
  • Filter plans by a query string

Quick Start

List plans and filter by a keyword: python scripts/list_plans.py --query "rate limit"

Frequently Asked Questions about plan-list

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

FAQPage Schema
How do I list and summarize all my plan files?▼

List plan summaries by reading frontmatter from each plan file in your plans directory. The Skill extracts name and description metadata without parsing the full plan body, giving you a quick overview of available plans.

Can I filter plans by keyword when listing them?▼

Yes, filter plans by query string to find specific plans. Run the listing with a keyword like 'rate limit' to match plans by name or description, reducing noise when you have many plans stored.

What format do plan files need to follow?▼

Plans use lowercase hyphen-delimited file names with YAML frontmatter containing name and description fields, followed by a plan body starting with '# Plan'. This enforced convention ensures consistent structure across your plans directory.

Can I export plan listings as JSON for programmatic use?▼

Yes, optional JSON output lets you consume plan summaries programmatically. Parse the structured name, description, and metadata fields directly instead of reading plain text output.

How do I organize plans across my workspace?▼

Plans are stored in CODEX_HOME/plans with enforced naming and frontmatter conventions. This centralized directory structure makes it easy to find, read, update, and manage all your plans in one place.