scope-audit
Installation
SKILL.md
Scope Audit
Systematically examine any agency scope document — RFP, SOW, brief, retainer, proposal, or informal client ask — to surface hidden work, missing assumptions, delivery risks, unpriced obligations, and change-order opportunities before the agency commits resources.
Quick Reference
| Resource | Purpose | Usage |
|---|---|---|
scripts/scope_audit_engine.py |
Core audit engine — regex-based ambiguous language detection, missing item checks, implicit scope inference, risk scoring, verdict generation | python scope_audit_engine.py --input scope.txt --client "AcmeAuto MX" --output audit.json |
references/risk_scoring.md |
Risk scoring framework — severity scale, heat score formula, verdict matrix, industry benchmarks | Read when you need scoring definitions or to validate risk band thresholds |
references/ambiguous_patterns.md |
Comprehensive catalog of contractual red flags with regex patterns, examples, and safe replacement language | Read when you need to explain a specific pattern to the user or suggest contract rewording |
How to Use the Script
When the user provides a scope document (pasted text, uploaded file, or excerpt), run the audit engine first to get quantitative results, then layer your qualitative analysis on top: