CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

worktrail-go

Use when the user invokes worktrail-go, asks to pick up queued work, resume active specs, implement or fix a spec, route engineering work, or orient across repositories. Renders the orientation dashboard, classifies free-text requests, claims/resumes handoff briefs, and dispatches SDD work without requiring the user to know sdd-workflow. Grammar: worktrail-go [REPO] <noun> <verb>, nouns handoff / spec / pr / decision. Triggers: worktrail-go, worktrail-go help, worktrail-go spec fix, worktrail-go spec implement, worktrail-go spec route F, worktrail-go handoff new, worktrail-go handoff auto, worktrail-go decision answer, worktrail-go BRIEF-ID, bare worktrail-go, multi-repo orientation.

68

Quality

86%

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

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

The body is extremely executable and well-sequenced — every phase has concrete commands, explicit validation gates, and error-recovery branches — and it uses its 16-file reference bundle correctly with verified anchors. Its main weakness is token efficiency: ~1,100 lines with inline incident histories, duplicated rationale, and worked configuration examples that should live in reference files.

Suggestions

Move the Phase 7 routing-tier material (the two illustrative routing.yaml examples, purposes/tier_for() precedence prose, and capacity-cache operator command reference) into a references/routing.md and keep only the dispatch-relevant summary inline.

Replace inline incident narratives (e.g. "Datalena run go-20260811-132806", "confirmed live 2026-08-24", "live incident: run worktrail/go-20260825-163910") with a one-line rule plus a pointer to a history/rationale reference file — the dates and run ids cost tokens without changing the instruction.

State the agent_cli vs native_skill_available independence rule once in the Invocation Context section and reference it from later phases instead of re-explaining the embedded-Codex example in both the Invocation Context and Dispatch sections.

DimensionReasoningScore

Conciseness

The ~1,100-line body is noticeably verbose: inline incident narratives ("confirmed live 2026-08-24", "Datalena run go-20260811-132806", "live incident: run worktrail-go-20260825-163910", "observed: brief 20260812-163747 scored E=11"), the agent_cli/native_skill_available independence rationale explained twice, and two worked YAML routing examples flagged as "illustrative" are all padded sections a competent agent does not need inline. Not 1: there is no explanation of concepts Claude already knows — everything is operational specifics; not 3: the volume of rationale, history, and inline configuration detail goes well beyond "some unnecessary explanation."

2 / 5

Actionability

Every phase gives copy-paste bash with exact flags, exit-code semantics (exit 2 with distinct blocked_* stderr lines), the liveness/same_dispatch decision table, and an exact Dispatch Contract ("Skill(\"worktrail-sdd-workflow\", args=\"<repo-path> route:<X> [spec-folder] run:<run-path>\")"). Specific examples cover the common cases from /go spec fix to bare /go. Not 4: even edge cases (argv-overflow via mktemp files, assert-terminal hard gate) carry exact commands.

5 / 5

Workflow Clarity

Phases 0–8 are clearly sequenced with validation checkpoints and feedback loops at nearly every step: parse-then-act classification, exit-status checks with distinct blocked_* failure classes, "worktrail-run-record assert-terminal \"$RUN\"" as a hard gate, the same_dispatch/fresh resume matrix, and pre-checks before destructive operations (openspec validate --strict, ownership checks before claiming). Not 4: checkpoints are explicit and systematic, not merely present — batch/PR-owning operations all have verification, so no workflow-clarity cap applies.

5 / 5

Progressive Disclosure

All 16 references/*.md files referenced from the body exist and anchors verify ({#handoff-seed}, {#subprocess-dispatch}, {#ci-wait-discipline} in ci-watch-loop.md, {#overlap-check}, {#fix-branch-worktree-setup}, {#already-implemented-check} in subagent-prompts.md), with clearly signaled one-level-deep pointers ("Full procedure: references/auto-mode.md", "Field contract: references/dashboard-render.md"). Not 5: significant inline content belongs in references — the Phase 7 routing-tier deep-dive with two worked YAML examples, the capacity-cache operator command reference, and the repeated incident histories are inlined rather than split out; not 3: structure is consistent and references are clearly signaled, not buried.

4 / 5

Total

16

/

20

Passed

Description

96%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 is exemplary: explicit Use-when clause, concrete third-person action list, complete command-grammar triggers, and a niche anchored on the unique worktrail-go invocation. Its only weakness is two broad free-text triggers that slightly widen conflict risk.

DimensionReasoningScore

Specificity

"Renders the orientation dashboard, classifies free-text requests, claims/resumes handoff briefs, and dispatches SDD work" lists four concrete actions that comprehensively cover the skill's function. Not 4: there are no coverage gaps — the action list plus the grammar summary spans everything the skill does.

5 / 5

Completeness

Explicitly answers both: what ("Renders the orientation dashboard, classifies free-text requests, claims/resumes handoff briefs, and dispatches SDD work") and when ("Use when the user invokes worktrail-go, asks to pick up queued work, resume active specs, implement or fix a spec..."), with concrete trigger phrases throughout. Third-person voice is used consistently, so no voice penalty applies.

5 / 5

Trigger Term Quality

Natural phrases users would say ("pick up queued work", "resume active specs", "implement or fix a spec", "orient across repositories") appear alongside an exhaustive list of invocation triggers ("worktrail-go help", "worktrail-go spec fix", "worktrail-go handoff auto", "bare worktrail-go"). Not 4: both synonyms and every command form are covered.

5 / 5

Distinctiveness Conflict Risk

Most triggers anchor on the unique "worktrail-go" command, giving a clear niche, but "route engineering work" and "orient across repositories" are broad natural-language triggers that could overlap with other engineering-workflow skills. Not 5: those generic phrases carry some conflict risk; not 3: the dominant trigger surface is the distinct command grammar.

4 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1123 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

behindthedash/worktrail

Path

skills/worktrail-go/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.