CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

schemathesis-api

Use when the task changes an HTTP API, an OpenAPI spec, or routes covered by contract tests. Run Schemathesis against the spec before calling the task done.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is schemathesis-api in fazedordecodigo/python-api-validation-discovery

SKILL.md
Quality
Evals
Security

Quality

Content

78%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, actionable skill body for a simple, single-purpose validation gate: it gives both the wrapper and direct command, states when the gate applies, and routes detail to external docs without duplicating them. The remaining gaps are minor — no error-recovery guidance when Schemathesis reports a contract divergence, and no pointer to where the platform's OpenAPI spec actually lives.

Suggestions

Add a short failure-handling step: when Schemathesis reports divergences, fix the implementation (or the spec if the contract legitimately changed) and re-run until green, rather than just stating the run fails hard.

Name where the data platform's OpenAPI spec lives (path or URL) or how to find it, so the <caminho-ou-url-do-openapi> placeholder is resolvable without guessing.

Trim the rationale sentences ('O contrato precisa aguentar o que o spec permite' and the one-line recap of property-based/fuzzing) to save tokens without losing guidance.

DimensionReasoningScore

Conciseness

The body is short and almost entirely project-specific (source of truth, apm.yml integration, when the gate applies) with two compact commands; it assumes competence rather than explaining Schemathesis from scratch. It is not a 5 because a couple of rationale sentences ('O contrato precisa aguentar o que o spec permite', the one-line recap of what Schemathesis does) could be trimmed without losing guidance value.

4 / 5

Actionability

Two concrete, executable invocations are given ('apm run schemathesis --param spec=<caminho-ou-url-do-openapi>' and 'python3 -m schemathesis run <caminho-ou-url-do-openapi>') plus explicit do/don't guidance (point at the platform spec, don't invent one). It stops short of 5 because there is no guidance on locating the actual spec path/URL for the data platform and no example of expected output or common-case invocation.

4 / 5

Workflow Clarity

The single action is unambiguous — run Schemathesis against the platform's spec before declaring the task done — and the applicability condition (route/schema/status/OpenAPI changes vs. pure Python changes) is explicit. It is not a 5 because the failure path is only stated ('Falha dura') without a fix-and-retry loop telling the agent what to do when the run reports divergences.

4 / 5

Progressive Disclosure

Under 50 lines with no bundle files, organized into clear sections that point one level deep to well-signaled external docs ('docs/schemathesis.md', 'docs/regras-de-negocio.md', 'docs/qualidade-seguranca.md', 'scripts/agent_loop.py') and explicitly declines to duplicate them ('Não copie essa página'). This matches the rubric's exception for short, self-contained skills with well-organized sections.

5 / 5

Total

17

/

20

Passed

Description

82%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 well-crafted trigger description: it states an explicit 'Use when' condition with natural, concrete trigger terms and a single clear action. The main limitation is that it describes only one capability, leaving the 'what' slightly thin, and it omits a few common synonyms (e.g., endpoint, REST, Swagger) that users might naturally say.

DimensionReasoningScore

Specificity

The description names the domain ('HTTP API, an OpenAPI spec, or routes covered by contract tests') and one concrete action ('Run Schemathesis against the spec before calling the task done'), matching the 'domain and 1-2 concrete actions, but not comprehensive' anchor. It is not a 4 because only a single capability is listed, not several specific actions.

3 / 5

Completeness

It explicitly answers both: what ('Run Schemathesis against the spec before calling the task done') and when ('Use when the task changes an HTTP API, an OpenAPI spec, or routes covered by contract tests'), with concrete trigger phrases — the exact pattern of the anchor-5 good example. Not a 4, because the 'when' clause is already explicit and specific rather than only improvable.

5 / 5

Trigger Term Quality

Natural trigger phrases users would say are present: 'changes an HTTP API', 'an OpenAPI spec', 'routes covered by contract tests'. Good keyword coverage, but common variations like 'endpoint', 'REST', or 'Swagger/OpenAPI definition' are missing, so it falls between the 3 and 5 anchors — closer to the 4 anchor's 'a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Schemathesis contract testing against the OpenAPI spec) with distinct triggers unlikely to fire for unrelated skills; the only conceivable overlap is with a generic 'testing' skill, which is minimal.

5 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

fazedordecodigo/python-api-validation-discovery

Path

.claude/skills/schemathesis-api/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.