CtrlK
BlogDocsLog inGet started
Tessl Logo

terra-connections

Terra API device and provider connections. Use when connecting users to wearables (Fitbit, Garmin, Apple Health, Oura, WHOOP), managing user sessions, or handling disconnections.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, multi-platform reference with executable code throughout, held back by a lack of validation for its destructive disconnect operation and a fully inline structure with no progressive disclosure into reference files.

Suggestions

Add a verification step to disconnect-user workflows (e.g., confirm via get-user-info or the deauth webhook that the user and data were removed) to lift workflow_clarity past the destructive-operation cap.

Split the provider catalog, provider-specific notes, and database schema into a references/ file (e.g., references/providers.md), leaving SKILL.md as a connection-flow overview with clear one-level-deep links.

Trim redundancy: the Multi-Device Setup section and provider-specific notes repeat code and SDK details already shown in the connection method sections.

DimensionReasoningScore

Conciseness

The body is dense and mostly executable code with brief bullet context — it assumes Claude's competence and avoids explaining known concepts. Minor over-explanation exists (provider-specific notes repeat SDK details like 'minSDK 28' and 'schedulerOn', and the Multi-Device Setup section re-demonstrates connect_user), placing it at anchor 4 rather than the fully lean anchor 5.

4 / 5

Actionability

The content provides fully executable, copy-paste-ready code for all four platforms (Python widget/custom flows, Swift, Kotlin, React Native) with concrete parameters, complete operation implementations, realistic webhook payload examples, and a ready SQL schema. This matches anchor 5: specific examples cover the common connection and management cases.

5 / 5

Workflow Clarity

Connection flows are clearly sequenced (widget user flow steps 1-5, custom UI steps 1-2, SDK init steps 1-3), but the destructive disconnect-user operation ("revokes access, removes data") has no verification step and there is no error-recovery loop beyond listing the connection_error webhook payload. The rubric's cap for destructive operations without validation applies, holding this at 3 rather than 4.

3 / 5

Progressive Disclosure

The document is well-sectioned but entirely monolithic: the 150+ provider catalog, provider-specific notes, webhook payloads, and the SQL schema are all inline with no references/ or assets/ bundle files at all. This matches anchor 3 (content that should be separate is inline, structure present) rather than 4, which requires most bulk content moved out of SKILL.md.

3 / 5

Total

15

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description in third-person voice with an explicit 'Use when' clause, concrete provider triggers, and clearly named actions. Its main weaknesses are a slightly thin 'what' statement and minor overlap risk with sibling Terra skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions with named providers — "connecting users to wearables (Fitbit, Garmin, Apple Health, Oura, WHOOP), managing user sessions, or handling disconnections" — matching the anchor for several specific actions with minor gaps in coverage. It falls short of anchor 5 because it omits other capabilities the skill covers (webhook events, multi-device setup, mobile SDK requirements), and exceeds anchor 3 since more than 1-2 concrete actions are named.

4 / 5

Completeness

It explicitly answers both what ("Terra API device and provider connections") and when ("Use when connecting users to wearables... managing user sessions, or handling disconnections") with concrete trigger phrases naming specific providers. This matches the anchor 5 example structure (clear what followed by an explicit 'Use when' clause with concrete triggers) and exceeds anchor 4, where the 'when' would be only generally stated.

5 / 5

Trigger Term Quality

Natural keywords users would say are present: brand names ("Fitbit", "Garmin", "Apple Health", "Oura", "WHOOP") plus action phrases like "connecting users", "managing user sessions", "handling disconnections". This matches anchor 4 (good keyword coverage, a few natural terms missing) rather than 5 because common variations like "health data", "trackers", "link a device", or "sync" are absent.

4 / 5

Distinctiveness Conflict Risk

The connection lifecycle is a clear niche with distinct triggers (provider names, connect/disconnect actions), but "managing user sessions" carries minor overlap risk with the sibling terra-auth skill listed in Related Skills. This matches anchor 4 (mostly distinct, minor overlap risk with closely related skills) rather than 5, which would require no meaningful overlap with adjacent Terra skills.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
fernandezbaptiste/Skrillz
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.