CtrlK
BlogDocsLog inGet started
Tessl Logo

workflow-test-fix-cycle

End-to-end test-fix workflow generate test sessions with progressive layers (L0-L3), then execute iterative fix cycles until pass rate >= 95%. Combines test-fix-gen and test-cycle-execute into a unified pipeline. Triggers on "workflow:test-fix-cycle".

78

Quality

73%

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 ./.codex/skills/workflow-test-fix-cycle/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

85%

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 is strong in specificity and distinctiveness, clearly articulating what the skill does and how it differs from related sub-skills. The main weakness is that the trigger term relies on a technical command string rather than natural language keywords a user might use, which could reduce discoverability in natural conversation. The completeness is good since it explicitly states both what and when, though the 'when' is command-oriented.

Suggestions

Add natural language trigger terms alongside the command trigger, e.g., 'Use when the user wants to run tests and automatically fix failures, or mentions test-fix workflow, automated testing pipeline, or iterative test fixing.'

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: generate test sessions with progressive layers (L0-L3), execute iterative fix cycles, specifies a pass rate threshold (>= 95%), and names the sub-skills it combines (test-fix-gen and test-cycle-execute).

3 / 3

Completeness

Clearly answers both 'what' (generate test sessions with progressive layers, execute iterative fix cycles until 95% pass rate, combines two sub-skills) and 'when' (triggers on 'workflow:test-fix-cycle'). The trigger is explicit even if it's a command-style trigger rather than natural language.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'test-fix-cycle', 'test sessions', 'fix cycles', and 'pass rate', but the primary trigger is a technical command string ('workflow:test-fix-cycle') rather than natural language terms a user would say. Missing natural variations like 'run tests', 'fix failing tests', 'test and fix'.

2 / 3

Distinctiveness Conflict Risk

Clearly distinguishable from other skills by specifying the unified pipeline nature, the L0-L3 progressive layers, the 95% pass rate threshold, and the specific trigger command. It even differentiates itself from its component skills (test-fix-gen and test-cycle-execute).

3 / 3

Total

11

/

12

Passed

Implementation

62%

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

This skill provides excellent actionability and workflow clarity with concrete code examples, explicit validation gates, and well-defined error handling. However, it is severely bloated—repeating agent listings, phase descriptions, and flow information across multiple sections. The content would benefit greatly from aggressive deduplication and moving reference material (subagent API, error tables, directory structures) into separate bundle files.

Suggestions

Deduplicate agent listings—they appear in Architecture Overview, Phase Execution, and Related Skills sections. Define them once and reference that section.

Move the Subagent API Reference section to a separate file (e.g., SUBAGENT_API.md) since it's reference material Claude can load on-demand.

Consolidate the Architecture Overview diagram, Execution Flow, and Phase Execution sections into a single concise flow—currently the same pipeline is described three different ways.

Move the Output Artifacts directory structure and Error Handling table to bundle reference files to reduce the main SKILL.md to an actionable overview.

DimensionReasoningScore

Conciseness

Extremely verbose at ~350+ lines. The ASCII architecture diagram, repeated agent listings across multiple sections (Phase Execution, Related Skills, Architecture Overview), redundant flow descriptions (Execution Flow section repeats what's in Architecture Overview and Phase Execution), and the full subagent API reference (which Claude likely already knows or could be in a separate file) all waste significant tokens. The same information about agents, phases, and strategies is restated 3-4 times throughout.

1 / 3

Actionability

Provides concrete, executable JavaScript code for spawn_agent/wait_agent/close_agent lifecycle, specific CLI usage examples with multiple modes, explicit directory structures, error handling patterns with try/catch, and functions.update_plan calls. The guidance is copy-paste ready and specific.

3 / 3

Workflow Clarity

The multi-step workflow is clearly sequenced with explicit phases, sub-phases, and numbered steps. Validation checkpoints are well-defined (MANDATORY CONFIRMATION GATE between phases, quality gates at IMPL-001.3 and IMPL-001.5, pass rate thresholds). Error handling table covers specific scenarios with concrete actions. Feedback loops (fix → re-test → decision) and strategy escalation (conservative → aggressive → surgical) are explicit.

3 / 3

Progressive Disclosure

References phase docs (phases/01-test-fix-gen.md, phases/02-test-cycle-execute.md) appropriately, but no bundle files are provided to verify these exist. The SKILL.md itself is monolithic with massive inline content that should be split into referenced files (e.g., the subagent API reference, the full directory structure, the error handling table). The architecture diagram and repeated agent listings bloat the main file.

2 / 3

Total

9

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

10

/

11

Passed

Repository
catlog22/Claude-Code-Workflow
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.