CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

api-testing

REST and GraphQL API testing with Playwright. Use when testing APIs, mocking endpoints, validating responses, or integrating API tests with E2E flows.

Quality

84%

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

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 highly actionable, code-first skill body with executable examples across all major API-testing scenarios and minimal wasted prose. Its main structural weakness is duplication: the GraphQL and schema-validation sections restate what the provided reference files cover, undercutting progressive disclosure and token efficiency.

Suggestions

Replace the inline GraphQL Query/Mutation and Ajv schema-validation sections with one-example summaries pointing to references/graphql-testing.md and references/schema-validation.md, keeping only a single canonical example each.

Add a brief 'Running tests' note (e.g., `npx playwright test --project=api`) so the setup-to-execution workflow has an explicit final validation step.

Move the Quick Start after Installation/Configuration, or fold installation into Quick Start, so the setup sequence reads in execution order.

DimensionReasoningScore

Conciseness

The body is lean: headings plus executable code with almost no explanatory prose — it assumes Claude's competence ('Playwright includes API testing - no extra packages needed' is the extent of the orientation) and never explains concepts Claude already knows. Not level 5 because sections like Response Validation (Ajv) and GraphQL basics duplicate content shipped in references/schema-validation.md and references/graphql-testing.md, so some tokens don't earn their place twice.

4 / 5

Actionability

Every section is copy-paste-ready TypeScript against Playwright's real API (`request.get/post/put/delete`, `page.route(...).fulfill`, `multipart` upload, `beforeAll` token capture), covering all the common REST/GraphQL cases including auth, mocking, error simulation, and schema validation. This matches the level-5 anchor — fully executable examples covering the common cases — and exceeds level 4 where concrete code has minor gaps.

5 / 5

Workflow Clarity

There is a coherent setup sequence (Quick Start → Installation → Configuration → topic recipes) and the test examples embed verification via `expect(...)` assertions, e.g. the delete test verifies with a follow-up 404 check. Not level 5 because there is no explicit run/validation instruction (e.g., `npx playwright test`) or error-recovery guidance; not level 3 because the sequence is clear and checkpoints are present implicitly in the assertion-based examples, and no destructive/batch operations are involved.

4 / 5

Progressive Disclosure

A References section clearly signals two real, one-level-deep files ('references/graphql-testing.md - Advanced GraphQL patterns', 'references/schema-validation.md - JSON Schema with Ajv'), but the body inlines substantial GraphQL and Ajv schema-validation content that directly duplicates those files — content that should live in the separate files is inline. This matches the level-3 anchor ('content that should be separate is inline') rather than level 4, where content placement is mostly appropriate.

3 / 5

Total

16

/

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' trigger clause and concrete, natural trigger terms. It clearly communicates both capability and invocation context, with only minor gaps in action specificity and synonym coverage.

Suggestions

Enumerate one or two more concrete capabilities (e.g., 'authenticate requests', 'validate response schemas') to lift specificity toward comprehensive coverage.

Add common user phrasings such as 'test endpoints' or 'API automation' as trigger synonyms.

DimensionReasoningScore

Specificity

The description names the domain ('REST and GraphQL API testing with Playwright') and lists several concrete actions ('mocking endpoints, validating responses, or integrating API tests with E2E flows'), but the actions themselves are moderately generic — it never reaches the comprehensive, multi-action specificity of the level-5 anchor. Not level 3 because it clearly goes beyond 1-2 actions; not level 5 because coverage is not comprehensive (e.g., no mention of auth handling or response schema validation, both prominent in the body).

4 / 5

Completeness

It explicitly answers both questions: 'what' ('REST and GraphQL API testing with Playwright') and 'when' with a concrete trigger clause ('Use when testing APIs, mocking endpoints, validating responses, or integrating API tests with E2E flows'). This matches the level-5 anchor — clear what AND when with concrete trigger phrases — and is well above the level-4 anchor where the 'when' could be more specific.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: 'testing APIs', 'mocking endpoints', 'validating responses', 'E2E flows', plus domain terms REST, GraphQL, and Playwright. Not level 5 because common variations are missing (e.g., 'API automation', 'endpoint testing', 'test endpoints'); not level 3 because keyword coverage is clearly good rather than partial.

4 / 5

Distinctiveness Conflict Risk

The Playwright + REST/GraphQL API-testing framing carves a fairly distinct niche with specific triggers. Not level 5 because API testing broadly overlaps with general testing skills and other E2E/automation skills, so minor overlap risk remains; not level 3 because the scope (Playwright-based, API-level, mocking) is well beyond 'somewhat specific'.

4 / 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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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