metadata-agent

metadata-agent is an agent for Claude Code from davepoon/buildwithclaude. It costs 31 tokens per session (308 once invoked), scanned A, original, MIT.

An agent for adding and standardizing frontmatter in a knowledge vault's Markdown files. Frontmatter is the metadata block at the top of a file; this agent adds fields such as tags, file type, dates, and status while preserving valid existing fields.

In plain words
What is it for?
Use it to scan a vault, add metadata to files that lack it, derive tags and file types, recover dates from filesystem information, and produce a summary of the changes.
Why use it?
It removes inconsistent or missing metadata that makes notes harder to sort, filter, and manage. A dry run lets you preview changes before applying them.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the agents-specialized-domains plugin — 10 agents shipped together

Good fit Use it to scan a vault, add metadata to files that lack it, derive tags and file types, recover dates from filesystem information, and produce a summary of the changes.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/davepoon/buildwithclaude/metadata-agent
About the project

davepoon/buildwithclaude is a discovery hub and plugin marketplace for Claude Code extensions, including agents, commands, hooks, skills, plugins, MCP servers, and marketplace collections. Developers use it to browse, search, and find installation instructions for tools that extend Claude-related workflows. Catalogue entries include agents, plugins, commands, and skills from this collection.

davepoon/buildwithclaude · 3,421 stars · on GitHub · buildwithclaude.com

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.

Clone the repo
git clone --depth 1 https://github.com/davepoon/buildwithclaude

Made for: Claude Code.

Or install agents-specialized-domains, the plugin that ships this one along with the rest of its 10 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for metadata-agent

README.md
[![agentmods](https://agentmods.dev/badge/agents/davepoon/buildwithclaude/metadata-agent.svg)](https://agentmods.dev/agents/davepoon/buildwithclaude/metadata-agent)
Your own site
<a href="https://agentmods.dev/agents/davepoon/buildwithclaude/metadata-agent"><img src="https://agentmods.dev/badge/agents/davepoon/buildwithclaude/metadata-agent.svg" alt="Measured on agentmods" height="20"></a>
Per session 31 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 308 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00031 $0.00308
Opus 5 $0.00015 $0.00154
Sonnet 5 $0.00006 $0.00062
Haiku 4.5 $0.00003 $0.00031

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

Security

Grade A, and why

metadata-agent 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.

plugins/agents-specialized-domains/agents/metadata-agent.md · 30 lines

What it actually says

You are a specialized metadata management agent for knowledge management systems. Your primary responsibility is to ensure all files have proper frontmatter metadata following established vault standards.

When invoked:

  • Add standardized frontmatter to markdown files missing metadata
  • Extract creation and modification dates from filesystem metadata
  • Generate appropriate tags based on directory structure and content analysis
  • Determine file types (note, reference, moc, daily-note, template, system)
  • Maintain consistency across all vault metadata standards

Process:

  1. Scan vault for files missing proper frontmatter using metadata addition scripts
  2. Run dry-run mode first to preview which files need metadata updates
  3. Extract filesystem dates as fallback for creation/modification timestamps
  4. Generate hierarchical tags reflecting file location and content (e.g., ai/agents, business/client-work)
  5. Assign appropriate file types and status values (active, archive, draft)
  6. Add metadata while preserving any existing valid frontmatter fields

Provide:

  • Standardized frontmatter with required fields (tags, type, created, modified, status)
  • Summary reports of metadata changes and additions made
  • Tag generation following hierarchical structure based on content and location
  • Proper file type classification and status assignment
  • Filesystem date integration for accurate timestamp tracking
  • Preservation of existing metadata when adding missing fields without overwriting valid content
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 · 30 lines · 31 tokens per session scan A f3ac25b5ca1d

Subscribe to this mod's changes

metadata-agent is an agent published in the GitHub repository davepoon/buildwithclaude (3,421 stars, last pushed today), licensed MIT. It adds 31 tokens to every session and 308 once invoked, about $0.0002 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-09-05.

Related

Other agents, from other repositories

reference-builder

Creates exhaustive technical references and API documentation. Generates comprehensive parameter listings, configuration guides, and searchable reference materials. Use PROACTIVELY for API docs, configuration references, or complete technical specifications.

NOMARJ/sigil · 41 tokens

dev-document

Generation of documents (PDF, DOCX, XLSX, PPTX). Use to create a document, generate a report, export to PDF/Word/Excel/PowerPoint, or produce an office file.

christopherlouet/claude-base · 45 tokens

archcore-assistant

Archcore documentation expert. Use for complex multi-document tasks: requirements engineering (ISO 29148 cascades), multi-document planning, relation graph management, and any task involving creation or modification of multiple .archcore/ documents.

archcore-ai/plugin · 50 tokens

document-parser-searcher

Use this agent when you need to parse, search, or analyze documents in various formats (PDF, DOCX, PPTX, etc.). Examples include: searching through research papers for specific concepts, extracting information from legal documents, finding relevant sections in technical manuals, analyzing large document collections…

sonomirco/agents-and-commands · 0 tokens

confluence-fetcher

An agent that retrieves and explains pages from Confluence, a company wiki and documentation service, using their URLs.

lc-semba-ryuichiro/semba-claude-plugins · 437 tokens

quarto-critic

Adversarial QA agent that compares Quarto HTML against Beamer PDF benchmark. Produces harsh, actionable criticism. Does NOT edit files — read-only analysis only.

brycewang-stanford/Auto-Empirical-Research-Skills · 38 tokens