prune-workflows

Cancel stale non-terminal workflows with dry-run previews and safeguard checks.

33|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/lvlup-sw/exarchos --skill prune-workflows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prune-workflows
Source: https://github.com/lvlup-sw/exarchos/tree/main/skills-src/prune-workflows
Command: npx skills add https://github.com/lvlup-sw/exarchos --skill prune-workflows

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Bulk-catch stale, non-terminal workflows by performing a controlled cancel with an interactive dry-run preview and safeguards, so teams can clean pipelines without accidental data loss or disruption.

Core Features & Use Cases

  • Dry-run previews of candidates with staleness and safeguard checks
  • Interactive confirmation to proceed, abort, or force prune
  • Emission of workflow.pruned audit events to distinguish batch cleanups from manual cancels Use cases include eliminating aging workflows in CI pipelines, cleaning up abandoned experiments, and maintaining a clean history of cancelled items.

Quick Start

Initiate a prune of stale non-terminal workflows by performing a dry-run preview, showing safeguards, and then executing the prune after user confirmation.

Frequently Asked Questions about prune-workflows

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

FAQPage Schema
How do I safely clean up stale workflows in a CI pipeline without losing data?

You can clean up stale workflows by using a controlled cancel operation with a dry-run preview. This approach shows aging candidates and runs safeguard checks before executing the batch cancellation, preventing accidental data loss or disruption.

What happens if a stale workflow has an open PR or recent commits?

Safeguards for open PRs and recent commits automatically detect these conditions during the preview. You can choose to abort the prune, or bypass these safeguards using a force option to proceed with the cancellation.

Can I preview which non-terminal workflows will be cancelled before executing?

Yes, you can run a dry-run preview to list stale non-terminal workflows. This interactive preview displays staleness metrics and safeguard statuses, allowing you to confirm, abort, or force prune the candidates.

How do I audit batch cancellations of abandoned pipeline workflows?

You can audit batch cancellations by emitting workflow.pruned events. These audit trail events distinguish automated batch cleanups from manual cancels, maintaining a clean history of cancelled items.

Are there limitations when pruning non-terminal workflows in pipelines?

Pruning is limited to non-terminal workflows and relies on safeguards like hasOpenPR and hasRecentCommits. You must use the force option to bypass these safeguards, which risks cancelling active work if applied incorrectly.