CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

recipe-add-integration-tests

Add integration/E2E tests to existing codebase using Design Docs

Quality

73%

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

The content is a tightly written orchestration recipe with explicit sequencing, response gates, and feedback loops for every failure mode, scoring near the top on workflow clarity. Its weaknesses are minor: externalized procedures from the subagents-orchestration-guide skill create small actionability gaps, and a few sentences could be trimmed. No bundle files exist, and all in-body references resolve to clearly named external skills.

DimensionReasoningScore

Conciseness

The body is dense and procedural with no concept-teaching padding, assuming orchestrator competence throughout ("Why Delegate" states rationale rather than explaining known concepts). A few long compound sentences, such as Step 1's document-discovery instructions, could be tightened, so it is not a 5.

4 / 5

Actionability

Concrete, executable guidance throughout: exact subagent_type strings, per-invocation field lists, a literal prompt template for Step 4, expected output schemas, and a specific commit message format ("test: add [layer] integration tests for [feature name]"). It falls short of fully copy-paste-ready because key procedures ("Specialist Result Acceptance", "Commit Boundary Check", HC-06) are externalized to another skill.

4 / 5

Workflow Clarity

Steps 1-7 are strictly ordered with an explicit response gate after every invocation, explicit status-based branching (pass/needs_revision/blocked, stub_detected/verification_incomplete), feedback loops (Step 5 fixes feeding Step 4 re-review, stub_detected returning to Step 3), and per-layer sequencing plus a retained-limitation retry in Step 7. This matches the anchor for clear sequence with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

A single well-sectioned file (Prerequisites, Execution Flow, per-step subsections) with one-level-deep references that are clearly signaled ("Execute Skill: subagents-orchestration-guide...", "read references/review-resolution.md from the loaded subagents-orchestration-guide skill"). The minor gap is that the only file reference points into another skill's bundle rather than this skill's own, which slightly complicates navigation, so it is not a 5.

4 / 5

Total

17

/

20

Passed

Description

53%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 is concrete and in third person, but it is a single-action summary of a multi-phase workflow and omits any usage trigger. Its main weakness is the missing "when" clause, which both limits completeness and weakens trigger-term quality. The "using Design Docs" qualifier gives it reasonable distinctiveness.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to add integration/E2E tests, write end-to-end tests, or add test coverage to an existing implementation and a Design Doc exists."

Broaden natural trigger terms to include variations users actually say: "end-to-end", "test suite", "test coverage", alongside "integration/E2E tests".

Summarize the scope of what the skill does (generate skeletons, implement, review, fix, quality-check, and commit tests) so the description's "what" matches the workflow's breadth.

DimensionReasoningScore

Specificity

"Add integration/E2E tests to existing codebase using Design Docs" names the domain and one concrete action but stops short of listing the several distinct actions the skill actually performs (skeleton generation, review, quality checks, commits). It matches the anchor for domain plus 1-2 concrete actions, not the level above which requires several specific actions.

3 / 5

Completeness

The description gives a clear "what" but contains no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the "what" is concrete rather than vague.

3 / 5

Trigger Term Quality

Terms like "integration" and "E2E tests" are natural phrases users would say, but common variations such as "end-to-end", "test coverage", or "write tests" are absent. This sits between "some relevant keywords" and "good keyword coverage", landing on the former.

3 / 5

Distinctiveness Conflict Risk

The qualifier "using Design Docs" and the scoping to "existing codebase" make it mostly distinct from generic test-writing skills with only minor overlap risk. It is not a 5 because it provides no distinct trigger phrases and could still collide with other test-related skills.

4 / 5

Total

13

/

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

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.