automation-audit-ops

Audit repository automations and classify them as live, broken, or redundant.

Updated Jan 6, 2023
One-click install
npx skills add https://github.com/pekral/phpstan-rules --skill automation-audit-ops-pekral
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: automation-audit-ops
Source: https://github.com/pekral/phpstan-rules/tree/main/.claude/skills/automation-audit-ops
Command: npx skills add https://github.com/pekral/phpstan-rules --skill automation-audit-ops-pekral

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive, evidence-first inventory of all automation surfaces in a repository, helping teams identify broken, redundant, or stale workflows before making changes.

Core Features & Use Cases

  • Surface Enumeration: Automatically catalogs GitHub Actions, Claude Code hooks, MCP servers, and Composer scripts.
  • State Classification: Evaluates the health of each automation as live, broken, or unverified based on concrete proof like run logs or command outputs.
  • Strategic Recommendations: Generates a clear keep/merge/cut/fix report to optimize project maintenance and eliminate technical debt.

Quick Start

Run the automation audit ops skill to generate a full inventory and health report for all project automations.

Frequently Asked Questions about automation-audit-ops

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

FAQPage Schema
How do I audit GitHub Actions workflows to find broken or redundant automations?

To audit GitHub Actions workflows, you perform a read-only inventory that traces run logs and configuration files to classify each automation as live, broken, or redundant. This generates a keep, merge, or cut report for project stability.

What is the best way to inventory all repository automation surfaces like hooks and build scripts?

The best way to inventory repository automation surfaces is to enumerate GitHub Actions, configuration hooks, and build scripts, then evaluate their operational status against concrete proof like run logs. This identifies stale workflows before changes.

How does evidence-based state classification for CI/CD pipelines work?

Evidence-based state classification works by tracing concrete proof from execution logs and command outputs to evaluate the health of CI/CD components. Automations are classified as live, broken, or unverified based on this traced evidence.

Can I use a read-only audit to identify stale Composer scripts and MCP servers?

Yes, a read-only audit can identify stale Composer scripts and MCP servers by cataloging these configuration surfaces and evaluating their health. It checks operational status through command outputs to classify them as live or redundant.

Does this automation audit require write access to my repository configuration files?

No, this automation audit does not require write access because it performs a comprehensive, read-only evaluation of your repository configuration files and logs. It simply traces evidence to provide actionable recommendations.

Why are my GitHub Actions workflows classified as unverified during an audit?

GitHub Actions workflows are classified as unverified during an audit when there is no concrete proof of their operational status in run logs or command outputs. This classification indicates a lack of evidence for live or broken states.