CtrlK
BlogDocsLog inGet started
Tessl Logo

conductor-new-track

Create a new track with specification and phased implementation plan

52

Quality

58%

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

This is a highly actionable, well-sequenced workflow skill whose templates and prompts are copy-paste ready, with real validation gates (pre-flight checks, two user reviews) and error handling. Its weaknesses are boilerplate filler sections, and a progressive-disclosure failure: the one referenced file does not exist and substantial template content is inlined rather than split out.

Suggestions

Create the referenced `resources/implementation-playbook.md` (or remove the reference) — as written, the only pointer out of SKILL.md leads to a missing file.

Delete or replace the circular 'Use this skill when / Do not use this skill when' sections and the generic Instructions bullets ("Apply relevant best practices and validate outcomes") with nothing or with genuinely specific guidance.

Move the per-track-type question banks and the full spec.md/plan.md templates into a references/ file (one level deep, clearly signaled) to shrink the ~430-line body to a lean overview.

DimensionReasoningScore

Conciseness

The core content (question scripts, spec/plan templates, metadata schema) is efficient and earns its tokens, but there is unnecessary filler: circular sections like "Working on new track tasks or workflows" / "The task is unrelated to new track", and a generic Instructions section ("Apply relevant best practices and validate outcomes") that adds no information. This matches level 3 (mostly efficient, some unnecessary content that could be tightened); it is not level 2 because the bulk is concrete templates rather than padded explanation.

3 / 5

Actionability

The body provides copy-paste-ready material throughout: exact per-question prompts with option menus, a concrete track ID format (`user-auth_20250115`) with collision handling, full markdown templates for spec.md/plan.md/index.md, a complete metadata.json schema, and the exact tracks.md table row format. This matches level 5 (fully executable, covers the common cases); it is not level 4 because there are no meaningful gaps in the concrete guidance.

5 / 5

Workflow Clarity

The sequence is explicit and gated: pre-flight checks verify initialization, interactive spec gathering with one-question-per-turn rules, user review of the spec, user review of the plan, then file creation with an error-handling section covering failure and cleanup ("If any file write fails: Clean up partial track, report error"). This matches level 4 (clear sequence, most checkpoints present); it is not level 5 because there are no verification commands or explicit re-check loops after file writes — error handling is stated as policy but without concrete recovery steps.

4 / 5

Progressive Disclosure

The body is well-sectioned and navigable, but it is a ~430-line monolith whose question banks and full document templates could live in reference files, and its single reference — "open `resources/implementation-playbook.md`" — points to a file that does not exist in the bundle (no references/, scripts/, assets/, or resources/ directories are present), so the pointer is dangling. This matches level 3 (some structure, references present but problematic, content that could be separate is inline); it is not level 4 because a broken reference and the inlined bulk are more than minor organization gaps.

3 / 5

Total

15

/

20

Passed

Description

46%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 has a clear, concrete 'what' but completely lacks a 'when' — there is no trigger guidance, and its keywords are internal jargon rather than phrases a user would naturally say. Adding an explicit 'Use when...' clause with user-facing trigger terms would address its main weaknesses.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user wants to start a new feature, bug fix, chore, or refactor and needs a spec and implementation plan.'

Include natural user-facing vocabulary alongside the jargon — terms like 'new feature', 'bug fix', 'implementation plan', 'spec' — so the description matches what users actually say.

Enumerate the concrete actions more fully (gather spec via interactive Q&A, generate phased plan, create track files, register in tracks.md) to lift specificity from 1-2 actions to comprehensive coverage.

DimensionReasoningScore

Specificity

"Create a new track with specification and phased implementation plan" names the domain (tracks) and two concrete outputs (specification, phased plan), matching the anchor for 1-2 concrete actions without comprehensive coverage. It is above level 2 (which expects only minimal/generic actions) but below level 4, which requires several specific listed actions like 'generate specs', 'create phased plans', 'register tracks', 'update index files'.

3 / 5

Completeness

It answers 'what' clearly (create a track with a spec and a phased plan) but contains no 'Use when...' clause or any trigger guidance at all, which per the judging guidelines caps completeness at 3. It is not level 2 because the 'what' is concrete rather than vague, and not level 4 because 'when' is entirely absent rather than just implicit or underspecified.

3 / 5

Trigger Term Quality

The only keywords are the project-specific jargon 'track' and generic 'specification' and 'implementation plan'; there are no natural phrases a user would say (e.g., 'new feature', 'plan a feature', 'create a spec'). This matches level 2 (one or two keywords, missing the natural phrases) rather than level 3, which requires broader relevant keyword coverage including common variations.

2 / 5

Distinctiveness Conflict Risk

"Create a new track" carves out a fairly distinct niche tied to this system's track concept, with only minor overlap risk against closely related workflow skills (e.g., implement/status variants in the same toolset). It is not level 5 because without trigger phrases, sibling skills that also reference 'tracks' or 'specifications' could plausibly compete for activation.

4 / 5

Total

12

/

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
sickn33/agentic-awesome-skills
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.