optimus-report

Parse optimus-tasks.md and state.json to generate a project status dashboard.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/alexgarzao/optimus --skill optimus-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimus-report
Source: https://github.com/alexgarzao/optimus/tree/main/report/skills/optimus-report
Command: npx skills add https://github.com/alexgarzao/optimus --skill optimus-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a read-only project status dashboard by parsing the repository's optimus-tasks.md and state.json, enabling teams to see progress, priorities, dependencies, and bottlenecks at a glance without modifying source data.

Core Features & Use Cases

  • Read and categorize tasks into Done, Active, Ready to Start, and Blocked.
  • Build dependency graphs and show parallelization opportunities to optimize work sequencing.
  • Display version progress and velocity metrics derived from state.json for forecasting and planning.
  • Generate ASCII and JSON dashboards and optional reports when users opt in.

Quick Start

Run optimus-report to generate the current project status dashboard for your project.

Frequently Asked Questions about optimus-report

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

FAQPage Schema
How do I generate a project status dashboard from markdown tasks?

Generate a project status dashboard by parsing optimus-tasks.md and state.json to categorize tasks into Done, Active, Ready, and Blocked states. The dashboard visualizes progress, dependencies, and velocity metrics without modifying source data.

Can I visualize task dependencies and find parallelization opportunities?

Visualize task dependencies by building a dependency graph from parsed task data to show parallelization opportunities. This helps optimize work sequencing by identifying ready tasks and highlighting blocked work.

Does the project status dashboard modify my source files?

The project status dashboard enforces read-only behavior and never modifies source data. It only writes optional ASCII and JSON reports when users explicitly opt in to generate them.

How do I track version progress and velocity metrics for forecasting?

Track version progress and velocity metrics by deriving data from state.json. The dashboard calculates velocity to enable forecasting and planning based on completed and active task rates.

What is the best way to identify blocked tasks in a project?

Identify blocked tasks by parsing optimus-tasks.md to filter and classify tasks by dependency and progress. The dashboard highlights blocked work alongside ready and active tasks for bottleneck visibility.

How do I output project reports in JSON format?

Output project reports in JSON format by opting in to optional report generation. The dashboard generates both ASCII and JSON formats displaying task status, dependency graphs, and velocity data.