CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

track-management

Use this skill when creating, managing, or working with Conductor tracks - the logical work units for features, bugs, and refactors. Applies to spec.md, plan.md, and track lifecycle operations.

58

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/conductor/skills/track-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 an effective, brief overview tier with exemplary progressive disclosure — one real, one-level-deep reference with a clear read-when condition. Its weaknesses are on the guidance side: no executable steps, formats, or commands appear in the body itself (all delegated to details.md), and the lifecycle workflow is only implied through best practices rather than sequenced.

Suggestions

Add a short 'Track lifecycle' sequence to the body (create spec.md → create plan.md → add tracks.md entry → implement → mark complete/archive), or a one-line pointer to the lifecycle section in details.md, so the workflow is ordered rather than implied.

Include one tiny concrete example in the body (e.g., the track ID format '{shortname}_{YYYYMMDD}' or a minimal spec.md skeleton) so the top tier is actionable without opening details.md.

Trim the duplicated framing: the intro paragraph restates the frontmatter description nearly verbatim, and several 'When to Use' bullets overlap it.

DimensionReasoningScore

Conciseness

The body is lean with no padding of concepts Claude already knows; the 'When to Use' list and terse best practices respect token budget. Not a 5 because the opening sentence ('Guide for creating, managing, and completing Conductor tracks - the logical work units that organize features, bugs, and refactors through specification, planning, and implementation phases.') almost verbatim duplicates the frontmatter description, and several 'When to Use' bullets restate it too.

4 / 5

Actionability

Some concrete guidance exists ('Break work into phases of 3-5 tasks maximum', 'Keep tracks between 1-5 days of work', 'Record SHAs', 'Archive, don't delete'), but the body contains no commands, file paths, format examples, or step sequences — everything executable is delegated to references/details.md. Not a 4 because a reader of the body alone cannot perform any track operation; not a 2 because the best practices include specific, checkable numbers rather than pure high-level hints.

3 / 5

Workflow Clarity

The track lifecycle is only implicitly sequenced through best practices ('Review specs before planning', 'Verification after phases', 'Archive, don't delete'), and validation is mentioned as a rule ('Always include verification tasks') rather than as checkpoints in an actual workflow. Not a 4 because no ordered steps (create spec → create plan → registry entry → implement → complete) appear in the body; not a 2 because ordering and verification requirements are at least stated as explicit rules.

3 / 5

Progressive Disclosure

The body is a clean navigation tier with a single well-signaled, one-level-deep reference ('Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.'), and the bundle confirms it: references/details.md exists and itself contains no further .md references, so there is no nesting. This matches the top anchor — clear overview, appropriately split, easy navigation.

5 / 5

Total

15

/

20

Passed

Description

70%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 solid description with an explicit 'Use this skill when...' trigger clause, a clearly named niche (Conductor tracks), and useful artifact anchors (spec.md, plan.md, lifecycle operations). Its main weakness is the action side: 'creating, managing, or working with' never concretizes what the skill actually does, so it reads more like a scope statement than a capability list.

Suggestions

Replace the generic verbs with 2-3 concrete capabilities, e.g. 'Scaffold new tracks (spec.md, plan.md, tracks.md registry entry), update task/status markers, and archive completed tracks.'

Add the natural trigger terms users would say but that are currently missing, such as 'tracks.md registry', 'track status', and 'archive/complete a track'.

Tighten the 'what' so it stands alone: state upfront what the skill does with the artifacts, then keep the existing 'Use when...' clause as the trigger.

DimensionReasoningScore

Specificity

Names the domain ('Conductor tracks - the logical work units for features, bugs, and refactors') plus concrete artifacts ('spec.md, plan.md'), but the verbs 'creating, managing, or working with' are generic and no concrete capability (e.g., scaffolding a track, updating the tracks.md registry, archiving) is spelled out. Not a 4 because the action list is thin and abstract rather than 'several specific actions'; not a 2 because the domain and file-level artifacts are clearly named.

3 / 5

Completeness

Both halves are present: an explicit when ('Use this skill when creating, managing, or working with Conductor tracks...Applies to spec.md, plan.md, and track lifecycle operations') and a what (tracks as 'logical work units for features, bugs, and refactors'). Not a 5 because the 'what' side rests on generic verbs and never states a concrete capability; not a 3 because 'when' is explicit and trigger-phrased rather than weakly implied.

4 / 5

Trigger Term Quality

Good natural-term coverage: 'creating', 'managing', 'Conductor tracks', 'spec.md', 'plan.md', 'track lifecycle', 'features, bugs, and refactors' — phrases a user would plausibly say. Not a 5 because common variations like 'tracks.md registry', 'archiving/completing a track', or 'track status' are absent; not a 3 because synonyms across track types and the spec/plan file names are present.

4 / 5

Distinctiveness Conflict Risk

The 'Conductor tracks' niche with spec.md/plan.md anchors is mostly distinct with minimal conflict risk against unrelated skills. Not a 5 because the generic 'creating, managing, or working with' framing plus 'spec.md'/'plan.md' could also plausibly fire for closely related Conductor skills (e.g., a dedicated spec-writing or planning skill); not a 3 because the Conductor-track scoping is far tighter than 'Works with document files'.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

wshobson/agents

Path

plugins/conductor/skills/track-management/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.