scorecard

Measure and reduce technical debt across repository surfaces with deterministic scoring.

30|12|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/anthony-chaudhary/fak --skill scorecard-anthony-chaudhary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scorecard
Source: https://github.com/anthony-chaudhary/fak/tree/main/.claude/skills/scorecard
Command: npx skills add https://github.com/anthony-chaudhary/fak --skill scorecard-anthony-chaudhary

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of subjective or unverified quality metrics by providing a deterministic, ungameable framework to measure and reduce technical debt across various repository surfaces.

Core Features & Use Cases

  • Deterministic Measurement: Uses a shared doctrine to turn qualitative surface health into a single, re-derivable integer debt score.
  • Cross-Checked Validation: Ensures scores are tied to reality by verifying claims against the actual git-tracked tree, preventing gaming of the metrics.
  • Repeatable RSI Loops: Provides a standardized five-step loop for running scorecards, retiring debt worst-first, and proving improvements through before-and-after comparisons.

Quick Start

Run the scorecard control pane from the repository root to generate a full portfolio report of all measured surfaces and their current debt levels.

Frequently Asked Questions about scorecard

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

FAQPage Schema
How do I measure technical debt across my repository surfaces?

You measure technical debt by running a standardized scoring loop that cross-checks claims against the actual git-tracked tree. This deterministic process converts qualitative surface health into a single, re-derivable integer debt score.

What is the best way to automate quality assurance metrics for repository hygiene?

The best way to automate quality assurance metrics is using a repeatable RSI scoring loop that retires debt worst-first. This loop validates claims against the git-tracked tree, preventing gaming of the metrics.

How do I run a scorecard to generate a full portfolio report of measured surfaces?

Run the control pane from the repository root to generate a full portfolio report. This executes the standardized five-step loop, measuring all surfaces and displaying their current debt levels.

Can I use deterministic scoring loops to reduce technical debt across diverse repositories?

Yes, you can use repeatable RSI loops to reduce technical debt across diverse repositories. The framework enables retiring debt worst-first and proves improvements through deterministic before-and-after comparisons.

Why does my quality assurance framework produce gameable metrics?

Metrics become gameable when scores are not tied to reality. This framework prevents gaming by cross-checking validation, verifying all surface health claims directly against the actual git-tracked tree.