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.