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
73%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./.codex/skills/review-cycle/SKILL.mdQuality
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
| Dimension | Reasoning | Score |
|---|---|---|
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).
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (509 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
5ff5e86
Table of Contents
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.