CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orch

PRIMARY AGENT ONLY. Load to orchestrate a Linear or GitHub work item from preparation through merge.

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Failed to scan

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./skills/orch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 dense, professional orchestration skill: nearly every line states a concrete rule, command, or validation condition, with strong artifact-based checks, bounded feedback loops, and a well-organized script/reference structure. The main weaknesses are the many unresolvable link targets (workflows/, schemas/, cross-skill paths) and a few over-compressed multi-clause passages that bury distinct rules in single bullets.

Suggestions

Ship the workflows/ and schemas/ files that the Commands table and script notes link to (or repoint/remove those links) so every route in the Commands table resolves within the bundle.

Move the long prose rule clusters ('The overseer reads results', 'Item work stays in lanes') into the already-existing references files, keeping one-line rules inline in SKILL.md.

Add brief inline usage examples for the highest-traffic scripts (pr-order order rules, queue-wait verdicts) instead of deferring entirely to --help.

DimensionReasoningScore

Conciseness

The body is hyper-telegraphic and assumes competence throughout — no concept explanations or filler; representative lines like 'A round closes on a validated on-disk artifact plus git/tracker state, never on a return message' carry a full rule in one sentence. It is not 5 because several bullets ('The overseer reads results', 'Item work stays in lanes') are giant multi-clause rule clusters and a version pin ('Requires kendex 1.20.0 or newer') could be trimmed or relocated; not 3 because almost every token carries a rule with no unnecessary explanation.

4 / 5

Actionability

Concrete, executable guidance is dense: exact commands ('git -C [WT_PATH] rev-parse --verify HEAD'), exit-code contracts ('status=no_pr exits 0', 'exit 3 when none qualifies'), explicit flags ('workflow-state post-pr-stop record', '--check-live-round pushes nothing'), a full script inventory, and a stated invocation path. Not 5 because some behaviors defer to --help (e.g., 'pr-order --help' owns publication order) and the Commands table routes to workflow files not present in the bundle, leaving those routes unexecutable as written.

4 / 5

Workflow Clarity

The Cycle states an explicit sequence (Get the issue → dev implements → publication, review and fixes → required CI and review gate → merge) with explicit validation checkpoints ('Acceptance is artifact-based', base-freshness gating, approval-wait/ci-wait/queue-wait) and feedback loops (bounded fix rounds, 'two consecutive rounds with no new blocker end the review', stall recovery via round-recover, re-read-after-rebase rules). Not 5 because the per-command step sequences live in referenced workflow files, several of which are absent from the bundle, so the end-to-end flow cannot be followed from this body alone.

4 / 5

Progressive Disclosure

Links are clearly signaled and one level deep, and every referenced references/ and scripts/ file verified as present (skill-rules.md, gates.md, codex-runtime.md, waiter-launch.md, all script table entries). However, a large fraction of the body's link targets do not resolve in the provided bundle: the entire workflows/ tree that the Commands table routes to (workflows/start.md, review-pr.md, micro.md, ...), schemas/*.md (workflow-state.md, lane-host.md, ...), README.md, and cross-skill paths like ../reviewer/SKILL.md. This sits between anchors 3 and 4; the missing routing targets are more than 'minor organization gaps', so 3.

3 / 5

Total

15

/

20

Passed

Description

53%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.

The description carves out a clear, distinctive niche — Linear or GitHub work-item lifecycle orchestration — in third person, and the PRIMARY AGENT ONLY marker aids routing. Its weaknesses are reliance on the single abstract verb 'orchestrate', no explicit 'Use when' trigger guidance, and missing common synonyms (issue, PR, pull request).

Suggestions

Add an explicit trigger clause, e.g. 'Use when driving a Linear or GitHub issue end-to-end: prepare, delegate implementation, review, submit, and merge.'

Replace the abstract verb 'orchestrate' with the cycle's concrete verbs (prepare, delegate, review, submit, merge, oversee) to sharpen the 'what' beyond one action span.

Include common trigger synonyms — issue, PR, pull request, ship — so natural user phrasings match without technical vocabulary.

DimensionReasoningScore

Specificity

It names the domain ("Linear or GitHub work item") and a single action span ("orchestrate... from preparation through merge"), which matches 'names domain and 1-2 concrete actions, but not comprehensive'. It is not 4 because it does not list several specific concrete actions (e.g., delegate implementation, review, submit, merge) — the whole capability is compressed into the one abstract verb 'orchestrate'.

3 / 5

Completeness

The 'what' is clear ("orchestrate a Linear or GitHub work item from preparation through merge") but there is no 'Use when...' clause or equivalent trigger guidance; "PRIMARY AGENT ONLY. Load to..." tells who should load it, not when to use it, so completeness is capped at 3 per the judging guidelines. Not 2 because the 'what' is present and domain-specific.

3 / 5

Trigger Term Quality

Natural keywords are present ("Linear", "GitHub", "work item", "merge"), but common variations a user would actually say — "issue", "PR", "pull request" — are absent, matching 'some relevant keywords but missing common variations or synonyms'. Not 4, since keyword coverage is thin for a skill whose entry points span the whole issue-to-merge lifecycle.

3 / 5

Distinctiveness Conflict Risk

The full-lifecycle scope ("from preparation through merge") plus the "PRIMARY AGENT ONLY" marker give it a mostly distinct niche with only minor overlap risk against closely related sibling skills (github, linear, project-management). Not 5, because trigger phrasing is minimal and adjacent skills cover parts of the same lifecycle, so a request like 'review my PR' or 'merge this' could plausibly contend.

4 / 5

Total

13

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 10 missing, 8 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

vanillagreencom/kendex

Path

skills/orch/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.