atproto-annotations

Write and read W3C web annotations on ATProtocol records across PDS instances.

23|1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/just-cameron/central --skill atproto-annotations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atproto-annotations
Source: https://github.com/just-cameron/central/tree/main/skills/atproto-annotations
Command: npx skills add https://github.com/just-cameron/central --skill atproto-annotations

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Annotate and retrieve notes on web pages and ATProtocol records using W3C Web Annotations, enabling transparent and portable collaboration across the ATProtocol ecosystem.

Core Features & Use Cases

  • Write single annotations to ATProtocol records with optional quotes and motivations.
  • Batch-write multiple annotations for a single URL using applyWrites to minimize network calls.
  • Read, list, and resolve handles to access annotations across different PDS instances for cross-user collaboration.

Quick Start

Run the annotate.py tool to write an annotation for a webpage and verify it appears in your ATProtocol stream.

Frequently Asked Questions about atproto-annotations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I annotate web pages using W3C web annotations in ATProtocol?

Batch-writing annotations in ATProtocol uses the applyWrites method to submit multiple annotations for a single URL at once. This minimizes network calls and efficiently groups notes attached to the same web content target.

Can I read and discover annotations across different PDS instances?

Yes, you can read, list, and resolve handles to discover annotations across different PDS instances. This enables cross-user collaboration by allowing you to access W3C web annotations stored by others on the ATProtocol network.

What is the best way to capture notes on ATProtocol records for collaboration?

The best way to capture notes on ATProtocol records is using W3C web annotations. This approach provides transparent and portable collaboration across the ecosystem, allowing you to enrich targets with quotes and resolved titles.

Does this ATProtocol annotation tool support adding quotes and motivations?

Yes, the ATProtocol annotation tool supports optional quotes and motivations when writing annotations. It also includes title resolution to further enrich the annotation targets attached to your web content notes.

Do I need a specific PDS setup to write W3C web annotations to ATProtocol records?

Batch-writing annotations in ATProtocol uses the applyWrites method to submit multiple annotations for a single URL at once. This minimizes network calls and efficiently groups notes attached to the same web content target.