oat-project-plan-writing

Validate plan.md files in OAT projects against canonical format invariants.

1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/tkstang/open-agent-toolkit --skill oat-project-plan-writing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oat-project-plan-writing
Source: https://github.com/tkstang/open-agent-toolkit/tree/main/.agents/skills/oat-project-plan-writing
Command: npx skills add https://github.com/tkstang/open-agent-toolkit --skill oat-project-plan-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that all plan.md files within OAT projects adhere to a strict, standardized format, preventing inconsistencies and errors in project planning.

Core Features & Use Cases

  • Canonical Format Enforcement: Guarantees stable task IDs, required sections, and specific frontmatter invariants.
  • Review Table Preservation: Prevents deletion of existing review rows, maintaining historical data.
  • Use Case: When generating or updating a project plan, this Skill automatically validates that all necessary sections like 'Reviews' and 'Implementation Complete' are present and correctly formatted, ensuring the plan is ready for execution.

Quick Start

Use the oat-project-plan-writing skill to validate the plan.md file in the current directory.

Frequently Asked Questions about oat-project-plan-writing

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

FAQPage Schema
How do I enforce a standardized plan.md format for project planning?

To enforce a standardized plan.md format, validate frontmatter keys like oat_plan_source, oat_status, and oat_ready_for, and ensure required sections such as Reviews and Implementation Complete are present. This prevents inconsistencies in project planning workflows.

What frontmatter keys are required in an OAT project plan file?

Required frontmatter keys in an OAT project plan file include oat_plan_source, oat_status, and oat_ready_for. Validating these keys ensures the plan maintains stable task IDs and adheres to canonical format invariants for execution readiness.

How do I prevent accidental deletion of review rows when updating a plan.md?

To prevent accidental deletion of review rows when updating a plan.md, apply review table preservation rules during plan mutation. This maintains historical data by blocking the removal of existing review rows while allowing new entries.

What sections need to be present in a valid project plan markdown file?

A valid project plan markdown file must contain required sections including Reviews and Implementation Complete. Checking for these sections guarantees the plan is correctly formatted and ready for execution before any tasks begin.

How do I manage stable task IDs in project management documentation?

To manage stable task IDs in project management documentation, enforce canonical format invariants during plan authoring. This keeps task identifiers consistent across mutations, preventing reference errors during execution and resume operations.

Do I need any dependencies to validate plan files in the current directory?

No dependencies are required to validate plan files in the current directory. You can directly check the plan.md file against the canonical format invariants, verifying frontmatter, required sections, and review table rules without external tools.