> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/developer-tools/readme.md).
# Agent skills
Install instructions that help AI agents create more accurate Terra API integrations.
[Agent skills](https://agentskills.io) give AI coding agents reusable guidance for building Terra API integrations. Terra maintained skills provide the newest product and API guidance based on the latest recommended practices.
## Install
{% tabs %}
{% tab title="Terra CLI" %}
The [Terra CLI](https://github.com/tryterra/terra-cli) installs the skills and configures every coding agent it finds, so you get the latest set without configuration or maintenance. This is the recommended path.
```bash
brew install tryterra/tap/terra # macOS
npm install -g @tryterra/cli # everywhere else
```
```bash
terra agent setup
```
This command detects which agents you use, and writes the skills to the directory each one reads.
Other flags
* `--status-only` shows what would change without writing anything
* `--global` installs for your user rather than into one project
* `--skills` takes a comma separated list, to install a subset
{% endtab %}
{% tab title="skills.sh" %}
Install every skill with [skills.sh](https://skills.sh):
```bash
npx skills add tryterra/agent-skills
```
Or a single skill:
```bash
npx skills add tryterra/agent-skills --skill terra-unified-api
```
{% endtab %}
{% tab title="Claude Code plugin" %}
Claude Code users can install the same set as a plugin:
```
/plugin marketplace add tryterra/agent-skills
/plugin install terra@terra-agent-skills
```
{% endtab %}
{% endtabs %}
{% hint style="info" %}
Manually installed skills do not update themselves. Run `npx skills update -y` to get the latest versions.
{% endhint %}
The skills follow the [Agent Skills](https://agentskills.io) open standard, so they work with Claude Code, Cursor, GitHub Copilot, Gemini CLI, and any other agent that supports the format.
## Included skills
| Skill | What it covers | Status |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------- | ----------- |
| `terra-cli` | Read and change account configuration from the terminal instead of the dashboard, and reach any endpoint directly | Ready |
| `terra-unified-api` | API best practices: webhooks and signature verification, data idempotency, connection lifecycle, multi-device data, testing | Ready |
| `terra-mobile-sdk` | Mobile integration for Apple Health, Samsung Health, and Health Connect on iOS, Android, React Native, and Flutter | Ready |
| `terra-streaming` | Realtime websocket data and the Real-Time SDK on iOS, Android, React Native, Flutter, and Wear OS | Ready |
| `terra-models` | Running health models (Sleep Window, Menstrual Cycle Tracker, Smart Fill) over a connected user's data | Ready |
| `terra-vantage` | Blood and DNA test kit ordering, fulfillment tracking, and FHIR result delivery | Ready |
| `terra-planned-workouts` | Pushing structured interval workouts, with targets, to wearables | Pre-release |
| `terra-routes` | Pushing GPS courses with waypoints to devices like Garmin, COROS, and Wahoo | Pre-release |
| `terra-lab-reports` | Parsing lab report PDFs and images into standardised biomarkers, with LOINC and UCUM codes | Pre-release |
[`skills/index.json`](https://github.com/tryterra/agent-skills/blob/main/skills/index.json) lists every skill, what it does, and the files it ships. Both `terra agent setup` and `npx skills add` read it, so it is the authoritative list whenever this page and the repository disagree.
## Next steps
Docs MCP Server
Give your agent the current API reference as well as the recommended practices.