refine-plan

Analyze YAML plan files and correct structural, dependency, and clarity issues.

7|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/CaseyHaralson/orrery --skill refine-plan-caseyharalson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-plan
Source: https://github.com/CaseyHaralson/orrery/tree/main/agent/skills/refine-plan
Command: npx skills add https://github.com/CaseyHaralson/orrery --skill refine-plan-caseyharalson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users analyze and improve their project plans by identifying structural issues, dependency problems, and unclear criteria, ensuring plans are ready for autonomous execution.

Core Features & Use Cases

  • Plan Analysis: Loads and parses YAML plan files to assess structure, dependencies, and metadata.
  • Quality Improvements: Detects missing fields, dependency cycles, vague criteria, and thin context, then suggests and implements fixes.
  • Use Case: When a team updates a plan but it contains unnoticed errors or inefficiencies, this Skill ensures the plan is robust, well-structured, and schema-compliant before deployment.

Quick Start

Use the refine-plan skill to analyze and improve your execution plan by specifying your plan file.

Frequently Asked Questions about refine-plan

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

FAQPage Schema
How do I analyze and fix structural issues in a YAML project plan?

To analyze and fix structural issues in a YAML project plan, you can use an automated validation tool to parse the file, detect missing fields and dependency cycles, then apply targeted corrections to ensure schema compliance.

What is the best way to identify dependency cycles in project plans before execution?

Identifying dependency cycles in project plans involves parsing the YAML structure to map task relationships and detect circular references. Automated analysis tools can flag these dependency issues and suggest targeted corrections to ensure reliable execution.

How do I prepare a YAML plan for autonomous execution in AI workflows?

Preparing a YAML plan for autonomous execution requires checking for vague criteria and thin context. Refine the plan by validating metadata, resolving dependency problems, and applying structural corrections to ensure the plan is robust and ready for deployment.

Can I use automated validation to detect missing fields in my execution plan?

Yes, you can use automated validation to detect missing fields in your execution plan. By loading and parsing the YAML file, the analysis process assesses the structure and metadata, highlighting absent fields and suggesting quality improvements.

What are common dependency problems in YAML project plans and how are they corrected?

Common dependency problems in YAML project plans include missing references, circular dependencies, and incorrect task ordering. These are corrected through targeted analysis that identifies the structural issues and applies fixes to ensure reliable execution.

When do I need to refine an existing project plan?

You need to refine an existing project plan when it contains unnoticed errors, vague criteria, or dependency inefficiencies. If the plan lacks the structural clarity required for autonomous execution, targeted corrections and quality improvements are necessary before deployment.