What file types are supported by the Annotations skill?

This skill is specifically optimized for Markdown (.md) files within a designated data directory, ensuring it doesn't accidentally modify source code or configuration files.

Does the skill automatically delete my notes?

No, the skill includes a specific 'clean' mode that only removes resolved threads after the user has reviewed the responses and confirmed they are no longer needed.

Will these annotations be visible in my rendered markdown files?

No, the skill uses standard HTML comment syntax ( ), which ensures they remain invisible in standard markdown viewers like GitHub, VS Code, and Obsidian while being accessible to Claude.

Can I use custom identifiers for my comments?

The current version supports specific identifiers like @nic, @ns, and @nicsuzor, designed to match the user's specific workflow in the academicOps repository.

How does Claude track which comments still need a response?

Claude uses a detection pattern to find human comments that are not immediately followed by a dated @claude response, marking them as pending items.

Human-Agent Annotations

Name: Human-Agent Annotations
Author: nicsuzor

bynicsuzor

0•

Collaboration Tools

Manages asynchronous collaboration between humans and Claude using invisible inline HTML comments in markdown files.

The Annotations skill enables a seamless, non-interruptive workflow for human-agent collaboration within markdown documents. By utilizing HTML comment syntax, users can leave questions, tasks, or notes for Claude (e.g., ) that remain invisible in standard renderers like Obsidian or GitHub. Claude can then scan directories for pending items, provide dated responses directly in the file, and archive resolved threads to a backup documentation system before cleaning the source file. This is particularly useful for academic research, technical writing, and long-term project planning where maintaining context is critical.

Key Features

010 GitHub stars

02Maintains document cleanliness by removing resolved threads on command

03Generates context-aware, dated responses using the @claude identifier

04Scans markdown directories to find and aggregate pending human annotations

05Archives full comment threads to backup documentation before deletion

06Supports multiple human identifiers including @nic, @ns, and @nicsuzor

Use Cases

01Managing research tasks and follow-up questions within Obsidian vaults

02Collaborative documentation where agent responses need to be preserved for audit trails

03Asynchronous peer review and feedback loops during academic paper drafting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nicsuzor/academicops annotations

For use in Claude.ai and ChatGPT

Download Skill