Skip to content

feat(terra-models): add Models skill#3

Merged
CameronLCrawford merged 1 commit into
mainfrom
cameron/models-skill
Jul 16, 2026
Merged

feat(terra-models): add Models skill#3
CameronLCrawford merged 1 commit into
mainfrom
cameron/models-skill

Conversation

@CameronLCrawford

@CameronLCrawford CameronLCrawford commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Adds a terra-models skill for the Terra API Models product: run a health model over a connected user's data for a date range and get a ready-to-use insight back.

Follows the authoring guide (distil what the agent would get wrong; point to live docs for volatile shapes). SKILL.md covers:

  • The two GA models: sleep_window and health_terrain, and their data needs.
  • Connect the user through the Unified API first; a model can't always return an insight for a given user and range.
  • Empty/unsupported results come back as HTTP 200 (unsupported/no_data/supported:false), not errors, and still bill a credit — so validate before running.
  • Per-run pricing ($0.01/run) and the boundaries with the Unified API and Health Scores.

Exact request/response schemas are left to the live docs (docs.tryterra.co/models).

Registered in skills.sh.json, .claude-plugin/marketplace.json, and the README catalog.

Local checks (mirroring CI): prettier --check ✓, agentskills validate skills/terra-models ✓, SKILL.md under 500 lines ✓, check-doc-links ✓.

Adds a terra-models skill for the Terra API Models product: run a health
model over a connected user's data for a date range and get a ready-to-use
insight back. SKILL.md covers the two GA models (sleep_window,
health_terrain) and their data needs, connecting the user through the Unified
API first, handling empty/unsupported results (HTTP 200, not errors) and the
credit they still cost, per-run pricing, and the boundaries with the Unified
API and Health Scores. Exact request/response schemas are left to the live
docs.

Registered in skills.sh.json, the plugin marketplace, and the README catalog.
@CameronLCrawford
CameronLCrawford merged commit 699a737 into main Jul 16, 2026
3 checks passed
@CameronLCrawford
CameronLCrawford deleted the cameron/models-skill branch July 16, 2026 11:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant