CtrlK
BlogDocsLog inGet started
Tessl Logo

domino-api-intro

Introduction to calling Domino platform APIs. Covers authentication (API proxy, PAT, service account), which host to use for which API, pagination limits, and common errors. Use before any other Domino API, SDK, app, extension, or governance automation skill.

67

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 lean, well-structured overview skill: concrete env vars and endpoints, an explicit auth decision table, and a clean progressive-disclosure table pointing to five one-level-deep reference files. Its weaknesses are minor — a small amount of duplicated auth/compatibility text, no worked request example, no verify-your-auth checkpoint, and the referenced bundle files being absent from this evaluation copy, making the reference links unverifiable.

Suggestions

Add a single copy-paste example of an authenticated request (e.g., a curl or Python snippet using the in-run access-token flow) so the most common case is fully executable without leaving SKILL.md.

Trim the duplicated auth summary: the parenthetical '(API proxy in-run, access token + platform host, PAT, and service account)' repeats the context table, and 'Applies to Domino 6.3 and Domino Cloud' repeats the frontmatter compatibility line.

Include the five referenced files (HOSTS.md, LIMITS.md, ERRORS.md, SDK-MAP.md, API-SPECS.md) in the skill bundle — the 'Reference files' table links to them, but they are not present, breaking the navigation the table promises.

DimensionReasoningScore

Conciseness

The ~30-line body is dense and free of concept over-explanation, with deprecated legacy keys correctly fenced off. Minor trimmable content remains: the parenthetical '(API proxy in-run, access token + platform host, PAT, and service account)' on the auth page line duplicates the context table below it, and 'Applies to Domino 6.3 and Domino Cloud' restates the frontmatter compatibility. That places it at anchor 4 ('minor instances... that could be trimmed') rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Concrete, executable guidance is present: exact env vars (DOMINO_API_PROXY, DOMINO_USER_HOST, DOMINO_API_HOST), an exact endpoint (http://localhost:8899/access-token), and explicit header rules ('no Authorization header when set', 'Bearer PAT'). It stops short of anchor 5 because there is no copy-paste example of an actual authenticated request, and the detailed steps are delegated to reference files and an external docs page.

4 / 5

Workflow Clarity

The sequence is clear and unambiguous for a single-purpose skill: read first, pick auth mode via the explicit in-run/outside-run decision table, pick host via HOSTS.md, then move to domain skills. It sits at anchor 4 rather than 5 because there is no validation checkpoint (e.g., a test GET to confirm the token works) before proceeding to automation work.

4 / 5

Progressive Disclosure

The body is a genuine overview with a 'Reference files (this skill)' table giving one-level-deep, clearly signaled references with a 'Use when' column — structurally matching the anchor-5 pattern. However, none of the five referenced files (HOSTS.md, LIMITS.md, ERRORS.md, SDK-MAP.md, API-SPECS.md) exist in this evaluation bundle (no references/, scripts/, or assets/ directories), so navigation could not be verified, capping this at anchor 4.

4 / 5

Total

16

/

20

Passed

Description

88%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: concrete, comprehensive, and free of fluff, with an explicit 'use before...' trigger clause. It is written in third person with no padding. The only weaknesses are a few missing natural keyword variants and deliberate overlap with sibling Domino skills by design.

DimensionReasoningScore

Specificity

The description enumerates concrete coverage areas with specifics: 'authentication (API proxy, PAT, service account), which host to use for which API, pagination limits, and common errors' — four concrete capabilities with named methods, comprehensively covering the skill's scope. Anchor 4 falls short because nothing is generic here and coverage has no real gaps; anchor 5's 'multiple specific concrete actions; comprehensive coverage' matches exactly.

5 / 5

Completeness

It explicitly answers both: what ('Introduction to calling Domino platform APIs. Covers authentication..., which host..., pagination limits, and common errors') and when ('Use before any other Domino API, SDK, app, extension, or governance automation skill'). Both are concrete and explicit, matching the anchor-5 exemplar; anchor 4 would require the 'when' to be less specific than this explicit trigger clause.

5 / 5

Trigger Term Quality

Natural terms are present — 'calling Domino platform APIs', 'SDK', 'app', 'extension', 'governance automation', 'PAT', 'pagination' — which a Domino user would plausibly say. A few common variations are missing (e.g., 'REST API', 'HTTP', 'API key', 'requests'), so it is good-but-not-comprehensive coverage, matching anchor 4 rather than anchor 5's synonym-and-extension completeness.

4 / 5

Distinctiveness Conflict Risk

The Domino platform niche is clear and the description scopes itself to API/automation usage, but 'Use before any other Domino API, SDK, app, extension, or governance automation skill' intentionally triggers alongside every sibling Domino skill, creating minor overlap risk with closely related skills. This fits anchor 4 ('mostly distinct; minor overlap risk with closely related skills') better than anchor 5's minimal-conflict profile.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 6 missing

Warning

Total

15

/

16

Passed

Repository
dominodatalab/domino-claude-plugin
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.