What happens to the tags after they are processed?

Processed @FIX and @TODO tags are removed to keep documentation clean, while @OK and @APPROVED tags are preserved with a timestamp for audit purposes.

How does the [MACRO] flag work?

The [MACRO] flag is added after a tag description to signal that a change has systemic impact, such as a formula affecting multiple files or a workflow change impacting multiple user roles.

Does this skill automatically modify my files?

Claude parses the tags and proposes changes in a report format. Modifications are only applied to the files after user validation and approval.

What are the primary tags used in this skill?

The skill utilizes four core tags: @FIX for factual errors, @TODO for generic content additions, @VERIFY for source-checking, and @OK for light validation of sections.

Document Review & Annotation System

Name: Document Review & Annotation System
Author: theflysurfer

bytheflysurfer

学习与文档

Simplifies documentation reviews using a standardized tagging system and automated systemic impact analysis.

关于

This skill provides a structured methodology for reviewing and annotating technical documentation within Claude. It employs a streamlined system of four core tags—@FIX, @TODO, @VERIFY, and @OK—alongside a [MACRO] flag to distinguish between local edits and systemic changes that impact multiple files or databases. By automating the parsing and reporting of these annotations, it enables Claude to perform comprehensive document audits, track project progress, and apply verified updates while maintaining the integrity of the source material as the single source of truth.

主要功能

Standardized 4-tag system for rapid documentation annotation and clarity.
Formal validation workflow with @LOCKED and @APPROVED tags for sensitive content.
0 GitHub stars
Systemic impact tracking using the [MACRO] flag for cross-file dependencies.
Automated parsing and generation of detailed comment tracking reports.
Intelligent distinction between micro-local edits and macro-structural modifications.

使用场景

Tracking systemic changes like formula updates or variable renames across multiple markdown files.
Managing collaborative document reviews with clear priority levels and action items.
Auditing large technical documentation sets for factual errors and missing sections.

关于

主要功能

Standardized 4-tag system for rapid documentation annotation and clarity.
Formal validation workflow with @LOCKED and @APPROVED tags for sensitive content.
0 GitHub stars
Systemic impact tracking using the [MACRO] flag for cross-file dependencies.
Automated parsing and generation of detailed comment tracking reports.
Intelligent distinction between micro-local edits and macro-structural modifications.

使用场景

Tracking systemic changes like formula updates or variable renames across multiple markdown files.
Managing collaborative document reviews with clear priority levels and action items.
Auditing large technical documentation sets for factual errors and missing sections.