CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

quintet-headless-worktrees

Orchestrate multiple coding-agent CLIs (codex/gemini/copilot/claude) headlessly — each in its own git worktree, driven non-interactively (one-shot, not interactive REPLs; each worker runs in a tmux window by default so its output stays visible), then merged. Use when fanning real implementation or review work out to several model CLIs in parallel without driving interactive REPLs, when you need worktree isolation so agents don't collide, or when distributing token cost onto external providers. Trigger on "run codex/gemini/copilot in parallel", "headless multi-agent", "git worktree per agent", "non-interactive CLI agents", "offload work to other model CLIs", "parallel build with isolated worktrees". For interactive tmux worker teams use quintet-team-runtime instead; for one-shot opinions use quintet-fleet-dispatch.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

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

An exemplary operational skill body: executable commands throughout, an explicit verify-before-merge workflow with a 4-point validation checklist and a symptom/cause/fix recovery table, and dense non-obvious gotchas (symlink trap, EROFS, warmup-swallow) instead of padding. Minor room remains in trimming a few wordy passages and offloading the per-CLI reference table and tmux recipe to bundle files.

Suggestions

Move the per-CLI headless invocation table and the full tmux execution recipe into a references/ file (e.g., references/cli-invocation.md), keeping SKILL.md to the core model and decision guidance.

Tighten the multi-clause parenthetical sentences in Primitive 4 and the 'When to use this vs. the alternatives' section — the same facts can be stated in fewer tokens.

Reconcile the CLI list between the description (codex/gemini/copilot/claude) and the body's invocation table (codex/agy/copilot/claude/qwen/opencode) so users aren't misled about supported tools.

DimensionReasoningScore

Conciseness

The body is lean in the ways that matter — it explains no basic concepts (no 'what is a git worktree' filler) and every section delivers non-obvious operational knowledge like the '.gitignore with node_modules/ (trailing slash) matches a directory, not a symlink' trap and the 'git index lives in the main repo's .git/worktrees/<name>/, which is outside the worktree sandbox' EROFS explanation. A few long parenthetical passages (e.g., the multi-clause sentences in Primitive 4 and the alternatives section) could be tightened without losing content, matching anchor 4 rather than the every-token-earns-its-place of 5.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: the complete 'quintet worktrees' CLI block with status/merge/abort subcommands, concrete tmux commands ('tmux new-window -t "=$sess" -n "wt1-codex" -c "$WT1" "codex exec -C '$WT1' -s workspace-write ... 2>&1 | tee '$WT1/.agent.log'"'), 'git worktree add -b <branch> <dir> <base>' setup, and the brief-file pattern ('cp brief.txt "<dir>/.brief.txt"'). A per-CLI invocation table with exact headless forms and auto-approve flags covers all common cases, matching anchor 5.

5 / 5

Workflow Clarity

The sequence is explicit (dispatch with numbered steps 1-3 in the first-class CLI section, then verify-and-merge) and validation is emphatic and itemized: 'Never trust a worker's exit 0' with a 4-point in-order verification checklist (commit scope, leak scan, build green, 'grep the build output for secret values'). Feedback loops are present throughout — the 'abort and clean up in case of failure' command, 'amend out any leak' recovery, and the failure-mode quick-reference table mapping symptoms to fixes — matching anchor 5.

5 / 5

Progressive Disclosure

Structure is good: a clear overview ('The core model' diagram, 'When to use this vs. the alternatives'), well-labeled sections (Primitive 1-8), and navigable tables. But the ~156-line body keeps everything inline with no bundle files — the per-CLI headless invocation table and the tmux execution recipe are reference-style material that could be split into a references/ file, which is the minor organization gap that holds this at anchor 4 rather than a 5 with appropriately split content.

4 / 5

Total

18

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete multi-action capability statement, explicit 'Use when' triggers with six natural phrases, and explicit disambiguation from two sibling skills. The only deduction is the second-person 'when you need worktree isolation' clause, which the rubric penalizes on specificity.

Suggestions

Rewrite the 'when you need worktree isolation' clause in third person (e.g., 'Use when worktree isolation is needed so agents don't collide') to avoid the second-person penalty.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('Orchestrate multiple coding-agent CLIs (codex/gemini/copilot/claude) headlessly', 'each in its own git worktree, driven non-interactively', 'then merged') which matches the anchor-5 example of comprehensive concrete actions. However, the second-person phrasing 'when you need worktree isolation so agents don't collide' violates the third-person-voice rule, incurring the mandatory 1-point reduction, so it is not a 5.

4 / 5

Completeness

It explicitly answers both what ('Orchestrate multiple coding-agent CLIs... headlessly... then merged') and when ('Use when fanning real implementation or review work out to several model CLIs in parallel... when you need worktree isolation... or when distributing token cost onto external providers'), with concrete trigger phrases — the exact anchor-5 pattern of the good example.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive with natural phrases and synonyms: 'run codex/gemini/copilot in parallel', 'headless multi-agent', 'git worktree per agent', 'non-interactive CLI agents', 'offload work to other model CLIs', 'parallel build with isolated worktrees'. A user needing this skill would plausibly say several of these verbatim, matching the anchor-5 example's breadth (e.g., 'PDF files, PDFs, forms, .pdf').

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (headless, worktree-isolated, merge-oriented multi-CLI orchestration) and explicitly disambiguates sibling skills: 'For interactive tmux worker teams use quintet-team-runtime instead; for one-shot opinions use quintet-fleet-dispatch.' Triggers name specific tools and the worktree/headless mechanism, so wrong-skill triggering risk is minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

salemaziel/omc-octo-quintet

Path

skills/quintet-headless-worktrees/SKILL.md

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.