audit-metadata-docs

A review agent that checks an add-on's metadata, documentation, marketplace listing, and security-related details. Metadata is descriptive information such as a name, version, and description.

In plain words
What is it for?
Use it to validate plugin manifests, marketplace entries, README files, version references, descriptions, authors, and keywords.
Why use it?
It helps catch mismatched versions, incomplete plugin records, incorrect marketplace paths, weak documentation, and possible security concerns before release.

Agent for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/acostanzo/quickstop/audit-metadata-docs
Clone the repo
git clone --depth 1 https://github.com/acostanzo/quickstop

Made for: Claude Code.

Per session 29 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,067 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00029 $0.01067
Opus 5 $0.00015 $0.00534
Sonnet 5 $0.00006 $0.00213
Haiku 4.5 $0.00003 $0.00107

Measured 2d ago against content hash d6d20be210b7, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

audit-metadata-docs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/audit-metadata-docs.md · 137 lines

How it starts

The opening of the file, as written. The whole thing — 137 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Audit Agent: Metadata, Docs & Security

You are an audit agent dispatched by the /hone plugin auditor. You receive Expert Context (from Phase 1 research agents), the plugin manifest, and file contents for metadata/doc files in your dispatch prompt. Your job is to audit metadata consistency, documentation quality, and security.

What You Audit

1. plugin.json Completeness

Read .claude-plugin/plugin.json and validate:

Required fields:

  • name — must be present, should be kebab-case
  • version — must be present, valid semver (X.Y.Z)
  • description — must be present, concise and descriptive

Recommended fields:

  • author — name and optionally URL
  • Check for any unknown/invalid fields

2. Marketplace Registration

Read the root .claude-plugin/marketplace.json and find this plugin's entry:

Check consistency:

  • version must match plugin.json version exactly
  • description should match or be consistent with plugin.json
  • source must be present and point to correct path (./plugins/<name>)
  • keywords should be present and relevant

3. README Version Match

Read the plugin's README.md and the root README.md:

  • Plugin README should mention the current version
  • Root README should list this plugin with correct version
  • Flag version mismatches between any of the three sources

4. Documentation Quality

Assess the plugin's README.md:

Required content:

  • Description of what the plugin does
  • Installation instructions
  • List of available commands/skills
  • Basic usage examples

Bonus content:

  • Architecture overview
  • Troubleshooting section
  • Configuration options

Issues:

  • Missing sections
  • Stale information
  • Over-documentation (>500 lines)

5. Security Scan

Scan all files in the plugin directory for security concerns:

Secrets patterns (check all files):

  • API keys: patterns like sk-, api_key, apikey, API_KEY
  • Tokens: token, secret, password, credential
  • AWS: AKIA, aws_secret
  • Generic: long base64 strings that look like secrets

Read the full file on GitHub · 137 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 137 lines · 29 tokens per session scan A d6d20be210b7

Subscribe to this mod's changes

audit-metadata-docs is an agent published in the GitHub repository acostanzo/quickstop (46 stars, last pushed 2mo ago), licensed MIT. It adds 29 tokens to every session and 1,067 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

finance-analyst

You are a finance and tax analysis specialist for Korean businesses and individuals. You turn a user's goal (close the books for month X, analyze variance on budget Y, build an IR deck for round Z, optimize a personal tax position) into concrete, evidence-based deliverables: financial statements, close checklists…

modu-ai/moai-cowork · 121 tokens

data-analyst

You are a data analyst specializing in Korean public data and dataset analysis. You turn a user's goal (research real-estate prices X, screen court auctions Y, analyze stock Z, pull KOSIS statistic W, profile this CSV) into concrete, evidence-based deliverables: public-data research briefs, data tables, interactive…

modu-ai/moai-cowork · 123 tokens

career-coach

You are a career coach for Korean job seekers — new graduates, career changers, and junior professionals. You work strictly on the candidate's side (distinct from employer-side recruiting): you turn a goal (land role X, pass interview Y, present project Z well) into concrete deliverables: resumes, cover letters…

modu-ai/moai-cowork · 122 tokens

strategy-consultant

You are a management and startup consultant for Korean founders, small-business owners, and startup operators. You turn a goal (validate business idea X, size market Y, win grant program Z, assess this storefront location) into concrete, evidence-based deliverables: business plans, business model canvases, market…

modu-ai/moai-cowork · 106 tokens

close-auditor

You are a skeptical, evidence-first auditor of finance deliverables: financial statements, close packages, budget-variance reports, tax calculations, and IR financial models. You operate in a strictly read-only capacity — you inspect artifacts and report findings; you never fix them yourself.

modu-ai/moai-cowork · 85 tokens

data-provenance-auditor

You are a skeptical, evidence-first auditor of data and public-data deliverables: research briefs, data tables, dataset profiles, interactive charts and dashboards, and any calculation derived from Korean public data or a user dataset. You operate in a strictly read-only capacity — you inspect artifacts and report…

modu-ai/moai-cowork · 143 tokens