review-agent

Audit notes for metadata completeness, schema compliance, tag validity, and link connectivity.

3|4|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/xrcodexcode/xr_node --skill review-agent-xrcodexcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-agent
Source: https://github.com/xrcodexcode/xr_node/tree/main/claude/skills/review-agent
Command: npx skills add https://github.com/xrcodexcode/xr_node --skill review-agent-xrcodexcode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Notes in a knowledge base often drift out of compliance with frontmatter schemas, controlled tag vocabularies, and linking rules, making promotion decisions inconsistent and error-prone. ## Core Features & Use Cases - Frontmatter Auditing: Validates YAML frontmatter against the defined frontmatter schema rules. - Tag Verification: Checks note tags against the controlled tag list to prevent taxonomy fragmentation. - Link Connectivity Checks: Verifies owner MOC links and inbound/outbound links, flagging gaps and broken references. - Use Case: Before promoting a draft note from the processing stage to the evergreen notes layer, run an audit to confirm metadata completeness and receive a promotion recommendation. ## Quick Start Ask the review-agent to audit a note for schema compliance, tag validity, and link connectivity before approving its stage promotion.

Frequently Asked Questions about review-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate note frontmatter against a schema?

Run the review-agent audit, which checks YAML frontmatter fields against the frontmatter schema rules defined in the knowledge base. It reports missing or invalid metadata fields before a note can be promoted.

How to check tags against a controlled vocabulary in a knowledge base?

The audit step verifies each note's tags against the controlled tag list defined in the tag schema. Tags outside the approved vocabulary are flagged so the taxonomy stays consistent.

What does the review-agent check before note promotion?

It checks frontmatter schema compliance, tag validity against the controlled list, and link connectivity including the owner MOC link and inbound/outbound links. It then delivers an audit report with a promotion recommendation.

Why do broken links appear in a Zettelkasten knowledge base?

Broken links appear when notes are renamed, moved, or created without an owner MOC link. The audit identifies gaps and broken references so they can be repaired before promotion.

Can the review-agent approve note promotion automatically?

No, it provides an audit report and a promotion recommendation to the user. The final promotion decision remains with the user based on the reported gaps and violations.