CtrlK
BlogDocsLog inGet started
Tessl Logo

tag-taxonomy

Enforce consistent tagging across the Obsidian wiki using a controlled vocabulary. Use this skill when the user says "fix my tags", "normalize tags", "clean up tags", "tag audit", "what tags should I use", "tag taxonomy", or whenever you're creating or updating wiki pages and need to choose the right tags. Also trigger when the user asks about tag conventions, wants to add a new tag to the taxonomy, or says "my tags are a mess". Always consult this skill's taxonomy file before assigning tags to any wiki page.

70

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

76%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body with executable commands, concrete examples, and clearly delineated modes. Its main gap is the absence of validation checkpoints around the batch frontmatter writes in the normalization mode, which the rubric explicitly caps at 3 for workflow clarity; disclosure is solid though it leans on other skills' files for key procedures.

Suggestions

Add an explicit validation step to Mode 2 (Tag Normalization): after writing updated frontmatter, re-read or diff each modified page to confirm only tag lines changed and the 5-tag limit now holds, before running the memory sync.

Include a post-audit checkpoint in Mode 1 (e.g., 'confirm the frequency table reconciles: total pages scanned equals tagged + untagged + excluded') so the audit report that drives normalization is itself verified.

Trim the mock audit report in Mode 1 to a skeleton template with placeholder rows (~10 lines) and move the fully worked example to a reference file, improving both conciseness and progressive disclosure.

DimensionReasoningScore

Conciseness

The body is directive and efficient — no space is spent explaining what Obsidian, tags, or YAML frontmatter are, and rules are stated tersely ('max 5 tags per page, lowercase/hyphenated'). It falls short of anchor 5 only because the ~30-line mock audit report and fully worked before/after example carry illustrative sample data (e.g., 'windows98 → retro') that could be trimmed to a skeleton; anchor 3 is ruled out since the padding is sample-data length, not over-explanation of known concepts.

4 / 5

Actionability

Guidance is fully executable: concrete glob patterns ('Glob: $VAULT_PATH/**/*.md (excluding _archives/, .obsidian/, _meta/)'), copy-paste-ready bash with env fallbacks ('${QMD_CLI:-qmd} update', the 'obsidian-wiki memory sync' invocations with argument placeholders), and a concrete before/after YAML example for normalization. The four modes each come with specific steps covering the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Sequences are clear (numbered steps per mode, audit-before-normalize ordering), but Mode 2 is a batch write across many pages ('Write the updated frontmatter') with no post-write verification — no re-read, diff review, or checkpoint. Per the guideline capping batch operations without validation at 3, this cannot exceed anchor 3 ('sequence present but checkpoints missing or implicit'); anchor 4's 'most checkpoints present' bar is unmet for the write path itself, with only the QMD step having verify commands.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the body is organized into clearly headed sections (Before You Start, Reserved System Tags, Modes 1-4, post-operation sync, QMD). External references are one level deep and clearly signaled ('follow the Config Resolution Protocol in llm-wiki/SKILL.md', 'See .skills/llm-wiki/references/MEMORY.md for the full procedure'). Anchor 5 is not met because those referenced procedures live in other skills rather than well-signaled sibling files, and the inline mock report is borderline content that could live in a reference file; anchor 4 ('good structure; references mostly clear; minor organization gaps') fits best.

4 / 5

Total

16

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states a concrete capability set, defines an explicit and natural trigger vocabulary, and scopes itself tightly to Obsidian tag management. The only minor weakness is that the action list is spread across trigger phrasing rather than presented as a crisp capability enumeration.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Enforce consistent tagging', 'normalize tags', 'tag audit', 'choose the right tags', 'wants to add a new tag to the taxonomy' — against a specific domain (Obsidian wiki, controlled vocabulary). It sits at anchor 4 ('several specific actions; minor gaps') rather than 3 because more than 1-2 distinct operations are named, and not at 5 because the actions are stated as capabilities/triggers rather than a fully comprehensive enumerated operation list.

4 / 5

Completeness

Both questions are answered explicitly: what ('Enforce consistent tagging across the Obsidian wiki using a controlled vocabulary') and when ('Use this skill when the user says... or whenever you're creating or updating wiki pages and need to choose the right tags'). Concrete trigger phrases are attached, mirroring the anchor-5 exemplar.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrases including synonyms and colloquial variants: '"fix my tags"', '"normalize tags"', '"clean up tags"', '"tag audit"', '"what tags should I use"', '"tag taxonomy"', '"my tags are a mess"'. These are exactly what a user would naturally say, matching the anchor-5 example's coverage of variations.

5 / 5

Distinctiveness Conflict Risk

Clear niche — tag taxonomy enforcement for an Obsidian wiki — with tag-specific triggers ('tag audit', 'tag taxonomy', 'fix my tags') that would rarely collide with other skills. Anchor 4 was considered because 'creating or updating wiki pages' slightly broadens scope into general wiki-editing territory, but the qualifying clause 'and need to choose the right tags' keeps the trigger distinct, so anchor 5 is the better fit.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Ar9av/obsidian-wiki
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.