CtrlK
BlogDocsLog inGet started
Tessl Logo

review-cycle

Unified multi-dimensional code review with automated fix orchestration. Supports session-based (git changes) and module-based (path patterns) review modes with 7-dimension parallel analysis, iterative deep-dive, and automated fix pipeline. Triggers on "workflow:review-cycle", "workflow:review-session-cycle", "workflow:review-module-cycle", "workflow:review-cycle-fix".

62

Quality

73%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./.codex/skills/review-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.

The description is technically detailed and specific about capabilities, with explicit trigger guidance. Its main weakness is that the trigger terms are structured workflow commands rather than natural language terms a user would use, which limits discoverability in natural conversation. The description is well-structured but leans heavily on domain-specific terminology.

Suggestions

Add natural language trigger terms alongside the workflow commands, e.g., 'Use when the user asks for code review, wants to review git changes, or needs automated code fixes'

Include common user phrasings like 'review my code', 'check for issues', 'fix code problems' to improve matching with natural user requests

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: session-based and module-based review modes, 7-dimension parallel analysis, iterative deep-dive, automated fix pipeline, and fix orchestration. These are concrete, specific capabilities.

3 / 3

Completeness

Clearly answers both 'what' (multi-dimensional code review with automated fix orchestration, session-based and module-based modes, 7-dimension analysis) and 'when' (explicit triggers listed with 'Triggers on' clause specifying exact workflow commands).

3 / 3

Trigger Term Quality

The trigger terms are explicit workflow commands ('workflow:review-cycle', etc.) which are useful for programmatic invocation but are not natural keywords a user would say. A user would more likely say 'review my code', 'code review', 'fix issues', or 'review changes' rather than these structured workflow identifiers.

2 / 3

Distinctiveness Conflict Risk

The description carves out a very specific niche with distinct workflow trigger commands and a unique combination of features (7-dimension analysis, session vs module modes, fix orchestration). Unlikely to conflict with other skills due to the highly specific trigger terms.

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 excels at actionability and workflow clarity with concrete code, clear phase sequencing, and robust error handling. However, it severely suffers from verbosity — the same 9-phase pipeline is described three times (architecture diagram, execution flow, data flow) and substantial content that belongs in phase reference files is inlined. The skill would benefit greatly from aggressive deduplication and moving reference material (API docs, error tables, progress tracking patterns) into supporting files.

Suggestions

Remove redundant pipeline descriptions: keep only the Execution Flow section and eliminate the Architecture Overview ASCII diagram and Data Flow section, which repeat the same phase sequence.

Move the Subagent API Reference, Progress Tracking Pattern, and Error Handling sections to separate reference files (e.g., subagent-api.md, error-handling.md) and link to them from SKILL.md.

Move the Phase 7.5 inline code to its own phase file (phases/07.5-export-task-json.md) consistent with other phases.

Consolidate the Core Rules and Key Design Principles sections — they overlap significantly (e.g., both mention progressive phase loading, auto-continue, fix pipeline optionality).

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines. It includes massive ASCII diagrams, redundant data flow descriptions (the architecture diagram, execution flow, and data flow sections all repeat the same phase sequence), extensive progress tracking boilerplate, and detailed error handling tables. Much of this could be condensed or moved to reference files. The subagent API reference section explains basic API usage Claude could infer from function signatures.

1 / 3

Actionability

The skill provides concrete, executable code examples throughout: spawn_agent calls with exact parameters, mode detection logic, progress tracking patterns with exact function calls, CLI commands, and specific JSON schemas for task export. The Phase 7.5 inline code is fully executable with clear input/output mappings.

3 / 3

Workflow Clarity

The multi-phase workflow is exceptionally well-sequenced with clear phase transitions, conditional branching (Phase 3→4 vs 3→5), explicit validation checkpoints (100% test pass rate in Phase 8, rollback on failure), error handling tables with blocking/non-blocking classification, and feedback loops (Phase 4 loops back to Phase 3 aggregation). The timeout escalation pattern for subagents is a strong validation mechanism.

3 / 3

Progressive Disclosure

The skill correctly references 9 phase documents as one-level-deep references with a clear table mapping phases to files. However, the SKILL.md itself is monolithic with too much inline content that should be in those phase files (e.g., the full subagent API reference, detailed progress tracking patterns, error handling tables). The Phase 7.5 code is inline when it could be a separate file. Without bundle files provided, the referenced phase documents cannot be verified.

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

skill_md_line_count

SKILL.md is long (509 lines); consider splitting into references/ and linking

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.