plans

Manage hierarchical Markdown planning documents with YAML frontmatter and token-budgeted lazy loading.

2|1|Updated Aug 23, 2025
One-click install
npx skills add https://github.com/neozenith/agentic-dotfiles --skill plans-neozenith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plans
Source: https://github.com/neozenith/agentic-dotfiles/tree/main/skills/plans
Command: npx skills add https://github.com/neozenith/agentic-dotfiles --skill plans-neozenith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires marko, python-frontmatter, tiktoken, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users efficiently manage hierarchical planning documents with features like token-budgeted lazy loading, automatic rebalancing, and cascading context injection, making it ideal for large planning documents or splitting oversized plans.

Core Features & Use Cases

  • Hierarchical Planning: Manage markdown planning documents with YAML frontmatter, token-budgeted lazy loading, and automatic rebalancing.
  • Quick Start: Use the plan_manager.sh script to initialize a new plan document, analyze the structure with analyze, load context with context, split oversized documents with rebalance, and update summaries with update-summary.
  • Use Case: Imagine you have a complex project plan with multiple dependencies. Use this Skill to break down the plan into smaller, manageable sections, analyze each section's content, and easily load relevant information into your AI's context.

Quick Start

To get started, run the following command:

.claude/skills/plans/scripts/plan_manager.sh init docs/plans/my-plan.md

Frequently Asked Questions about plans

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

FAQPage Schema
How do I manage hierarchical planning documents that exceed AI context limits?

Manage hierarchical planning documents by using token-budgeted lazy loading to load only relevant sections into AI context. This approach optimizes large markdown files by splitting oversized plans into smaller, manageable chunks.

How do I split oversized markdown project plans into smaller sections?

Split oversized markdown plans using the rebalance feature, which automatically breaks down large documents with YAML frontmatter. This process divides complex project dependencies into smaller, context-ready sections.

What is token-budgeted lazy loading for markdown documents?

Token-budgeted lazy loading is a mechanism that loads specific markdown sections into AI context based on token limits. It uses YAML frontmatter and automatic rebalancing to efficiently inject cascading context.

Do I need Python to manage markdown planning documents with token budgets?

Yes, you need Python installed because this Skill relies on Python scripting to execute token counting and document rebalancing operations. It also uses markdown for documentation and YAML frontmatter for metadata.

How do I initialize and analyze a hierarchical plan structure?

Initialize and analyze a hierarchical plan by running the plan_manager.sh script with the init command, then use the analyze command to evaluate the document structure. Use context to load sections and update-summary to refresh metadata.

When should I use automatic rebalancing for planning documents?

Use automatic rebalancing when your hierarchical planning documents grow too large for AI context windows. It prevents token limit overflows by splitting oversized plans and updating summaries to maintain structural integrity.