What comment formats does the skill recognize?

The skill recognizes HTML-style comments such as , , and , responding with a dated tag.

Does it support task tracking?

Yes, when an instruction is captured as a task, Claude will include the specific Task ID in its response comment for easy reference.

How does it handle direct instructions versus questions?

Questions receive a threaded reply, while direct instructions are executed by the agent, logged in a commit message, and the comment is then cleaned to keep files tidy.

Can I use this skill in Python files?

Yes, the skill supports Python files by wrapping the HTML comment in a standard Python comment (e.g., # ) while preserving indentation.

Will these comments appear in my rendered Markdown?

No, because it uses standard HTML comment syntax, the annotations remain invisible in rendered environments like GitHub, Obsidian, and VS Code previews.

Collaborative Annotations

Name: Collaborative Annotations
Author: nicsuzor

bynicsuzor

0•

협업 도구

Facilitates seamless human-agent collaboration through structured inline HTML comments across Markdown and code files.

The Annotations skill establishes a robust asynchronous communication workflow between users and Claude by utilizing inline HTML comments. It allows users to leave specific tags like  within their documents or code, which Claude can then scan, process, and respond to with dated replies. This skill is ideal for academic research, collaborative documentation, and code reviews, as it preserves context by keeping discussions directly adjacent to the relevant content while ensuring comments remain invisible in rendered Markdown outputs.

주요 기능

01Conversion of direct instructions into actionable tasks with ID tracking

02Context-aware dated agent responses with the @claude prefix

03Support for Markdown, Python, YAML, and various text-based formats

04Automatic archival of resolved threads to preserve documentation history

050 GitHub stars

06Automated scanning for pending human annotations using Grep

사용 사례

01Managing long-term discussions and decision-making history directly in-file

02Contextual task assignment and instruction logging within source code

03Asynchronous peer review and feedback loops within research documentation

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