agent-work-auditor

Unified auditing skill for AI agent workflows. Provides change-type-aware, artifact-adaptive auditing with self-fix capabilities. Works standalone or with spec-driven extensions. Three-layer architecture: core (always active), modules (per-type), extensions (auto-detected).

Jump to install

Repository: lindoelio/spec-driven-steroids
Last source activity: August 7, 2026 at 11:12
Detected SKILL.md language: English
Stars: 54
Forks: 3

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Back to search Back to installation

name	agent-work-auditor
description	Unified auditing skill for AI agent workflows. Provides change-type-aware, artifact-adaptive auditing with self-fix capabilities. Works standalone or with spec-driven extensions. Three-layer architecture: core (always active), modules (per-type), extensions (auto-detected).

agent-work-auditor

A unified, modular auditing framework for AI agent workflows. Provides adversarial audits designed to find gaps and block premature approval. Every audit must switch the agent from author mode to critic mode and force specific, named weaknesses to be surfaced.

Activation

Load this skill when:

User asks to audit code, a PR, or a change set
Spec-driven Code Review requires auditing
User mentions "are you sure?" after producing work
User wants verification of completeness or correctness

Three-Layer Architecture

Layer 1: Core (Always Active)

Universal dimensions evaluated for every audit:

Dimension	Question	Auto-Fix
Completeness	Is everything present?	Yes
Correctness	Is it right?	Yes
Consistency	Does it fit patterns?	Yes
Traceability	Can we trace it?	Partial
Safety	Could it cause harm?	No
Maintainability	Will future devs thank us?	Partial
Rigorous Against Prompt/Spec	Does it match the original intent?	Partial

Layer 2: Change-Type Modules (Per-Invocation)

Loaded based on detected change type:

Type	Posture	Focus
feat	Thorough	Design, scalability
fix	Focused	Bug repro, verification
hotfix	Compressed	Scope min, correctness
refactor	Rigorous	Behavioral parity
migrate	Cautious	Backward compat, schema
docs	Lightweight	Accuracy

Parameter	Required	Default	Description
`artifact`	Yes	—	Path(s) to audit
`changeType`	No	auto-detect	feat, fix, hotfix, refactor, migrate, docs, general
`mode`	No	standard	quick, standard, thorough
`extensions`	No	auto	Array of extension names

# Explicit type
"Audit this PR using agent-work-auditor, type:feat"

# Quick check
"Quick audit on these changes"

# Spec-driven (auto-loads spec-driven extension)
"Validate the spec implementation"

# Combined types
"Audit this refactor+fix"

1. DETECT change type
   └─ Explicit tag → Branch scan → Commit scan → Heuristic → Fallback

2. DETECT artifact type
   └─ code | specification | design | tasks | mixed

3. GATHER context
   └─ Style guide, conventions, project docs

4. ACTIVATE layers
   └─ Core (always) → Type module → Extensions (if detected)

5. EVALUATE dimensions
   └─ Universal (7) → Type-specific → Extension-specific

6. CLASSIFY findings
   └─ Severity (blocking, warning, info)
   └─ Fixability (direct-fix, author-required, informational)

7. SELF-FIX LOOP
   └─ Pass 1: Apply direct-fix → Re-review
   └─ Pass 2: Apply direct-fix → Re-review
   └─ Escalate remaining to author-required

8. OUTPUT
   └─ Markdown report + JSON (machine consumption)

# Audit Report — {change-type}

**Artifact:** {path}
**Timestamp:** {ISO-8601}
**Verdict:** Approve | Request Changes | Approval with Notes

## Summary
{2-3 sentence assessment}

## Direct Fixes Applied
| Finding | Fix Applied | Status |
|---------|-------------|--------|
| ... | ... | fixed |

## Blocking Findings
| Finding | Decision Needed | Status |
|---------|---------------|--------|
| ... | ... | pending |

## Nit Findings
| Finding | Suggestion | Status |
|---------|------------|--------|
| ... | ... | fixed |

## Traceability Matrix (spec-driven only)
| REQ | DES | TASK | Coverage |
|-----|-----|------|----------|

{
  "artifact": "{path}",
  "changeType": "{type}",
  "timestamp": "{ISO-8601}",
  "verdict": "Approve | Request Changes | Approval with Notes",
  "dimensions": {
    "{dimension}": {
      "score": 1-5,
      "findings": []
    }
  },
  "findings": [
    {
      "severity": "blocking | warning | info",
      "fixability": "direct-fix | author-required | informational",
      "title": "...",
      "description": "...",
      "fix": "...",
      "status": "fixed | pending | escalated"
    }
  ],
  "summary": "..."
}

File	When
`dimensions/*.md`	During dimension evaluation
`modules/{type}.md`	After type detection
`extensions/spec-driven.md`	When `.specs/` detected
`references/migration/*`	When migrate type detected
`references/finding-severity.md`	During finding classification
`references/output-format.md`	During output generation