Skip to main content

subagent

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

Cleans up vault tag taxonomy and removes duplicates. Useful for organizing deeply nested notes in Obsidian.

Install into Claude Code · claude-code-templates All methods and platforms ↓

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

What tag-agent does

The subagent handles taxonomy consistency across note vaults. It detects duplicate labels, merges variations like hyphenated and slash paths, and enforces correct casing for names such as LangChain or PostgreSQL. Hierarchies are restricted to three levels deep.

The agent relies on Read, MultiEdit, Bash, and Glob tools. Its core workflow centers around tag_standardizer.py, which offers a --report argument to generate a dry-run analysis before applying any document updates.

Without the PyYAML package installed in the environment, the Python automation will fail immediately. Running a preliminary report is necessary to avoid unintended vault changes.

What it helps with

merge duplicate tags and disparate label variations
organize vault tags into clean parent-child hierarchies
create an inconsistency report prior to modifying files
enforce proper casing across product and technology names

Example prompts for the agent

Run an audit on all vault tags and produce a taxonomy report
Standardize product casing and merge duplicate technology tags
Reorganize top-level categories into a nested tag hierarchy

How to install tag-agent

1claude-code-templates

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

2Manually: put the files in place

.claude/agents/tag-agent.md

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

Manually: put the files in place

.codex/agents/tag-agent.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Manually: put the files in place

.cursor/agents/tag-agent.md

Cursor also reads .claude/agents/

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

Questions about tag-agent

How to install tag-agent in Claude Code?

Run npx claude-code-templates@latest --agent obsidian-ops-team/tag-agent. This saves the configuration to .claude/agents/tag-agent.md.

What does tag-agent do?

It audits markdown files for inconsistent labels, normalizes casing on technology names, and structures tags into strict parent-child hierarchies.

What dependencies does this subagent require?

It requires python3 with PyYAML installed to run the local tag standardization script.

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 →

mcp-protocol-specialist A subagent for Model Context Protocol work: transports, JSON-RPC 2.0, versioning and compliance across implementations. 781installs conventional-commits This hook checks Git commit messages against the Conventional Commits pattern. Use it when commit history needs to support changelogs and semantic versioning. 773installs supabase-realtime-monitor Inspect Supabase Realtime connections, find subscription code in a project, and focus analysis on performance, errors, or connection status. 764installs format-javascript-files Formats .js, .ts, .jsx, and .tsx files with Prettier whenever Claude Code edits them. Keeps styling consistent without manual formatting passes. 751installs visual-analysis-ocr Reads text from PNG images, maps document structure, and turns the result into markdown. Useful for scans and visual documents. 742installs setup-docker-containers Sets up Docker for development and production projects, covering multi-stage builds, Compose environments, and container workflows. 740installs comprehensive-researcher A Claude subagent that turns a topic into research questions, gathers sources and writes a cited report. Useful when you need an overview, not a guess. 735installs doc-api Scans your codebase for endpoints and writes the API documentation: spec, request and response examples, an interactive page. Useful when there are too many routes to describe by hand. 733installs

Project sponsors

Companies that keep this analytics open

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