CtrlK
BlogDocsLog inGet started
Tessl Logo

api-tester

Expert API testing specialist focused on comprehensive API validation, performance testing, and quality assurance across all systems and third-party integrations

39

Quality

24%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./test-writer/skills/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

22%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description reads more like a job title or resume headline than a functional skill description. It relies on abstract buzzwords ('comprehensive', 'expert', 'quality assurance') without specifying concrete actions or providing explicit trigger conditions. The lack of a 'Use when...' clause and the vague capability language make it difficult for Claude to reliably select this skill at the right time.

Suggestions

Replace vague phrases with concrete actions, e.g., 'Sends HTTP requests to API endpoints, validates response codes and payloads, measures response times, and generates test reports.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about testing APIs, validating endpoints, checking HTTP responses, load testing, or debugging REST/GraphQL services.'

Remove the 'Expert' framing and first-person-adjacent tone ('specialist focused on') in favor of third-person action verbs describing what the skill does.

DimensionReasoningScore

Specificity

The description uses vague, buzzword-heavy language like 'comprehensive API validation', 'performance testing', and 'quality assurance' without listing any concrete actions. It doesn't specify what it actually does (e.g., send requests, validate response codes, measure latency, generate test suites).

1 / 3

Completeness

The description partially addresses 'what' (API testing/validation) but in very vague terms, and completely lacks any 'when' clause or explicit trigger guidance. The absence of a 'Use when...' clause caps this at 2 per the rubric, but the 'what' is also weak enough to warrant a 1.

1 / 3

Trigger Term Quality

It includes some relevant keywords like 'API testing', 'performance testing', 'quality assurance', and 'third-party integrations' that users might mention. However, it misses common natural terms like 'REST', 'endpoint', 'HTTP', 'status code', 'load testing', 'Postman', or specific file/tool references.

2 / 3

Distinctiveness Conflict Risk

The focus on 'API testing' provides some specificity, but phrases like 'quality assurance across all systems' and 'third-party integrations' are broad enough to overlap with general testing skills, integration skills, or QA-focused skills.

2 / 3

Total

6

/

12

Passed

Implementation

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill reads more like an AI persona/character sheet than an actionable technical skill. It is heavily padded with identity descriptions, communication style guidance, success metrics, and motivational framing that waste tokens without adding value. While the JavaScript test example provides some concrete guidance, the majority of the content is abstract and could be dramatically condensed into a focused, actionable testing guide with proper file references.

Suggestions

Remove all persona/identity/personality sections (Identity, Communication Style, Learning & Memory, Success Metrics) — these waste tokens and don't help Claude execute tasks better.

Split the monolithic document: move the test suite example to a EXAMPLES.md file, the report template to TEMPLATES.md, and advanced capabilities to ADVANCED.md, with clear one-level references from the main skill.

Replace abstract workflow steps ('Catalog all internal and external APIs') with concrete, executable commands and tool-specific instructions (e.g., specific k6 load test scripts, specific CLI commands for running test suites).

Add explicit validation checkpoints and feedback loops to the workflow, e.g., 'Run security scan → review findings → fix critical issues → re-scan before proceeding to performance testing.'

DimensionReasoningScore

Conciseness

Extremely verbose with extensive personality/identity sections, communication style guidance, success metrics, and learning/memory instructions that Claude doesn't need. The 'personality' framing adds significant bloat. Much of the content describes what the agent *is* rather than what to *do*. The document could be reduced by 60%+ without losing actionable content.

1 / 3

Actionability

The JavaScript test suite example is fairly concrete and near-executable, which is valuable. However, much of the skill is abstract guidance ('Develop and implement complete API testing frameworks', 'Execute load testing') rather than specific commands or copy-paste-ready code. The workflow steps are high-level descriptions, not concrete instructions with specific tools and commands.

2 / 3

Workflow Clarity

The 4-step workflow process is listed with a logical sequence (Discovery → Strategy → Implementation → Monitoring), but lacks validation checkpoints, feedback loops, or error recovery steps. For a skill involving security testing and destructive/batch operations, the absence of explicit validation gates between steps is a notable gap.

2 / 3

Progressive Disclosure

The entire skill is a monolithic wall of text with no references to external files. All content—from test examples to report templates to advanced capabilities—is inlined in a single document. The vague closing line about 'core training' is not a useful reference. Content like the full test suite, report template, and advanced capabilities sections should be split into separate files.

1 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
OpenRoster-ai/awesome-openroster
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.