HomeBrowseUpload
← Back to registry
// Skill profile

GitHub Actions Artifact Budget Audit

name: github-actions-artifact-budget-audit

by daniellummis · published 2026-03-22

开发工具数据处理
Total installs
0
Stars
★ 0
Last updated
2026-03
// Install command
$ claw add gh:daniellummis/daniellummis-github-actions-artifact-budget-audit
View on GitHub
// Full documentation

---

name: github-actions-artifact-budget-audit

description: Audit GitHub Actions artifact storage usage from JSON exports so bloated artifacts are flagged before they inflate CI cost.

version: 1.0.0

metadata: {"openclaw":{"requires":{"bins":["bash","python3"]}}}

---

# GitHub Actions Artifact Budget Audit

Use this skill to detect oversized or stale GitHub Actions artifacts across repositories.

What this skill does

  • Reads one or more GitHub artifact JSON exports (`gh api` output)
  • Calculates artifact size in MB and totals by repository + artifact name
  • Flags warn/critical artifacts by configurable size thresholds
  • Highlights soon-to-expire artifact volume to prioritize cleanup
  • Supports text and JSON output for terminal or dashboards
  • Inputs

    Optional:

  • `ARTIFACT_GLOB` (default: `artifacts/github-actions-artifacts/*.json`)
  • `TOP_N` (default: `20`)
  • `OUTPUT_FORMAT` (`text` or `json`, default: `text`)
  • `WARN_MB` (default: `250`)
  • `CRITICAL_MB` (default: `750`)
  • `SOON_EXPIRES_DAYS` (default: `7`)
  • `FAIL_ON_CRITICAL` (`0` or `1`, default: `0`)
  • `REPO_MATCH` (regex, optional)
  • `REPO_EXCLUDE` (regex, optional)
  • `ARTIFACT_MATCH` (regex, optional)
  • `ARTIFACT_EXCLUDE` (regex, optional)
  • Collect artifact JSON

    Single repository:

    gh api repos/<owner>/<repo>/actions/artifacts --paginate \
      > artifacts/github-actions-artifacts/<owner>-<repo>.json

    Combined multi-repo payloads are also supported as long as each file includes an `artifacts` array.

    Run

    Text report:

    ARTIFACT_GLOB='artifacts/github-actions-artifacts/*.json' \
    WARN_MB=300 \
    CRITICAL_MB=900 \
    bash skills/github-actions-artifact-budget-audit/scripts/artifact-budget-audit.sh

    JSON output for automation:

    ARTIFACT_GLOB='artifacts/github-actions-artifacts/*.json' \
    OUTPUT_FORMAT=json \
    FAIL_ON_CRITICAL=1 \
    bash skills/github-actions-artifact-budget-audit/scripts/artifact-budget-audit.sh

    Filter to one repo and artifact family:

    ARTIFACT_GLOB='artifacts/github-actions-artifacts/*.json' \
    REPO_MATCH='^flowcreatebot/' \
    ARTIFACT_MATCH='(test-results|coverage)' \
    bash skills/github-actions-artifact-budget-audit/scripts/artifact-budget-audit.sh

    Run with bundled fixtures:

    ARTIFACT_GLOB='skills/github-actions-artifact-budget-audit/fixtures/*.json' \
    bash skills/github-actions-artifact-budget-audit/scripts/artifact-budget-audit.sh

    Output contract

  • Exit `0` in reporting mode (default)
  • Exit `1` if `FAIL_ON_CRITICAL=1` and at least one artifact is at/above `CRITICAL_MB`
  • In `text` mode: prints summary and top oversized artifact groups
  • In `json` mode: prints summary, grouped artifact stats, and critical artifact instances
  • // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band