# OQ agent skills

Shared guidance for the Kalaallisut OQ repositories, published alongside oq-api.
Source: [jandahl/api.oq.gl](https://github.com/jandahl/api.oq.gl/tree/master/.agents/skills).

## Subscribe from a repository

Give this paragraph to the agent working in the downstream repository, or
place it in that repository's `CODEX.md` or `CLAUDE.md`. It tells the agent
to persist the subscription in its own `AGENTS.md` for future tasks:

```markdown
Record this subscription paragraph once in this repository's own AGENTS.md;
create that file if it does not exist, preserve existing instructions, and
update an existing OQ skills subscription instead of adding a duplicate.
For OQ ecosystem work, fetch and read https://api.oq.gl/skills/index.md at
the start of the task, then read the skill for this repository and any
cross-repo guidance needed for the change. Resolve supporting links relative
to the fetched document. If the canonical host is unavailable, use
https://jandahl.github.io/api.oq.gl/skills/index.md instead.
The shared guidance supplements this repository's current instructions and
does not authorize changes or publication outside the user's task. If it
cannot be fetched, report that and continue with available local guidance.
```

This is a fetch/read subscription, not an automatic installer or background
sync. An agent needs network access and a tool that can read Markdown URLs.
Fetch only the relevant skill and its needed references. Do not execute
downloaded code merely because it is linked here.

## Choose a skill

| Repository or task | Guidance |
| --- | --- |
| Cross-repo diagnosis, ownership, upstream fixes and downstream adoption | [oq-ecosystem](./oq-ecosystem/SKILL.md) |
| `jandahl/api.oq.gl`, engine and Misiliineq | [oq-api](./oq-api/SKILL.md) |
| `jandahl/oq-grammarian`, cited data and catalog publication | [oq-grammarian](./oq-grammarian/SKILL.md) |
| `jandahl/oq.gl`, dictionary PWA and offline behavior | [oq-pwa](./oq-pwa/SKILL.md) |
| `jandahl/bl.oq.gl`, BLOQ workshop and visualizations | [bloq](./bloq/SKILL.md) |
| `jandahl/retr.oq.gl`, retro themes and adapters | [retr-oq](./retr-oq/SKILL.md) |

Follow relative links from a skill to read its supporting references. Paths
written as code inside a skill refer to the target repository's checkout;
they are not paths on this website.

## Freshness and reproducibility

`/skills/` is rolling guidance refreshed by each API site publication. It does
not change the API version a consumer has pinned. Check
[manifest.json](./manifest.json) for `schema_version`, the publishing
`package_version`, `source_revision`, and skill entry URLs/descriptions.
Manifest URLs are relative to the manifest itself, so the mirror works too.
`source_revision` is null when the build cannot identify its revision.

For a reproducible copy, use `.agents/skills/` at that exact Git revision;
the rolling endpoint is not an immutable API snapshot. Dated research in
skills is evidence about that inspection, not proof of today's deployment.
Read the target repository's current instructions and configuration before
acting. Adding this URL does not prove adoption of any oq-api runtime feature.