analyze-cycle

Analyzes completed work cycles and proposes evidence-backed edits to the skills that ran them.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/muselesscreator/ui-skills --skill analyze-cycle-muselesscreator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze-cycle
Source: https://github.com/muselesscreator/ui-skills/tree/main/analyze-cycle
Command: npx skills add https://github.com/muselesscreator/ui-skills --skill analyze-cycle-muselesscreator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an automated work cycle finishes, it is hard to tell where money was wasted, which steps looped or failed, and what work leaked out into manual fix-sessions. This Skill performs a structured post-mortem on a completed cycle and turns the findings into concrete, evidence-backed proposals for improving the skills and cycle definitions that caused each problem. ## Core Features & Use Cases - Deterministic forensics: Runs cycle-forensics.py to extract the step ledger, attempt tables, cost rollups, session maps, rework records, and mechanical flags without spending model tokens on re-derivation. - Leak detection: Identifies out-of-cycle fix-sessions, live rework, and uncommitted changes that reveal what the cycle failed to deliver, with correct attribution to the current or previous cycle. - Parallel investigation: Fans out up to 6 subagent investigations that read step transcripts by path and return root causes classified as skill-defect, cycle-definition, environmental, or human-choice. - Gated proposals: Produces a ranked proposal artifact (max 8) with quoted evidence and exact edits, applying changes only after explicit approval. - Use Case: After a cycle cost $32 and you hand-fixed the loading bar twice, run the retro to discover which step should have owned that work and get a minimal edit proposal for the responsible skill. ## Quick Start Ask the AI to analyze the latest cycle and propose skill improvements based on what went wrong.

Frequently Asked Questions about analyze-cycle

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

FAQPage Schema
How do I analyze why a work cycle cost so much?

Run the analyze-cycle skill with the cycle id or 'latest', optionally with a 'cost' focus. It generates a deterministic forensics report with per-step cost rollups and attempt tables, then investigates cost outliers and cache-read hotspots to propose fixes such as model-tier changes.

How to find what a cycle missed or leaked into manual fixes?

The skill maps all sessions on the branch, including unlinked fix-sessions and still-active ones, attributing each to the current or previous cycle. Live rework and intra-cycle rework records show exactly which step should have covered the work the human did by hand.

What is retro mode in cycle analysis?

Retro mode runs when the skill is invoked as a cycle's own final step, analyzing the still-running cycle. It never raises decision memos, never reports BLOCKED, always reports PASS, and skips the proposal-application gate entirely.

Does analyze-cycle apply skill edits automatically?

No. It proposes edits by default and applies them only after explicit approval of named proposals. In isolated runs without user interaction, it raises a decision memo and reports BLOCKED instead of editing anything.

Why does the analysis report no cost findings for some cycles?

In-session /orch-ui runlogs contain no cost data, only cycle-runner directories carry real USD figures. When the forensics report indicates no cost data, the skill explicitly makes no cost findings rather than estimating prices.

How does it distinguish systemic problems from one-off failures?

It checks per-skill aggregates across up to 12 previous cycles using the history subcommand. High mean attempts or non-pass slots across other cycles mark a finding as systemic; isolated incidents become watch-items unless the fix is cheap and safe.