← ClaudeAtlas

fetch-annotationslisted

Pull hypothes.is annotations left by coauthors on a project's rendered site, map each one back to its source .md file, and walk the user through applying (or skipping) each as an edit. Use when the user wants to incorporate feedback left as web annotations.
hsigstad/research-kit · ★ 0 · Data & Documents · score 75
Install: claude install-skill hsigstad/research-kit
# /fetch-annotations — Pull coauthor annotations from hypothes.is and apply them Coauthors annotate the rendered project site via hypothes.is (sidebar on every doc page and the paper). This skill fetches those annotations, maps each one to the corresponding source `.md` file using the quoted text, and walks the user through applying each as an edit to the repo. ## Arguments - `/fetch-annotations` — target the current project (auto-detected) - `/fetch-annotations [project-slug]` — target a specific project - `/fetch-annotations --since 2026-04-01` — only annotations updated since date ## What you do ### 1. Locate project and site URL Find workspace root by searching upward for `CLAUDE.md` next to `projects/` and `pipelines/`. Resolve the project: `$ROOT/projects/{slug}/`. Determine the site URL prefix: - Look at `build.sh` for a `deploy_site` target pushing to `gh-pages`. If the repo is `hsigstad/{slug}`, the URL is `https://hsigstad.github.io/{slug}/`. - If unclear, ask the user once. ### 2. Get the group ID (first time per project) Private annotations live in a hypothes.is group. Check for a cached group ID: - `$PROJECT/.claude/fetch-annotations.json` with `{"group": "..."}` If not cached, ask the user for the group ID (visible in the group page URL: `https://hypothes.is/groups/{ID}/{slug}`). Optionally cache it. For public annotations only, no group is needed. ### 3. Fetch annotations Run the shared tool: ```bash python3 $ROOT/research/tools/fetch_annotation