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

0•

Learning & Documentation

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.

Key Features

01Standardized 4-tag system for rapid documentation annotation and clarity.

02Formal validation workflow with @LOCKED and @APPROVED tags for sensitive content.

030 GitHub stars

04Systemic impact tracking using the [MACRO] flag for cross-file dependencies.

05Automated parsing and generation of detailed comment tracking reports.

06Intelligent distinction between micro-local edits and macro-structural modifications.

Use Cases

01Tracking systemic changes like formula updates or variable renames across multiple markdown files.

02Managing collaborative document reviews with clear priority levels and action items.

03Auditing large technical documentation sets for factual errors and missing sections.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add theflysurfer/claude-skills-marketplace julien-ref-doc-review

For use in Claude.ai and ChatGPT

Download Skill