Project Audit
When NOT to Use
- Security-specific review (use
/codex-security)
- Runtime performance profiling
- Mid-development review (use
/codex-review-fast)
Procedure
- Run
bash scripts/run-skill.sh project-audit audit.js --json to collect deterministic scores
- Parse the JSON output — overall_score, status, dimensions, checks, findings, next_actions
- If status = Blocked (P0 findings) — highlight critical gaps, suggest immediate fixes
- If status = Needs Work (P1 findings) — format improvement roadmap by dimension
- If status = Healthy — summarize strengths, note any P2 improvements
- Add qualitative interpretation beyond the scores (e.g., "test ratio is good but concentrated in unit tests")
Script Integration
The audit script runs 12 deterministic checks across 5 dimensions:
| Dimension |
Checks |
What It Measures |
| oss |
2 |
LICENSE, README quality |
| robustness |
3 |
CI config, lint/typecheck, test ratio |
| scope |
2 |
Declared features vs implementation, AC completion |
| runnability |
3 |
Package manifest, scripts, env/Docker setup |
| stability |
2 |
Lock file + audit, type configuration |
Scoring Model
- Each check:
1 (pass) / 0.5 (partial) / 0 (fail) / N/A (skipped)
- Dimension score:
applicable_sum / applicable_count * 100
- Overall score: average of dimension scores
- Confidence:
applicable_checks / total_checks per dimension
Status Determination
| Status |
Condition |
Exit Code |
| Blocked |
Any P0 finding |
2 |
| Needs Work |
No P0, has P1 |
1 |
| Healthy |
No P0/P1 |
0 |
Script Failure Fallback
If the script fails, report the error and suggest running manually:
bash scripts/run-skill.sh project-audit audit.js --json
Output Format
## Project Audit Report
| Field | Value |
|-------|-------|
| Repo | [name] |
| Score | **[N]/100** |
| Status | [icon] [status] |
### Dimensions
[table of dimension scores]
### Checks
[list of check results with suggestions]
### Next Actions
[prioritized action items]
## Gate: ✅/⛔
References
references/check-catalog.md — Check definitions, scoring criteria, ecosystem detection (read when investigating a specific check result)
references/output-template.md — Report format examples and JSON schema (read when customizing output)
Verification
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: sd0xdev-sd0x-dev-flow-project-audit3description: Project Audit4---56# Project Audit78## When NOT to Use910- Security-specific review (use `/codex-security`)11- Runtime performance profiling12- Mid-development review (use `/codex-review-fast`)1314## Procedure15161. Run `bash scripts/run-skill.sh project-audit audit.js --json` to collect deterministic scores172. Parse the JSON output — overall_score, status, dimensions, checks, findings, next_actions183. **If status = Blocked** (P0 findings) — highlight critical gaps, suggest immediate fixes194. **If status = Needs Work** (P1 findings) — format improvement roadmap by dimension205. **If status = Healthy** — summarize strengths, note any P2 improvements216. Add qualitative interpretation beyond the scores (e.g., "test ratio is good but concentrated in unit tests")2223## Script Integration2425The audit script runs 12 deterministic checks across 5 dimensions:2627| Dimension | Checks | What It Measures |28|-----------|--------|-----------------|29| oss | 2 | LICENSE, README quality |30| robustness | 3 | CI config, lint/typecheck, test ratio |31| scope | 2 | Declared features vs implementation, AC completion |32| runnability | 3 | Package manifest, scripts, env/Docker setup |33| stability | 2 | Lock file + audit, type configuration |3435### Scoring Model3637- Each check: `1` (pass) / `0.5` (partial) / `0` (fail) / `N/A` (skipped)38- Dimension score: `applicable_sum / applicable_count * 100`39- Overall score: average of dimension scores40- Confidence: `applicable_checks / total_checks` per dimension4142### Status Determination4344| Status | Condition | Exit Code |45|--------|-----------|-----------|46| Blocked | Any P0 finding | 2 |47| Needs Work | No P0, has P1 | 1 |48| Healthy | No P0/P1 | 0 |4950### Script Failure Fallback5152If the script fails, report the error and suggest running manually:5354```bash55bash scripts/run-skill.sh project-audit audit.js --json56```5758## Output Format5960```61## Project Audit Report6263| Field | Value |64|-------|-------|65| Repo | [name] |66| Score | **[N]/100** |67| Status | [icon] [status] |6869### Dimensions70[table of dimension scores]7172### Checks73[list of check results with suggestions]7475### Next Actions76[prioritized action items]7778## Gate: ✅/⛔79```8081## References8283- `references/check-catalog.md` — Check definitions, scoring criteria, ecosystem detection (read when investigating a specific check result)84- `references/output-template.md` — Report format examples and JSON schema (read when customizing output)8586## Verification8788- [ ] Script ran successfully89- [ ] All 12 checks executed (or marked N/A with reason)90- [ ] Qualitative interpretation added beyond raw scores91- [ ] Next actions are actionable (include commands where applicable)9293---94> Converted and distributed by [TomeVault](https://tomevault.io/claim/sd0xdev) — claim your Tome and manage your conversions.95<!-- tomevault:4.0:skill_md:2026-04-11 -->