manage-runs

Scan pipeline run directories and parse pipeline_state.json for summaries.

21|11|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/ai-analyst-lab/ai-analyst-plugin --skill manage-runs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-runs
Source: https://github.com/ai-analyst-lab/ai-analyst-plugin/tree/main/skills/manage-runs
Command: npx skills add https://github.com/ai-analyst-lab/ai-analyst-plugin --skill manage-runs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Browse, inspect, compare, and clean up past pipeline runs. Each run is a self-contained directory under working/runs with its own working files, outputs, and pipeline state.

Core Features & Use Cases

  • Scan run directories under working/runs and extract pipeline_state.json fields for quick summaries.
  • View details of a specific run, compare two runs side-by-side, and see agent progress and timing.
  • Clean up runs older than 30 days with user confirmation and view output artifacts and validation confidence when available.
  • Handle edge cases such as missing pipeline_state.json, unknown statuses, or legacy formats with graceful messaging.

Quick Start

Ask to list runs, view details, or compare two runs to get immediate insights.

Frequently Asked Questions about manage-runs

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

FAQPage Schema
How do I inspect past pipeline runs to check status and timing?

To inspect pipeline runs, scan run directories under working/runs and parse pipeline_state.json to extract per-run status, timing, and agent counts for quick debugging summaries.

Can I compare two pipeline runs side-by-side to debug optimization issues?

Yes, you can compare two pipeline runs side-by-side to view differences in agent progress, timing, and outputs, which directly supports identifying bottlenecks and optimization opportunities.

What is the best way to clean up old pipeline run directories?

The best way to clean up old pipeline runs is to scan the working/runs directory and remove run folders older than 30 days, with user confirmation, while preserving recent outputs and state files.

How does pipeline run scanning handle missing or corrupted pipeline state files?

Pipeline run scanning handles missing or corrupted pipeline_state.json files by applying edge-case logic that delivers graceful messaging instead of failing, ensuring legacy formats and unknown statuses are reported clearly.

Do I need a specific directory structure to browse pipeline run artifacts?

You need self-contained run directories named by date or dataset under working/runs, each containing its own working files, outputs, and pipeline_state.json, to successfully browse and extract run artifacts.

What does a pipeline run summary include when viewing run details?

A pipeline run summary includes extracted pipeline_state.json fields such as per-run status, timing data, agent counts, output artifacts, and validation confidence metrics when available.