How do I trigger a response from the agent?

Add an HTML comment to your file using the format . The agent will scan for these patterns and provide a dated response starting with .

Will these comments be visible in my final documentation?

No, because the skill uses standard HTML comment syntax, the annotations remain invisible in rendered Markdown viewers like GitHub, Obsidian, and VS Code.

What file types does the Annotations skill support?

It primarily supports Markdown (.md) and text files, but it is also compatible with Python (.py), TOML, and YAML files when using the appropriate comment syntax.

What is the difference between a question and a direct instruction?

Questions receive a threaded reply within the file. Direct instructions (like 're-file this') are executed by the agent, after which the comment is deleted and the action is summarized in a git commit.

Collaboration Annotations

Name: Collaboration Annotations
Author: nicsuzor

bynicsuzor

0•

Collaboration Tools

Facilitates asynchronous human-agent communication through standardized inline HTML comments and automated response workflows.

The Annotations skill enables a robust collaboration framework between human developers and Claude by utilizing inline HTML comments. It allows users to tag files with specific queries or instructions that the agent can scan, interpret, and respond to with dated entries. Beyond simple Q&A, the skill supports complex workflows including task generation, thread archiving, and automated cleanup of resolved discussions, making it an essential tool for maintaining context-rich documentation and codebase communication without cluttering rendered output.

Key Features

01Cleanup functionality to archive resolved threads and maintain file hygiene.

02Support for multiple file types including Markdown, Python, TOML, and YAML.

03Automated scanning for pending human annotations using high-performance grep patterns.

04Context-aware agent responses with automatic date-stamping and thread management.

05Task integration that converts direct instructions into trackable project items.

060 GitHub stars

Use Cases

01Managing asynchronous peer reviews and technical queries directly within source code or documentation.

02Automating the transition from inline brainstorming to structured task management.

03Tracking pending research tasks or 'checks' in academic and technical writing workflows.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nicsuzor/aops-dist annotations

For use in Claude.ai and ChatGPT

Download Skill