Skip to main content
affpapa.org
RU EN
subagent

metadata-agent — Claude Code subagent: what it does, how to install

Standardizes frontmatter in Obsidian markdown vaults. It detects missing metadata, inserts tags, file categories, and creation dates.

Install into Claude Code · claude-code-templates All methods and platforms ↓ 
npx claude-code-templates@latest --agent obsidian-ops-team/metadata-agent
Open on GitHub

What metadata-agent does

This subagent inspects markdown documents in an Obsidian vault to bring YAML frontmatter into uniform shape. When a note lacks metadata, the agent inserts standard fields: tags, type, created, modified, and status. It pulls creation timestamps directly from filesystem attributes and assigns hierarchical tags based on note content and folder placement. File types follow a predefined scheme, covering categories like note, moc, reference, template, and daily-note.

Execution relies on a Python script named metadata_adder.py triggered through the Bash tool. The workflow starts with a --dry-run execution to preview proposed updates before writing to disk. Existing valid frontmatter remains untouched. The agent updates notes only when metadata is missing or contains malformed fields.

The prompt references absolute local paths such as /Users/cam/VAULT01/System_Files/Scripts/metadata_adder.py. Adapting this setup to another environment requires updating those directory paths first.

What it helps with

  • insert missing frontmatter blocks across vault markdown files
  • populate note creation dates from filesystem attributes
  • generate hierarchical tags from note context and folder structure
  • assign document categories and status flags systematically

Example prompts for the agent

  • Run metadata-agent in dry-run mode to see notes missing frontmatter
  • Standardize metadata across markdown files in the reference directory
  • Use metadata-agent to assign tags and document types to recent notes

How to install metadata-agent

1claude-code-templates

npx claude-code-templates@latest --agent obsidian-ops-team/metadata-agent

2Manually: put the files in place

.claude/agents/metadata-agent.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about metadata-agent

How to install metadata-agent in Claude Code?

Run npx claude-code-templates@latest --agent obsidian-ops-team/metadata-agent in your terminal. The subagent definition will be saved to .claude/agents/metadata-agent.md.

What does metadata-agent do?

It scans Obsidian vault notes and inserts standardized frontmatter headers containing tags, timestamps, document types, and status values.

Why does the workflow use a dry-run flag?

Running python3 /Users/cam/VAULT01/System_Files/Scripts/metadata_adder.py --dry-run previews every file that needs frontmatter, so you can inspect planned modifications before updating files.

Similar subagents

All subagents for Notes, tasks and projects →
context-manager VoltAgent Community Organizes shared context for multi-agent projects in files, including state, task history, and decisions. Use it when agents need a clear shared workspace. 10,638installs code-architect official Anthropic Analyzes codebase patterns to produce architectural blueprints with file lists, component interfaces, data flows, and phased build sequences. 1,439installs search-specialist VoltAgent Community A subagent that hunts down precise information across many sources: builds queries, picks sources, filters results. Useful when the job is finding, not analyzing. 6,886installs content-marketer VoltAgent Community This subagent plans content, prepares SEO and multi-channel campaigns, and tracks their results. Use it to build an editorial plan or coordinate a campaign. 4,038installs product-manager VoltAgent Community This subagent helps shape product strategy, prioritize features, and plan a roadmap from user needs and business goals. 1,104installs project-manager VoltAgent Community Coordinates project plans, tracks schedules and budgets, and logs project risks. Useful when managing complex initiatives right inside Claude Code. 1,064installs

From the same set804

The whole set →
nextjs-component-generator Generate TypeScript components for Next.js using your project structure as context. Choose a client, server, page, or layout component. 935installs create-feature Builds a new feature scaffold with implementation guidance, tests, and docs. Use it when a feature needs a structured path from planning to review. 898installs api-architect Designs REST and GraphQL APIs and prepares service-connection code. Use it to compare API styles or plan resilience and authentication. 881installs build-on-change Runs your build pipeline automatically whenever Claude Code edits a file. Detects build setups for Node.js, Make, Rust, and Java projects. 877installs technical-debt-manager Scans codebases for architecture flaws and test gaps. Helps build a prioritized refactoring plan for sprint planning. 857installs market-research-analyst A Claude subagent that gathers market and competitor data through web search and returns it as a structured research report. 851installs mcp-security-auditor Audits Model Context Protocol servers for vulnerabilities, configures OAuth 2.1 flows, and designs RBAC. Useful before deploying MCP tools to production. 851installs content-curator This subagent audits Obsidian notes, spots duplicates and stale material, and suggests cleanup work. Use it when a vault needs regular content review. 846installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor