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

Optimize this skill with Tessl

npx tessl skill review --optimize ./.codex/skills/parallel-dev-cycle/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

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 on the synthetic command 'parallel-dev-cycle' rather than describing scenarios where a user would naturally need this skill. The 'when' guidance is insufficient for organic skill selection.

Suggestions

Replace 'Triggers on parallel-dev-cycle' with a natural 'Use when...' clause, e.g., 'Use when the user wants to implement a feature using multiple parallel agents, or asks to break down and develop requirements concurrently.'

Add natural trigger terms users might say, such as 'parallel implementation', 'multi-agent coding', 'break down and build feature', 'concurrent development', 'implement in parallel'.

Make the listed actions more concrete, e.g., 'Breaks requirements into independent subtasks, spawns parallel coding agents, merges results, and runs validation tests' instead of abstract phase names.

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 listed phases), and there is a trigger mention ('Triggers on parallel-dev-cycle'), but this is a synthetic command rather than a genuine 'Use when...' clause describing natural scenarios. The 'when' is effectively missing for organic discovery.

2 / 3

Trigger Term Quality

The only explicit trigger is the synthetic term 'parallel-dev-cycle', which is not something a user would naturally say. It lacks natural keywords like 'build feature', 'implement', 'develop in parallel', 'multi-task coding', etc.

1 / 3

Distinctiveness Conflict Risk

The description is somewhat specific to multi-agent parallel development, which narrows the domain, but terms like 'requirement analysis', 'code development', and 'validation' are generic enough to overlap with other development or CI/CD skills. The synthetic trigger 'parallel-dev-cycle' helps distinctiveness but only if users know to use it.

2 / 3

Total

7

/

12

Passed

Implementation

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, and validation checkpoints, but suffers significantly from verbosity — it's a monolithic document that tries to serve as both a high-level orchestration guide and a detailed reference manual. The content would benefit greatly from moving detailed schemas, tables, and protocol specifications into the referenced phase/role documents, keeping SKILL.md as a lean orchestration overview.

Suggestions

Move the Discovery Types table, State Management JSON schema, Versioning details, and Coordination Protocol into separate reference files (e.g., coordination/protocol.md, state-schema.md) and replace with brief summaries + links

Remove the ASCII architecture diagram and Data Flow section — the Execution Flow section already conveys the same information more actionably

Consolidate redundant content: the session structure, state management, and data flow sections overlap significantly in describing the same directory/file layout

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 exhaustive tables that could be split into reference files. Much of this (state management JSON, discovery types table, versioning details) belongs in separate reference documents, not the main SKILL.md.

1 / 3

Actionability

Provides concrete structures (JSON schemas, file paths, NDJSON formats, usage examples) and specific commands, but much is descriptive architecture documentation rather than executable guidance. The progress tracking code snippets are actionable, but agent spawning mechanics and actual implementation steps are deferred to phase reference documents that aren't provided.

2 / 3

Workflow Clarity

The multi-phase workflow is clearly sequenced (Phase 1→2→3→4) with explicit iteration loops, validation checkpoints (Phase 3 detects issues and loops back), error handling table, and a coordinator checklist with before/after verification steps. The feedback loop for iteration (issues found → send feedback → re-execute Phase 2) is well-defined.

3 / 3

Progressive Disclosure

References to phase documents (phases/01-04) and role definitions (roles/) are well-signaled, but the main SKILL.md contains massive amounts of detail that should be in those reference files — the full discovery types table, complete state JSON schema, versioning protocol, and coordination protocol all belong in separate documents. The skill tries to be both overview and reference simultaneously.

2 / 3

Total

8

/

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.