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. Also the route for a request to review and fix an open pull request another tool or session wrote, through review-pr. Not for a one-file change, and not outside the bare repo.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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 exceptionally concrete, well-validated orchestration procedure whose commands, exit codes, and recovery paths are copy-paste ready and whose checkpoints are explicit. Its cost is length and repetition: motivational rationale, stale-prone statistics, and a triple-explained attribution mechanism push it past what the orchestrator's own 'context is the scarce one' doctrine allows.

Suggestions

Move the time-sensitive repo statistics ("64% of this repository's recorded token spend currently sits in that anonymous HEAD pool", "85.8% of subagent spend today") into references/gotchas.md or the session-metrics wiki page, keeping a one-line summary in the body — the numbers will silently go stale and they justify rather than instruct.

Consolidate the TASK-BRANCH explanation, which is given in full in the Precondition warning, again as Step 3's first dispatch bullet, and again in the closing-summary rules, into one normative statement plus short back-references.

Trim the Precondition section's three-paragraph rationale for preferring main/ over the bare root to one or two lines — the commands, the expected outputs, and the failure message already carry the operational content.

DimensionReasoningScore

Conciseness

The body is dense and operational — it never explains concepts Claude already knows — but it is not lean: the precondition section spends three paragraphs justifying why main/ beats the bare root, the TASK-BRANCH mechanism is explained fully three times (warning block, Step 3 first bullet, closing-summary rules), and time-sensitive repo statistics ("64% of this repository's recorded token spend currently sits in that anonymous HEAD pool", "It is 85.8% of subagent spend today") are inlined where they will silently go stale. That is more than the minor trimmable over-explanation of the 4 anchor, but well above the generic-padding of a 2.

3 / 5

Actionability

Nearly everything is copy-paste executable: exact fetch refspecs ("git -C /Users/ac/.work/osn.git fetch origin '+refs/heads/main:refs/remotes/origin/main'"), worktree creation ("git worktree add … -b <prefix>/<dir> origin/main"), gh api checks with --jq filters, "bash scripts/wait-pr.sh <n> 30 # exit 0 done, 1 needs action, 2 no verdict by the deadline, 3 cannot answer", and a fully specified ORCHESTRATE.md block template with an example. The common cases are covered with specific commands and exit-code contracts.

5 / 5

Workflow Clarity

The sequence is explicit (Step 00 → 0 → 1–5 per task, with adoption and subagent-death variants), validation checkpoints appear at every boundary ("No subagent's stated verification counts" mechanical checks before reading a report, "test -e every path a dispatch names", gates and premise checks before dispatch), and error-recovery feedback loops are enumerated (red check → shepherd → fix subagent → re-poll; DIRTY/BEHIND → rebase → force-with-lease; merge-queue group failure → regenerate migration). Every wait names terminal states and a deadline, matching and exceeding the explicit-validation anchor.

5 / 5

Progressive Disclosure

The one bundle reference is real and well used: "The full table, with the reason behind each, is `references/gotchas.md`" keeps only the six costliest gotchas inline — genuine, working progressive disclosure — and external pointers (wiki pages, scripts/wait-pr.sh, .claude/agents/shepherd.md) are one level deep and clearly signaled. It falls short of the 5 anchor because the ~440-line body also inlines four auxiliary procedures (adoption, subagent death, question handling, the wait policy) that could partly live in reference files, leaving the main loop to carry them.

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, highly specific description that answers what, when, and when-not with concrete, verifiable actions rather than abstractions. Its only weakness is trigger phrasing breadth: one canonical wording per scenario with no synonyms, which slightly narrows natural recall.

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" — covering the full pipeline from ordering through merge and teardown, plus the adopt-an-open-PR route. This matches the comprehensive-coverage anchor; a 4 would require visible gaps in the action list, and none are present.

5 / 5

Completeness

It explicitly answers both questions: what it does (order, cut worktrees, dispatch to new-feat subagents, run prep-pr with findings fixed, shepherd PRs to squash merge, tear down worktrees) and when to use it, opening with "Use when driving one or more tasks end to end" and naming three concrete trigger scenarios (open-scope feature, ready task list, review-and-fix request) plus explicit exclusions. This matches the anchor that clearly answers both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present — "driving one or more tasks end to end", "a ready list of tasks", "review and fix an open pull request", "Not for a one-file change" — which is good keyword coverage. It falls short of the 5 anchor because it offers few synonyms or alternate phrasings (e.g. orchestrate, work through the backlog, batch of tasks), and the heavy qualifier chain before the first trigger phrase dilutes them.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — end-to-end multi-task orchestration from the local bare repo's main worktree — and its boundaries are explicit: "Not for a one-file change, and not outside the bare repo," with new-feat/prep-pr-in-place and review-pr named as the alternatives rather than overlapping triggers. Minimal conflict risk, matching the distinct-trigger anchor.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

15

/

16

Passed

Repository

englishstreetventures/osn

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.