CtrlK
BlogDocsLog inGet started
Tessl Logo

worktrail-help

Show the Worktrail front-door commands and accepted positional arguments. Use when the user asks how to invoke worktrail-go, wants the available handoff, spec, pr, repo, or route forms, invokes worktrail-go with help or with a bare noun, or asks how to answer a filed product decision (worktrail-decision).

70

Quality

85%

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

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

A tight, executable command reference: a generated, test-pinned forms table, explicit precedence rules, and exact CLI commands, with the front matter correctly scoping behavior for a help-only skill. The main gaps are minor: some defensible-but-trimmable design-rationale prose and cross-bundle reference paths that live outside the skill's own files.

DimensionReasoningScore

Conciseness

The body is dominated by a dense forms table and compatibility map that earn their tokens, and it opens with a terse behavioral instruction rather than padding; no basic-concept explanations. Not a 5: passages of design rationale ('The compatibility spellings are permanent, not deprecated...', notes on why bare shortcuts sit outside the grammar) could be trimmed without losing actionable content; not a 3: over-explanation is minor, not systematic.

4 / 5

Actionability

Every entry in the forms block is a copy-paste-ready invocation with arguments, precedence is stated ('Forms are listed in the order the parser checks them'), and the non-interactive path gives exact CLI commands ('worktrail-decision answer <id> --answer "..."'). Coverage spans all parsed forms plus compatibility spellings, so common cases are fully addressed.

5 / 5

Workflow Clarity

For a simple display skill the single action is unambiguous and guarded ('Display this concise command reference. Do not start work, claim a brief, or run the dashboard merely because help was requested'), and the decision flow is sequenced (list → answer → auto-unblock on next drain pass). Not a 5: the interactive answer procedure and filing/resuming procedure are deferred to external references rather than sequenced inline, so checkpoints in that flow are only implicit.

4 / 5

Progressive Disclosure

Sections are well organized (client table, accepted forms, grammar, decision answering), and the two deep-dive procedures are clearly signaled one-level references ('Full interactive procedure: ../worktrail-go/references/answer-decision.md'). Not a 5: those references point outside this skill's own bundle (a sibling skill's references/ directory, absent here) rather than to bundled files, so navigation depends on an external layout; not a 3: the split between inline reference content and deferred procedure detail is appropriate and clearly labeled.

4 / 5

Total

17

/

20

Passed

Description

87%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: third-person voice, a concrete what, and an explicit multi-scenario 'Use when' clause keyed to the tool's own names and forms. Trigger coverage is comprehensive for this niche with only minor phrasing gaps.

DimensionReasoningScore

Specificity

The 'what' is concrete ('Show the Worktrail front-door commands and accepted positional arguments') and the description enumerates the specific surface it covers — 'handoff, spec, pr, repo, or route forms' plus the worktrail-decision flow — leaving only minor gaps in coverage. Not a 5: the capability itself is a single display action rather than multiple concrete actions; not a 3: it goes well past 1-2 generic actions by naming the form families and the sub-tool.

4 / 5

Completeness

Explicitly answers both halves: 'Show the Worktrail front-door commands and accepted positional arguments' (what) and an explicit 'Use when...' clause listing four concrete trigger scenarios (when). Matches the anchor-5 example pattern of a clear what followed by concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are covered — 'how to invoke worktrail-go', 'help', 'with a bare noun', 'how to answer a filed product decision' — with synonyms (asks/wants/invokes) and the tool names. Not a 5: a few plausible trigger phrasings are missing (e.g. 'usage', 'list commands'); not a 3: coverage is far beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Triggers are anchored to the unique tool names 'worktrail-go' and 'worktrail-decision' plus their distinctive form nouns, giving a clear niche with minimal risk of firing for unrelated skills. Second example ('bare noun') even disambiguates a common false-positive invocation.

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
behindthedash/worktrail
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.