CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

68

Quality

83%

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 exceptionally actionable, well-sequenced orchestration workflow with genuine validation checkpoints and error-recovery loops, and a clean one-level reference bundle. The main cost is conciseness: embedded war stories and dated spend statistics pad an otherwise lean document and will age.

Suggestions

Move the gitBranch attribution rationale and the bare-repo/session-metrics spend story into a reference file (e.g. references/attribution.md) and keep only the operational rule plus a pointer in SKILL.md.

Drop or timestamp the volatile statistics ("64% of this repository's recorded token spend", "85.8% of subagent spend today") — they are time-sensitive and belong in a metrics wiki page, not the skill body.

Trim anecdotal justifications ("A whole task has been lost to a directory that did not exist... was the orchestrator's fault") to their one-line rule: 'test -e every path a dispatch names before sending it.'

DimensionReasoningScore

Conciseness

The body is dense with non-generic operational instruction and teaches nothing Claude already knows, but it carries tightening opportunities: motivational war stories ("A whole task has been lost to a directory that did not exist") and time-sensitive statistics ("64% of this repository's recorded token spend currently sits in that anonymous HEAD pool", "85.8% of subagent spend today") that will go stale — matching 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim anchor at 4.

3 / 5

Actionability

Fully executable throughout: copy-paste-ready commands ("git -C /Users/ac/.work/osn.git worktree add ... -b <prefix>/<dir> origin/main", "gh pr merge <n> --squash --delete-branch", "bun run --cwd tools/pr-metrics backfill -- --dry-run"), a verbatim dispatch contract ("TASK-BRANCH: <branch>", "NEEDS INPUT: <question> + options + recommendation"), and exact file paths covering the common cases — the 4 anchor's 'minor gaps' do not apply.

5 / 5

Workflow Clarity

Steps 00 → 0 → 1–5 are explicitly sequenced with validation checkpoints everywhere ("No subagent's stated verification counts" backed by mechanical git checks, re-verify after fixes, "Never merge red", gates tracked as NOT RUN on the blackboard) and full feedback loops for error recovery (dead subagent salvage, NEEDS INPUT handling, DIRTY/BEHIND rebase) — matching the top anchor's explicit validation, recovery loops, and checklists.

5 / 5

Progressive Disclosure

Good structure with a clearly signaled, one-level-deep reference — "The full table, with the reason behind each, is `references/gotchas.md`" (verified to exist, with the top five rows inlined) — and repo-file pointers given as paths rather than pasted prose. It stays below 5 because long rationale blocks (the gitBranch attribution warning, the 64%-spend precondition story) remain inline in SKILL.md and could be split into a reference file.

4 / 5

Total

17

/

20

Passed

Description

85%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 highly specific, well-bounded description with explicit positive and negative triggers and comprehensive concrete actions. Its only weakness is trigger phrasing built around internal mechanics rather than the natural words a user would say, which limits keyword coverage.

Suggestions

Add user-utterable synonyms to the trigger clause (e.g. "Use when asked to orchestrate, run, or drive a set of tasks/PRs end to end") so it matches how users actually phrase the request.

Demote internal jargon like "bare repo's main worktree" to a secondary clause and lead with plain terms ("multiple tasks", "one PR per task") to improve natural keyword coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete, comprehensive actions — "ordering them, cutting a worktree per task, handing each to a subagent that runs new-feat, running prep-pr with every finding fixed... shepherding each pull request to a squash merge and worktree teardown" — matching the top anchor rather than the 'several specific actions; minor gaps' anchor at 4.

5 / 5

Completeness

It explicitly answers both questions: a concrete 'what' (order, cut worktrees, dispatch subagents, fix findings, shepherd to merge) and an explicit 'when' ("Use when driving one or more tasks end to end..."), plus negative triggers ("Not for a one-file change, and not outside the bare repo") — the 4 anchor would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Relevant keywords exist ("tasks end to end", "feature", "task list", "pull request") but the natural phrases a user would utter ("orchestrate", "run these tasks", "do these tickets") are missing, and coverage leans on internal mechanics ("bare repo", "prep-pr", "new-feat") rather than synonyms — matching 'some relevant keywords but missing common variations', not the good-coverage anchor at 4.

3 / 5

Distinctiveness Conflict Risk

It carves a clear niche — bare-repo multi-task orchestration with new-feat/prep-pr hand-off and squash-merge teardown — with distinct triggers unlikely to fire for other skills; the 4 anchor's 'minor overlap risk with closely related skills' is not met since the negative triggers explicitly exclude the nearest neighbors (single-file changes, non-bare-repo use of new-feat/prep-pr).

5 / 5

Total

18

/

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/osn
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.