repository-quality-score

Aggregates completed audit findings into a deterministic repository quality score with coverage metrics.

3|5|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill repository-quality-score-bensheridanedwards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repository-quality-score
Source: https://github.com/BenSheridanEdwards/ArchitectPlaybook/tree/main/repository-quality-score
Command: npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill repository-quality-score-bensheridanedwards

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? After running multiple codebase audits, teams lack a single explainable number that summarizes repository health. This Skill converts completed Architect Playbook audit findings into one deterministic Repository Quality Score with category breakdowns, coverage metrics, and an explanation of every deduction or exclusion. ## Core Features & Use Cases - Deterministic scoring: A bundled Python calculator owns all numeric decisions using a versioned score-policy.json, so identical inputs always produce identical scores. - Multi-worktree discovery: Finds audit reports across the current directory and every registered Git worktree, excluding results from other commits. - Status classification: Labels results as official, provisional, or unavailable based on evidence completeness, and never invents a score when audits are missing. - Use Case: After running security, testing, and performance audits in parallel with --worktree, run this Skill to produce score.md and score.json showing an overall score, per-category scores, and which missing audits reduce coverage. ## Quick Start Ask the assistant to calculate the repository quality score from the completed audit findings and show which categories lowered it.

Frequently Asked Questions about repository-quality-score

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

FAQPage Schema
How do I calculate a repository quality score from audit results?

Run the /repository-quality-score command after audits finish. The skill discovers findings in the current and registered Git worktrees, validates them against the score policy, and invokes the bundled Python calculator to produce score.md, score.json, snapshot.md, and metadata.json.

What happens if some audits are missing when calculating the score?

Missing audits reduce coverage rather than counting as zero scores. The result is labeled provisional, the missing audits are listed by name, and the report explains exactly which evidence is absent so you can rerun those audits.

Can the score combine audit results from different Git commits?

No. The calculator selects one atomic current-commit result per audit and never merges checks from separate runs or different commits. Results targeting another commit are excluded and those audits must be rerun on the current commit.

Does the repository quality score work with older audit file formats?

Legacy findings using check, gate, or id fields are mapped only through exact unique identifier matches. Ambiguous or unknown identifiers are excluded and reported, and any legacy-derived score is always provisional, never official.

Why is my repository quality score marked provisional instead of official?

A score is provisional when official conditions are unmet, such as filtered runs, threshold or policy overrides, degraded evidence, skipped checks, a dirty source tree at audit time, or missing audits. The statusReasons field lists the exact cause codes.

What are the limitations of the repository quality score?

The skill never runs or reruns audits, never inspects source code to fill gaps, and never adjusts weights or bands by judgment. It does not claim security or regulatory certification and does not replace the detailed audit reports or human review.