parallel-setup

One-time setup of parallel/ directory for multi-agent development

Install with Tessl CLI

npx tessl i github:jpoutrin/product-forge --skill parallel-setup

What are skills?

Review — 55%

Does it follow best practices?

If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:

npx tessl skill review --optimize ./path/to/skill

Learn more

Validation — 10 / 11 Passed

Validation for skill structure

SKILL.md

Review

Evals

Discovery

32%

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 identifies a specific domain (multi-agent development setup) but lacks critical completeness by omitting explicit trigger conditions. The description is too terse to help Claude confidently select this skill over others, and it doesn't specify what concrete actions the skill performs beyond generic 'setup'.

Suggestions

Add a 'Use when...' clause with explicit triggers like 'Use when initializing multi-agent workflows, setting up parallel execution directories, or when the user mentions parallel agents or concurrent Claude instances'

List specific concrete actions performed during setup, such as 'Creates parallel/ directory structure, initializes agent configuration files, sets up inter-agent communication paths'

Include natural keyword variations users might say: 'parallel agents', 'multi-agent setup', 'concurrent agents', 'agent workspace'

Dimension	Reasoning	Score
Specificity	Names the domain ('parallel/ directory', 'multi-agent development') and implies a setup action, but doesn't list specific concrete actions like creating files, configuring settings, or initializing structures.	2 / 3
Completeness	Describes what (setup of parallel directory) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.	1 / 3
Trigger Term Quality	Contains some relevant terms ('parallel/', 'multi-agent', 'setup') but misses common variations users might say like 'initialize agents', 'create parallel workspace', 'multi-agent config', or 'agent directory'.	2 / 3
Distinctiveness Conflict Risk	The 'parallel/ directory' and 'multi-agent' terms provide some specificity, but 'one-time setup' is generic and could overlap with other initialization or setup skills.	2 / 3
	Total	7 / 12 Passed

Implementation

77%

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

This is a solid setup skill with excellent actionability - every file to create is fully specified with exact content. The workflow is clear and appropriate for a one-time initialization task. Main weakness is some redundancy in showing directory structures multiple times and embedding lengthy file templates that could be more concise.

Suggestions

Reduce redundancy by showing the directory structure once, rather than in multiple places (execution steps, README content, and output summary)

Consider making the embedded README.md template more concise - Claude can generate appropriate documentation without a full template

Dimension	Reasoning	Score
Conciseness	The skill is reasonably efficient but includes some redundancy - the directory structure is shown multiple times (in execution steps, README content, and example output). The README.md content could be more concise since Claude can generate appropriate documentation.	2 / 3
Actionability	Provides fully executable guidance with exact file contents to create, specific bash commands, and complete file templates. Claude can copy-paste the README.md and .gitignore content directly.	3 / 3
Workflow Clarity	Clear 5-step sequence with explicit actions at each step. For a simple setup task, the workflow is unambiguous - create directory, create files, optionally update CLAUDE.md, report results. Idempotency note addresses safety.	3 / 3
Progressive Disclosure	Content is well-organized with clear sections, but the inline README.md template is lengthy and could be referenced externally. The skill is self-contained which is appropriate for a setup command, but the embedded documentation adds bulk.	2 / 3
	Total	10 / 12 Passed

Validation

90%

Warnings & errors only

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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Reviewed: 14 days ago

Table of Contents

Discovery Implementation Validation

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.