Skill Quality Dashboard

Aggregate generated maintainer reports into a skill-quality summary. Use when reviewing docs, link, and eval health. NOT for editing report sources.

wyattowalsh fee7145 5 files · 21.9 KB Updated

File contents

Skill Quality Dashboard

Summarize maintainer ops reports for skill and docs quality gates.

Scope: Read-only aggregation of committed docs/public/generated-reports/*.json. Does not regenerate reports.

Dispatch

$ARGUMENTS Action
Empty Default dashboard summary
--format json Machine-readable aggregate
reports List registered report files and key counts

Workflow

uv run python skills/skill-quality-dashboard/scripts/aggregate_reports.py
uv run python skills/skill-quality-dashboard/scripts/aggregate_reports.py --format json

Regenerate upstream reports with the repo docs-generation pipeline — do not hand-edit JSON.

Validation Contract

uv run python skills/skill-quality-dashboard/scripts/check.py

Critical Rules

  1. Treat generated report JSON as evidence, not authority to bypass validate gates.
  2. Never hand-edit docs/public/generated-reports/*.json.
  3. Pair dashboard output with skill-lifecycle-manager for per-skill readiness.
  4. Route broken-link remediation to docs-steward.
  5. Do not claim reports are fresh without checking generation timestamps when present.

wyattowalsh/agents/tree/main/skills/skill-quality-dashboard commit fee7145e27

Frequently asked questions

npx skillmds@latest add wyattowalsh/skill-quality-dashboard