plan

Create, read, update, delete, and list structured plans with YAML frontmatter metadata.

15|2|Updated Nov 17, 2025
One-click install
npx skills add https://github.com/OutlineDriven/odin-codex-plugin --skill plan-outlinedriven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/OutlineDriven/odin-codex-plugin/tree/main/skills/plan
Command: npx skills add https://github.com/OutlineDriven/odin-codex-plugin --skill plan-outlinedriven

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Draft and manage structured plans to convert vague objectives into explicit, executable roadmaps.

Core Features & Use Cases

  • Create, save, read, update, and delete plans stored under CODEX_HOME/plans (default ~/.codex/plans) with YAML frontmatter metadata.
  • Enforce a frontmatter contract (name and description) and provide tooling to discover, list, and reference plans.
  • Use plans to document scope, requirements, action items, testing/validation, and risks for complex coding tasks, architecture reviews, or project planning.

Quick Start

Draft a new plan by providing a name and description to the plan tool and supplying the plan body or a template.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I draft a structured plan for a complex coding task?

Draft a structured plan by providing a name and description to generate a plan body with YAML frontmatter metadata, which is then saved under CODEX_HOME/plans. This converts vague coding objectives into an executable roadmap documenting scope, requirements, and action items.

What is YAML frontmatter and when do I need it for task management?

YAML frontmatter is required metadata at the top of a plan file that enforces a contract specifying a name and description. You need it to validate plan names and manage structured task workflows for complex coding projects.

How do I manage and update existing coding plans?

Manage existing coding plans using built-in read, update, delete, and list workflows that operate on the CODEX_HOME/plans directory. Reference and modify plan bodies through helper scripts to keep task documentation current.

Can I use this plan tool for architecture reviews and project planning?

Yes, use this plan tool for architecture reviews, project planning, and complex coding tasks. It documents scope, requirements, action items, testing validation, and risks by enforcing structured frontmatter metadata for each plan.

What are the limitations of frontmatter-enforced plan validation?

Frontmatter-enforced plan validation requires a strict contract with a name and description, meaning plans missing these fields will fail validation. Plan names are validated to ensure they meet the required format before saving to the plans directory.

Does the plan workflow require any external dependencies to operate?

No, the plan workflow operates independently without external dependencies, relying solely on helper scripts to generate, save, and reference plan bodies. It functions within the CODEX_HOME/plans directory using standard YAML frontmatter.