skills.rest
suj1e
suj1eCOMMUNITY
Explore all skills by this author →
GitHub

optr

Optimize PLAN.md tasks, create teams, and sync documentation.

Updated Aug 23, 2026
Search Tags:#automation#documentation#team#PLAN.md#tools-discovery#optr
One-click install
npx skills add https://github.com/suj1e/optr --skill optr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: optr
Source: https://github.com/suj1e/optr/tree/main/optr-plugin/skills/optr
Command: npx skills add https://github.com/suj1e/optr --skill optr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

OPTR automates PLAN.md optimization, team creation, and cross-document synchronization of project documentation once tasks complete.

Core Features & Use Cases

  • Automatic PLAN.md optimization: Analyze PLAN.md to break down vague goals, clarify acceptance criteria, and define task dependencies for actionable execution.
  • Team creation and task orchestration: Create Claude Code teams and spawn teammates to execute tasks derived from the optimized plan.
  • Documentation sync: Automatically update PLAN.md, README.md, and CLAUDE.md after task completion to reflect progress and outcomes.
  • Use Case: When a project PLAN.md is messy, this skill restructures it into concrete tasks with assigned roles and a clear execution path.

Quick Start

Run /optr to analyze PLAN.md, optimize tasks, create a team, spawn teammates, and update documentation after task completion.

Frequently Asked Questions about optr

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

FAQPage Schema
How do I automate PLAN.md task breakdown and team assignment?▼

To automate PLAN.md task breakdown, optr scans the file to extract actionable tasks, clarify acceptance criteria, and spawn Claude Code teammates for execution. It restructures vague project goals into concrete tasks with assigned roles and clear dependency paths.

What is the best way to keep README.md and CLAUDE.md synced with project progress?▼

The best way to keep README.md and CLAUDE.md synced is through automated documentation synchronization. Upon task completion, optr automatically updates PLAN.md, README.md, and CLAUDE.md to reflect the latest outcomes and project progress.

How does team creation work for executing tasks derived from a project plan?▼

Team creation for executing project plan tasks works by spawning Claude Code teammates based on the optimized plan. It coordinates task assignment and manages dependencies locally and on GitHub to consolidate discovered agents and skills for execution.

Do I need a specific PLAN.md format to automate project documentation and task orchestration?▼

You do not need a specific PLAN.md format to automate project documentation and task orchestration. The tool analyzes and optimizes messy or vague PLAN.md files by breaking down goals, clarifying acceptance criteria, and defining task dependencies automatically.

Can I discover relevant skills and agents on GitHub for task execution?▼

Yes, you can discover relevant skills and agents on GitHub for task execution. The tool scans locally and on GitHub to find relevant skills and agents, consolidating them to execute tasks derived from your optimized PLAN.md file.

Related Skills

Explore More Product & Management Skills→
Nairon-AINairon-AI
7

flux-setup

Install and configure local fluxctl for repository-scoped Flux workflows.

Official
Advanced
adolfoaranaes12adolfoaranaes12
2

document-project

Generate architecture, standards, and patterns documentation from codebase analysis.

Community
Advanced
whatwecandowhatwecando

forge-execute

Execute the next wave of tasks from PLAN.md and STATE.md.

Community
Advanced
rochacbrunorochacbruno
866

marmite

Convert markdown files into complete static websites without manual configuration.

Community
Intermediate