agent definition auditor

Security Community

Skill notes

When to use

The user wants to audit or score an AGENTS.md, CLAUDE.md, SKILL.md, SOUL.md, .cursorrules, system prompt, or other agent-definition markdown. The user wants a cold-reader review of agent-contract quality. The user wants a deploy / revise / do-not-ship judgment with concrete findings and fastest improvements. The user wants a reusable rubric-based critique of an agent instruction file rather than an output benchmark.

When not to use

The user wants to write, rewrite, or refactor the agent file rather than score it. The user wants to evaluate agent outputs, benchmark runtime behavior, or compare model responses rather than audit the instruction artifact itself. The job is code review, product-doc review, or general technical writing feedback unrelated to an agent-definition file. No target artifact or pasted instruction text is available.

Non-negotiables

Default to a single-artifact, read-only cold read. Judge the document as an operational contract, not as domain strategy or business policy. Distinguish precise layered contracts from phantom context. Apply the scoring model, hard caps, and report shape from the reference prompt literally. Cite line numbers when available; otherwise cite exact headings or short anchors.

First move

Resolve one target artifact path or pasted instruction text. Read references/agent-definition-judge-prompt.md. Read the full target artifact once before scoring. If the user also wants revisions, finish the audit first unless they explicitly want authoring instead of judging.

Workflow

Confirm the artifact class and whether the input is a full file or an excerpt. Stay on the single document by default. Inventory the artifact's hard rules: mission and scope output rules

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Security
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@tomevault-io · no license declared
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# Agent Definition Auditor

Use this skill when the job is auditing one agent-definition file, not rewriting it.

## When to use

- The user wants to audit or score an `AGENTS.md`, `CLAUDE.md`, `SKILL.md`, `SOUL.md`, `.cursorrules`, system prompt, or other agent-definition markdown.
- The user wants a cold-reader review of agent-contract quality.
- The user wants a deploy / revise / do-not-ship judgment with concrete findings and fastest improvements.
- The user wants a reusable rubric-based critique of an agent instruction file rather than an output benchmark.

## When not to use

- The user wants to write, rewrite, or refactor the agent file rather than score it.
- The user wants to evaluate agent outputs, benchmark runtime behavior, or compare model responses rather than audit the instruction artifact itself.
- The job is code review, product-doc review, or general technical writing feedback unrelated to an agent-definition file.
- No target artifact or pasted instruction text is available.

## Non-negotiables

- Default to a single-artifact, read-only cold read.
- Judge the document as an operational contract, not as domain strategy or business policy.
- Distinguish precise layered contracts from phantom context.
- Apply the scoring model, hard caps, and report shape from the reference prompt literally.
- Cite line numbers when available; otherwise cite exact headings or short anchors.
- Do not widen to repo-wide inspection unless the user explicitly asks for multi-file or repo-context evaluation.
- Do not rewrite the file unless the user explicitly asks for fixes after the audit.

## First move

1. Resolve one target artifact path or pasted instruction text.
2. Read `references/agent-definition-judge-prompt.md`.
3. Read the full target artifact once before scoring.
4. If the user also wants revisions, finish the audit first unless they explicitly want authoring instead of judging.

## Workflow

1. Confirm the artifact class and whether the input is a full file or an excerpt.
2. Stay on the single document by default.
3. Inventory the artifact's hard rules:
   - mission and scope
   - output rules
   - tool rules
   - approval and escalation rules
   - failure handling
   - external dependencies
4. Apply the reference prompt's scoring model and hard caps.
5. Return the exact report sections required by the reference prompt.
6. If the user then wants fixes, use the audit as the basis for the follow-up instead of recomputing the diagnosis from scratch.

## Output expectations

- Return the exact top-level sections from the reference prompt.
- Include overall and uncapped score, verdict, confidence, cap logic, findings, strengths, fastest score gains, and limits.
- Keep findings ordered by severity and tied to concrete evidence from the artifact.

## Reference map

- `references/agent-definition-judge-prompt.md` - full judging prompt, scoring model, hard caps, report contract, and examples

---
> Source: [aelaguiz/arch_skill](https://github.com/aelaguiz/arch_skill) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.