CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

recipe-add-integration-tests

Add integration/E2E tests to existing codebase using Design Docs

Quality

76%

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 ./dev-workflows-fullstack/skills/recipe-add-integration-tests/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 dense, well-sequenced orchestrator recipe: every step names its specialist subagent, exact input fields, expected output, and response gate, with explicit validation and feedback loops for revisions, stubs, and verification limits. The main weaknesses are mild — heavy reliance on named concepts from companion skills that are referenced but not summarized, and a single long file that could offload some gate detail to a reference.

DimensionReasoningScore

Conciseness

The body uses a telegraphic, directive style ("Skeleton generation → delegate to acceptance-test-generator", exact field mappings) that assumes Claude's competence and contains no concept explanations or padding. Minor tightening is possible — e.g. the dense Step 1 discovery paragraph and repeated "Apply Specialist Result Acceptance" phrasing — so it is not fully lean (not 5) but is clearly efficient (not 3).

4 / 5

Actionability

Concrete, near-copy-paste Agent invocation specs are given: exact subagent_type values ("dev-workflows-fullstack:acceptance-test-generator"), per-field prompt mappings, expected outputs (generatedFiles, testsAdded, mutationEvidence), and a commit message format ("test: add [layer] integration tests for [feature name]"). The gap: execution hinges on external guide concepts (HC-06, Specialist Result Acceptance, Commit Boundary Check) that are named but not summarized here (not 5), though the guidance is far more executable than high-level hints (not 3).

4 / 5

Workflow Clarity

Steps 1-7 are explicitly ordered with per-step response gates ("At least one changed integration/E2E test file ... → Proceed to Step 4"), status-based routing, and explicit feedback loops: needs_revision returns to Step 4 via the Review Resolution Gate, stub_detected returns to Step 3, and Step 7 defines a retry loop for retained verification limitations. Validation checkpoints are explicit throughout, matching the top anchor rather than the implicit-checkpoint anchor below it.

5 / 5

Progressive Disclosure

The single file is well organized with clear section headers and per-step subsections, and the one file reference is clearly signaled and one level deep ("read references/review-resolution.md from the loaded subagents-orchestration-guide skill"); no bundle files exist for this skill, so nothing is misplaced. At ~120 lines of dense inline gate logic, some gate detail could arguably live in a reference file, keeping it below the ideal split of anchor 5 (not 5) while structure is clearly good (not 3).

4 / 5

Total

17

/

20

Passed

Description

61%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 states a clear, distinct capability in a single tight clause, but it is minimal: one action, no trigger guidance, and no synonym coverage. Adding an explicit "Use when" clause and slightly broader action/keyword coverage would raise completeness, specificity, and trigger-term quality together.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to add integration or end-to-end tests to an existing implementation and a Design Doc exists" (addresses completeness).

Include common phrasings users would say — "end-to-end" spelled out, "test coverage", "acceptance tests" — so natural-language triggers match (addresses trigger_term_quality).

Name one or two more concrete actions, such as generating test skeletons from Design Docs or reviewing test quality before commit, to broaden capability coverage (addresses specificity).

DimensionReasoningScore

Specificity

"Add integration/E2E tests to existing codebase using Design Docs" names the domain and one concrete action with its input artifacts, but lists no further capabilities (no mention of skeleton generation, review, or commit). It is more than a bare domain label (not 2) but does not list several specific actions (not 4).

3 / 5

Completeness

The "what" is clear ("Add integration/E2E tests to existing codebase using Design Docs") but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by the Design Doc prerequisite. Per the judging guideline, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

"integration", "E2E", and "tests" are terms a user would naturally say when needing this skill, giving good keyword coverage. Common variations like "end-to-end" spelled out, "test coverage", or "acceptance tests" are missing, so it falls short of comprehensive (not 5) but is well above a single generic keyword (not 3).

4 / 5

Distinctiveness Conflict Risk

"using Design Docs" and "existing codebase" carve out a distinct niche that separates it from generic test-writing skills, leaving only minor overlap risk with closely related test recipes. It lacks the fully distinct trigger set of anchor 5 (not 5) but is clearly more specific than anchor 3 (not 3).

4 / 5

Total

14

/

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

shinpr/claude-code-workflows

Path

dev-workflows-fullstack/skills/recipe-add-integration-tests/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.