CtrlK
BlogDocsLog inGet started
Tessl Logo

parallel-dev-cycle

Multi-agent parallel development cycle with requirement analysis, exploration planning, code development, and validation. Orchestration runs inline in main flow (no separate orchestrator agent). Supports continuous iteration with markdown progress documentation. Triggers on "parallel-dev-cycle".

41

Quality

41%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./.codex/skills/parallel-dev-cycle/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

47%

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

This skill has excellent workflow clarity with well-defined phases, iteration loops, validation checkpoints, and error recovery. However, it is severely over-long for a SKILL.md — the discovery board protocol, full state schema, versioning details, and coordination tables should live in the referenced phase/role documents rather than inline. The actionability is moderate: usage examples and progress tracking are concrete, but the core agent spawning mechanism lacks executable code.

Suggestions

Move the Discovery Types table, full state JSON schema, versioning protocol, and coordination protocol details into their respective phase reference documents, keeping only a brief summary and pointer in SKILL.md.

Add executable code showing the actual subagent spawning API calls (e.g., the Codex subagent pattern) rather than just describing 'Spawn RA, EP, CD, VAS agents in parallel'.

Remove the ASCII architecture diagram and data flow diagram — the phase execution flow section already conveys the same information more concisely.

Consolidate the 'Key Design Principles' section into the existing content rather than listing them separately, as most principles are already demonstrated in the workflow sections.

DimensionReasoningScore

Conciseness

Extremely verbose at ~350+ lines. Contains extensive ASCII diagrams, redundant explanations of the same concepts (data flow repeated in multiple sections), detailed JSON schemas, and tables that could be in referenced files. Much of this content (discovery types table, full state JSON schema, versioning details) belongs in the phase reference documents rather than the main SKILL.md.

1 / 3

Actionability

Provides concrete code examples for progress tracking (functions.update_plan), state file JSON schema, discovery board format, and usage commands. However, the actual agent spawning mechanism is never shown with executable code — it references 'Spawn RA, EP, CD, VAS agents in parallel' without showing the actual subagent API calls. The PHASE_RESULT format is described but not shown as executable code.

2 / 3

Workflow Clarity

The four-phase workflow is clearly sequenced with explicit phase transitions, a coordinator checklist with before/after validation steps, iteration logic (loop back to Phase 2 if issues found), error handling table with recovery actions, and progress tracking at each transition. The feedback loop for iteration (Phase 3 → Phase 2) is explicitly documented with conditions.

3 / 3

Progressive Disclosure

References phase documents (phases/01-04) and role definitions (roles/) appropriately, and states 'read phase docs ONLY when that phase is about to execute.' However, the main SKILL.md itself is a monolithic wall containing extensive detail that should be in those referenced files — the full discovery types table, complete state JSON schema, versioning protocol, and coordination protocol all belong in sub-documents. No bundle files were provided to verify references exist.

2 / 3

Total

8

/

12

Passed

Description

35%

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 conveys the general concept of a multi-agent parallel development workflow but relies on abstract phase names rather than concrete actions. Its biggest weakness is the lack of natural trigger terms—it depends entirely on a synthetic command keyword rather than phrases users would naturally use. The 'when to use' guidance is minimal and mechanical.

Suggestions

Replace 'Triggers on parallel-dev-cycle' with a natural 'Use when...' clause describing scenarios like 'when the user wants to develop multiple features or components in parallel using sub-agents' or 'when asked to break down a large task into parallel workstreams'.

Add natural trigger terms users might say, such as 'parallel development', 'multi-agent coding', 'concurrent implementation', 'break into subtasks', or 'develop in parallel'.

Make the capability descriptions more concrete—e.g., 'Spawns parallel sub-agents for independent coding tasks, tracks progress in markdown files, and validates each component before merging results'.

DimensionReasoningScore

Specificity

Names the domain (multi-agent parallel development) and lists some actions (requirement analysis, exploration planning, code development, validation), but these are somewhat abstract phases rather than concrete, specific actions like 'parses requirements into subtasks' or 'spawns parallel coding agents'.

2 / 3

Completeness

The 'what' is partially addressed (multi-agent parallel development with phases listed), and there is a trigger clause ('Triggers on parallel-dev-cycle'), but the 'when' is essentially just a command keyword rather than a meaningful description of when Claude should select this skill.

2 / 3

Trigger Term Quality

The only explicit trigger is the synthetic keyword 'parallel-dev-cycle', which is not something a user would naturally say. It lacks natural language triggers like 'build feature in parallel', 'multi-agent coding', 'develop multiple components simultaneously', etc.

1 / 3

Distinctiveness Conflict Risk

The multi-agent parallel development concept is somewhat distinctive, and the specific trigger keyword 'parallel-dev-cycle' reduces accidental activation, but the broad terms like 'code development' and 'validation' could overlap with general coding or CI/CD skills.

2 / 3

Total

7

/

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.