agentleFS
linfangyu42linfangyu42/agentic-audit/SKILL.md

agentic-audit

Skill0 starsChanged 5 months agoMITView on GitHub

Multi-agent adversarial verification with automatic rewrite. When the user says "audit" or "review", launch 3 specialized verification agents in parallel (depth, bias, fact), then directly rewrite based on findings — no intermediate confirmation.

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. blamechris/chroxy★ 8same name
    2. jatinmishra/claude-skills-monorepo★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Don't show audit reports and ask "should I proceed?" — the user said "audit" to get a corrected result, not to see intermediate findings.

    line 34
  2. Distinctive:

    When two instructions/tendencies conflict:

    line 43
  3. Distinctive:

    Never present the conflict to the user ("memory says A but I think B, which do you choose?") — resolve it yourself.

    line 48
  4. Distinctive:

    Start by correcting any factual errors found

    line 70
  5. Distinctive:

    If audit reveals significant factual errors affecting the core argument, briefly inform the user before the rewrite

    line 78

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Agentic Audit

Multi-agent adversarial verification pipeline. Three independent agents examine content from orthogonal dimensions, then the host agent rewrites based on findings — delivering the corrected output directly, not the audit report.

Pipeline

Trigger word ("audit"/"review"/"审计"/"审查")
  → Launch 3 agents in parallel
    ├── verifier-depth  (completeness)
    ├── verifier-bias   (logic & reasoning)
    └── verifier-fact   (factual accuracy)
  → Host receives all 3 reports
  → Rewrite content incorporating findings
  → If ≥ 5,000 characters → generate DOCX + open
  → If < 5,000 characters → output markdown only

Key Design Rules

1. Deliver the product, not the process

Don't show audit reports and ask "should I proceed?" — the user said "audit" to get a corrected result, not to see intermediate findings. Rewrite directly. If the user wanted step-by-step, they would have asked for it.

2. External monitoring over self-monitoring

A single agent cannot reliably detect its own errors (self-correction blind spot: ~64.5% failure rate). This skill uses three independent external agents for verification. The host agent acts on their findings, not on its own self-assessment.

3. Decision heuristics over value derivation

In execution paths (when triggered), use fast pattern-matching decision heuristics. Keep the "why" in annotation position — it's for understanding off-trigger, not for reasoning during execution. This prevents motivated reasoning from converting "why" into violation rationalizations.

4. Rule conflict resolution

When two instructions/tendencies conflict:

  1. User's explicit one-step instruction > conversational default posture
  2. Product delivery obligation > process display comfort
  3. Affirmative behavioral encoding > diffuse personality tendency

Never present the conflict to the user ("memory says A but I think B, which do you choose?") — resolve it yourself.

Agent Specifications

verifier-depth

Checks for missing dimensions: genealogies, broken logic chains, unexamined root problems, alternative perspectives, key distinctions unmade.

Agent definition: agents/verifier-depth.md

verifier-bias

Checks for reasoning errors: confirmation bias, coherence traps, pseudo-certainty, sycophancy/flattery, logical jumps.

Agent definition: agents/verifier-bias.md

verifier-fact

Checks factual claims: distinguishes verified facts, inferences, uncertainties, and errors. Cites sources.

Agent definition: agents/verifier-fact.md

Output Format

The rewritten output should:

  • Start by correcting any factual errors found
  • Then present the revised analysis
  • End with a summary table of what changed from the original
  • Clearly label remaining uncertainties and irreducible failure modes

Boundaries

  • The 5,000-character threshold for DOCX generation is estimated by Chinese character count (including punctuation, excluding code blocks)
  • If audit reveals significant factual errors affecting the core argument, briefly inform the user before the rewrite
  • Audit reports are tools, not products — they don't need the user's attention unless they contain information the user MUST know before seeing the rewrite

References

  • Design principles and known limitations: references/design-principles.md
  • For implementation in Claude Code: use UserPromptSubmit hook (not Stop hook — broken for prompt type as of v2.1.81). Alternatively, use Dynamic Workflow for native parallel agent support.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.