> 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/agent-skills.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

If you use Claude Code, Codex or Cursor, install the Terra API plugin. It includes every skill, connects the agent to your Terra API account through the [Terra CLI](/developer-tools/terra-cli/terra-cli.md), and updates automatically. When a session starts, the agent checks for the CLI and offers to install it and log you in if either is missing. It never does so without asking.

### Claude Code

Run these commands in your project:

```
/plugin marketplace add tryterra/agent-skills
/plugin install terra@terra
```

### Codex

Run this command in your project:

```bash
codex plugin marketplace add tryterra/agent-skills
```

Then pick Terra API in the plugins browser.

### Cursor

Run this command in your project:

```bash
npx plugins add tryterra/agent-skills
```

The same command works in any host that reads the [Agent Plugins](https://agent-plugins.org) format.

## Manual installation

{% hint style="info" %}
Manually installed skills do not update themselves. Run `terra agent setup` or `npx skills update -y` again to get the latest versions.
{% endhint %}

### Terra CLI

The CLI installs the skills and configures every coding agent it finds. [Install it](/developer-tools/terra-cli/installation.md), then run this in your project:

```bash
terra agent setup
```

It detects which agents you use and writes the skills to the directory each one reads. See [Coding agents](/developer-tools/terra-cli/coding-agents.md) for the flags that pick an agent, a subset of skills, or a user-wide install.

### skills.sh

Run this command in your project:

```bash
npx skills add tryterra/agent-skills
```

Or a single skill:

```bash
npx skills add tryterra/agent-skills --skill terra-unified-api
```

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                                                            | Ready  |
| `terra-routes`           | Pushing GPS courses with waypoints to devices like Garmin, COROS, and Wahoo                                                 | Ready  |
| `terra-lab-reports`      | Parsing lab report PDFs and images into standardised biomarkers, with LOINC and UCUM codes                                  | Ready  |

[`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

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Terra CLI</strong></td><td>Set up, manage, and debug your integration from the terminal, or let your agent do it.</td><td><a href="/developer-tools/terra-cli/terra-cli.md">Terra CLI</a></td></tr><tr><td><strong>Example apps</strong></td><td>Complete Terra integrations to scaffold, run, and build on.</td><td><a href="/developer-tools/example-apps/example-apps.md">Overview</a></td></tr></tbody></table>