fetch-annotationslisted
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