Content
78%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |