CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orchestrate

Use when driving one or more tasks end to end from the local bare repo's `main` worktree — a feature designed with the user first when its scope is open, or a ready list of tasks — ordering them, cutting a worktree per task, handing each to a subagent that runs new-feat, running prep-pr with every finding fixed rather than reported, and shepherding each pull request to a squash merge and worktree teardown. Not for a one-file change, and not outside the bare repo.

Quality

89%

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

81%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 unusually well-engineered orchestration procedure: every step is executable, validation is baked into each stage, and error recovery is specified for every terminal state. The weakness is token efficiency — the ~286-line body carries justification prose and stale-prone statistics ('64% today', '85.8% today') that belong in a reference file or should be trimmed.

Suggestions

Move the precondition's bare-repo-vs-main rationale (gitBranch attribution mechanics, the 64%/85.8% spend figures) into `references/` alongside gotchas.md, keeping only the two expect-style check commands and the stop message in SKILL.md.

Replace the time-sensitive statistics ('currently sits', 'today') with the durable rule they justify, or move them to a metrics reference — they will silently go stale and mislead later runs.

Merge the TASK-BRANCH warning blockquote with Step 3's dispatch-contract bullet on the same marker; they state the same attribution mechanics twice, and one authoritative statement would cut ~20 lines.

DimensionReasoningScore

Conciseness

The body is dense with genuinely operational, repo-specific knowledge rather than concepts Claude already knows, but several passages could be tightened: the precondition section spends three paragraphs justifying `main/` over the bare root, and time-sensitive figures ('64% of this repository's recorded token spend currently sits', 'It is 85.8% of subagent spend today') pad the text and will go stale. The long TASK-BRANCH warning blockquote also repeats attribution mechanics already stated in Step 3.

3 / 5

Actionability

Fully executable throughout: exact commands (`git worktree add ... -b <prefix>/<dir> origin/main`, `gh pr view <n> --json mergeStateStatus,statusCheckRollup,state`, `gh pr merge <n> --squash --delete-branch`, `bun run --cwd tools/pr-metrics backfill -- --dry-run`), a concrete dispatch contract with verbatim required lines (`TASK-BRANCH: <branch>`), and an explicit `NEEDS INPUT: <question> + options + recommendation` protocol covering the common cases.

5 / 5

Workflow Clarity

Steps 00, 0, and 1–5 are clearly sequenced with explicit validation checkpoints everywhere: the ORCHESTRATE.md blackboard with 'NOT RUN' as an honest gate value, Step 4's mechanical verification before trusting any report, explicit error-recovery branches (DIRTY/BEHIND → rebase, check failure → fix subagent → re-poll, never merge red), and a dedicated subagent-death recovery procedure.

5 / 5

Progressive Disclosure

Good structure: the full gotcha table is deferred to `references/gotchas.md` (which exists, one level deep, clearly signalled: 'The full table, with the reason behind each, is `references/gotchas.md`. The ones that cost a run') with only the top five inlined, and wiki conventions are referenced by path. Minor gaps: the long precondition rationale and attribution-warning blockquote are inlined operational lore that could live in a reference file like the gotchas do.

4 / 5

Total

17

/

20

Passed

Description

92%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, comprehensive actions with an explicit 'Use when' trigger and clear negative boundaries that separate it from related single-task skills. The only gap is that natural trigger-term coverage lacks synonyms and common user phrasings beyond 'driving tasks end to end'.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'ordering them, cutting a worktree per task, handing each to a subagent that runs new-feat, running prep-pr with every finding fixed rather than reported, and shepherding each pull request to a squash merge and worktree teardown' — which comprehensively covers the skill's capabilities with no vague filler.

5 / 5

Completeness

It explicitly answers both: what ('ordering them, cutting a worktree per task, handing each to a subagent...shepherding each pull request to a squash merge and worktree teardown') and when ('Use when driving one or more tasks end to end from the local bare repo's `main` worktree'), plus explicit negative triggers ('Not for a one-file change, and not outside the bare repo') matching the top anchor.

5 / 5

Trigger Term Quality

Good natural-phrase coverage ('driving one or more tasks end to end', 'a ready list of tasks', 'pull request', 'worktree', 'feature'), but synonyms and common variations a user might say (e.g. 'coordinate tasks', 'run this list of changes', 'multi-task') are missing, so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche — multi-task orchestration from the local bare repo — with distinct triggers and explicit boundaries separating it from sibling skills ('Not for a one-file change, and not outside the bare repo'), so it is unlikely to fire for the wrong skill.

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

englishstreetventures/englishstreetventures.com

Path

.claude/skills/orchestrate/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.