CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gen-ut

Generate standard unit tests for one or more target classes in Apache ShardingSphere; cover requested behavior and every affected SUT-owned branch, enforce an explicitly requested numeric coverage target, and pass quality gates; perform explicit merge analysis, suitability filtering, and refactor optimization for parameterized tests.

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

88%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.

An unusually disciplined, rule-driven skill body: maximally token-efficient, with a clearly sequenced workflow, explicit validation gates, and a complete failure-handling loop. Actionability and progressive disclosure are strong but not perfect because executable commands and some decision specifics live in external files, and bundle script navigation is indirect.

Suggestions

Inline the two or three most-used verification commands (e.g. the scanner invocation and focused-coverage command) directly in SKILL.md so the core loop is executable without first opening references/verification.md.

Link the bundle scripts directly from SKILL.md with relative paths (scripts/scan_quality_rules.py, scripts/guard_task_scope.py) instead of relying on repo-root paths buried in verification.md.

Summarize the key external CODE_OF_CONDUCT.md thresholds relied on for decisions (minimum scenario count for parameterization, grouping rule essence) inline so R8/R15 decisions do not stall on an unresolvable external file.

DimensionReasoningScore

Conciseness

The body is exceptionally lean and normative — every line is a rule, resolution step, or state definition (e.g. "`R10-D`: work remains; continue instead of claiming completion.", "Exclude Lombok-generated behavior without custom logic.") with zero concept explanations or padding. It fully assumes Claude's competence, matching the 5 anchor where every token earns its place.

5 / 5

Actionability

Guidance is concrete and specific (exact `<TargetClassName>Test` convention, the four R8 high-fit conditions, the R10 state machine with priority ordering), but the actual executable commands are delegated to references/verification.md and key specifics (grouping rules, minimum scenario counts) to the external CODE_OF_CONDUCT.md. This is mostly executable guidance with minor gaps (4) rather than fully copy-paste-ready (5), and well above the pseudocode/incomplete level (3).

4 / 5

Workflow Clarity

The 11-step workflow is clearly sequenced with explicit validation checkpoints (task scope baseline capture before editing, per-edit focused tests and Checkstyle, final coverage/gates, scope-vs-baseline confirmation, a single R10 decision) and a full error-recovery feedback loop in R11 (blocking vs. nonblocking classification, retry transient failures at most twice, re-run invalidated checks). This matches the 5 anchor: explicit validation steps, feedback loops, and checklists (R15 gates, rule-to-evidence output mapping).

5 / 5

Progressive Disclosure

The body is well organized into sections and references/verification.md (a real file) is clearly signaled twice as a one-level-deep link. However, the bundle's scripts (guard_task_scope.py, scan_quality_rules.py) are only reachable via repo-root paths inside verification.md rather than direct links from SKILL.md, and the cross-skill links (../code-implementation/SKILL.md, ../../../CODE_OF_CONDUCT.md) do not resolve within the bundle. Good structure with minor organization gaps matches 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Description

75%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 highly specific, domain-anchored description that clearly states what the skill does with concrete, jargon-appropriate actions. Its main weakness is the complete absence of "when to use" trigger guidance, which caps completeness, and slightly thin natural-language synonym coverage.

Suggestions

Append a trigger clause such as "Use when the user asks to generate, write, or improve unit tests for ShardingSphere classes, raise test coverage (CLASS/LINE/BRANCH), or refactor tests into parameterized form."

Include common natural synonyms and tool names users would say — e.g. "write tests", "test coverage", "JUnit", "Mockito" — alongside the existing terminology.

State when NOT to use it (e.g. integration/E2E test generation) to further reduce overlap with neighboring test-related skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions comprehensive for its domain: "Generate standard unit tests", "cover requested behavior and every affected SUT-owned branch", "enforce an explicitly requested numeric coverage target", "perform explicit merge analysis, suitability filtering, and refactor optimization for parameterized tests". It matches the 5 anchor (multiple specific concrete actions, comprehensive) rather than 4, which would require minor gaps in action coverage.

5 / 5

Completeness

The "what" is clear and concrete (generate unit tests, cover SUT-owned branches, enforce coverage targets, pass quality gates, parameterization analysis), but there is no "Use when..." clause or any equivalent explicit trigger guidance, which the rubric explicitly caps at 3. It fits the 3 anchor (clear what, when missing) rather than 4.

3 / 5

Trigger Term Quality

Natural phrases a user would say are present ("unit tests", "coverage target", "parameterized tests", "Apache ShardingSphere") but common synonyms and tool names are missing ("write tests", "test coverage", "JUnit", "Mockito"). Good keyword coverage with a few natural terms missing matches 4; it is not 5 because synonym/extension coverage is incomplete, and not 3 because all core natural phrases appear.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a specific project ("Apache ShardingSphere") and a specific workflow (unit-test generation with branch coverage and parameterized-test refactor analysis), giving a clear niche with distinct triggers and minimal conflict risk with generic test-generation skills. This matches the 5 anchor rather than 4, where minor overlap risk would remain.

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

apache/shardingsphere

Path

.codex/skills/gen-ut/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.