CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

api-client

REST API client builder with authentication, error handling, retry logic, and request management. Supports OAuth, JWT, API keys. Use when building API integrations, creating API clients, or working with REST services.

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/skill-builder-generic/examples/api-client-skill/SKILL.md

The canonical home for this skill is api-client in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

56%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.

The skill presents a well-organized, clearly sequenced guide with genuinely useful code examples, but its actionability is undercut by an undefined APIClient class, broken template/reference paths, and a config typo. Redundant sections (features checklist, triple auth coverage) also dilute token efficiency.

Suggestions

Remove the duplicated authentication and configuration blocks (keep one canonical example, e.g. the 'Complete Configuration Options' section) and drop the '✓ Features' checklist that restates the Overview, cutting roughly a third of the body.

Fix or remove broken references: either add the missing 'templates/' files, 'references/rate-limiting.md', and 'references/testing-apis.md', or delete those links so navigation matches the actual bundle.

Make code actionable end-to-end: correct the 'retryMult iplier' typo to 'retryMultiplier' and state where the APIClient class comes from (a bundled script, an npm package, or code to be generated).

DimensionReasoningScore

Conciseness

The body avoids concept-explanation padding but carries structural redundancy: the '✓ Features' checklist duplicates the Overview, authentication configuration appears three times (Workflow Step 2, 'Authentication Methods', and the auth block inside 'Complete Configuration Options'), and client construction is shown twice. This fits 'mostly efficient but could be tightened' rather than the verbose-prose anchors at 2 or the minor-trim level at 4.

3 / 5

Actionability

Examples are concrete JavaScript and the validation command ('python scripts/validate-config.py config.json') maps to a real script, but every code example depends on an 'APIClient' class that is never defined, imported, or sourced anywhere in the bundle, the referenced 'templates/' files do not exist, and the config example contains a typo ('retryMult iplier'). This matches 'some concrete guidance but incomplete; missing key details' rather than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

Steps 1-4 (configure client → add authentication → make requests → handle errors) are clearly sequenced with executable snippets, and a validation step exists ('Validate API configuration before using'). It falls short of anchor 5 because validation sits in a separate section instead of the workflow sequence and there is no feedback loop for validation failures; it exceeds anchor 3 because checkpoints are present, just not integrated.

4 / 5

Progressive Disclosure

Section structure and link signaling are good and references are one level deep, but scored against the actual bundle, 5 of the referenced paths are broken: 'templates/api-config-template.json' (plus 'error-handler-template.js', 'retry-logic-template.js' and the 'templates/' directory), 'references/rate-limiting.md', and 'references/testing-apis.md' do not exist, while only 'authentication-guide.md' and 'error-handling.md' are real. Broken navigation exceeds anchor 4's 'minor organization gaps', landing at 'some structure but could be better organized'.

3 / 5

Total

13

/

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.

The description is strong: it clearly states concrete capabilities and provides an explicit, natural 'Use when...' clause with multiple trigger phrases. Only minor gains are available from sharper synonyms and slightly more distinctive triggers.

DimensionReasoningScore

Specificity

'REST API client builder with authentication, error handling, retry logic, and request management' names the domain and several concrete capabilities, matching 'lists several specific actions; minor gaps in coverage'. It falls short of anchor 5 because 'request management' is generic and the items are feature names rather than comprehensive concrete operations.

4 / 5

Completeness

It explicitly answers both parts: the 'what' ('REST API client builder with authentication, error handling, retry logic...') and a concrete, multi-trigger 'when' ('Use when building API integrations, creating API clients, or working with REST services'), mirroring the anchor-5 reference example. Anchor 4's caveat ('when could be more explicit') does not apply since the when-clause is already specific.

5 / 5

Trigger Term Quality

'building API integrations', 'creating API clients', 'working with REST services', plus 'OAuth, JWT, API keys' are phrases users would naturally say, matching 'good keyword coverage; a few natural terms missing'. Not anchor 5 because common synonyms like 'HTTP client', 'endpoints', or library names (fetch/axios) are absent.

4 / 5

Distinctiveness Conflict Risk

The REST-client-building niche with distinct triggers (API integrations, API clients, REST services) is mostly distinct with only minor overlap risk against closely related skills like general HTTP-request or web-integration helpers. Not anchor 5 because 'working with REST services' is broad enough to overlap such skills.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/skill-builder-generic/examples/api-client-skill/SKILL.md

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.