sig-audit

Measures Fallow maintainability using SIG system properties and updates the evidence-backed audit report.

4.4k|154|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/fallow-rs/fallow --skill sig-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sig-audit
Source: https://github.com/fallow-rs/fallow/tree/main/.agents/skills/sig-audit
Command: npx skills add https://github.com/fallow-rs/fallow --skill sig-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintaining an accurate, evidence-backed maintainability audit for the Fallow repository is difficult when metrics are estimated, stale, or measured inconsistently across revisions. This Skill enforces a disciplined measurement workflow so every claim in the audit report is backed by current, reproducible evidence.

Core Features & Use Cases

  • Repeatable SIG property measurement: Runs every supported SIG system property measurement on the same repository revision for consistent results.
  • Revision-to-revision comparison: Compares current scores against the previous revision using identical settings to detect regressions or improvements.
  • Evidence-backed report updates: Records commands, raw evidence locations, and limitations, updating only claims supported by actual measurements.
  • Use Case: Before a Fallow release, run the audit to refresh the maintainability report with verified scores, then verify any changed audit tooling or documentation.

Quick Start

Run the SIG audit to measure all supported maintainability properties on the current revision and update the audit report with evidence-backed scores.

Frequently Asked Questions about sig-audit

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

FAQPage Schema
How do I run a SIG maintainability audit on the Fallow repository?

Read the existing audit and measurement scripts, then run every supported SIG property measurement on the same revision. Record the commands, evidence locations, and scores, and update the audit report only with measured results.

How do I compare maintainability scores between two revisions?

Measure all supported SIG properties on the current revision using settings identical to the previous measurement. Then compare the new scores against the recorded previous revision scores to identify regressions or improvements.

Can I estimate missing SIG metrics in the audit report?

No. The audit explicitly forbids estimating missing metrics or presenting a proxy as a measured result. Only claims supported by current, actual measurements may appear in the report.

What should I record when updating the audit report?

Record the exact commands run, the locations of raw evidence, known limitations of the measurements, and the current scores. This keeps every claim in the report traceable to reproducible evidence.

What happens if I change audit tooling or documentation?

Run the repository's verification process for any changed audit tooling or docs. This ensures the measurement workflow and its documentation remain consistent and correct after modifications.