CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

conductor-validator

Validates Conductor project artifacts for completeness, consistency, and correctness. Use after setup, when diagnosing issues, or before implementation to verify project context.

1.39x
Quality

60%

Does it follow best practices?

Impact

96%

1.39x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/conductor-validator/SKILL.md

The canonical home for this skill is conductor-validator in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

32%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 content has a useful kernel — the file-existence commands and the Pattern Matching section are concrete — but it is wrapped in malformed markdown, templated filler sections, and generic instructions that never define an actual validation workflow. The dangling reference to a nonexistent playbook compounds the structural problems.

Suggestions

Replace the generic Instructions with a numbered validation workflow: (1) run the file-existence checks, (2) verify status markers in tracks.md/plan.md against the documented patterns, (3) validate track IDs against the <type>_<name>_<YYYYMMDD> format, (4) report or fix discrepancies — with explicit checkpoints.

Remove the templated 'Use this skill when' / 'Do not use this skill when' filler (the description already covers triggering) and the boilerplate bullets, and fix the malformed opening: wrap the shell commands in a proper fenced code block under a real heading.

Either add the referenced resources/implementation-playbook.md to the bundle or delete the reference to it; if the detailed validation criteria live elsewhere, point to a file that actually exists.

DimensionReasoningScore

Conciseness

The body is noticeably padded: the templated 'Use this skill when' and 'Do not use this skill when' sections mechanically repeat the slug 'check if conductor directory exists' three times, and the Instructions bullets ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices and validate outcomes') are generic boilerplate that adds no information. This matches 'several unnecessary explanations or padded sections' rather than the mostly-efficient anchor 3.

2 / 5

Actionability

There is some genuinely concrete guidance — the shell commands ('ls -la conductor/tracks/', the required-files check listing index.md, product.md, tech-stack.md, workflow.md, tracks.md) and the pattern-matching examples (status markers, track ID format) — but the core validation procedure is missing: no criteria for what 'consistency' or 'correctness' means or what to do with the results. Concrete but incomplete matches anchor 3; a 4 would require the validation steps themselves to be executable.

3 / 5

Workflow Clarity

The body opens with three loose, unfenced shell snippets (implying only a rough check-dir/check-tracks/check-files order) and then jumps to filler sections and generic instructions with no sequenced procedure and no validation checkpoints or error-recovery guidance — in a skill whose entire purpose is validation. This matches 'rough sequence present but many gaps; validation absent' rather than the listed-but-checkpoint-missing anchor 3.

2 / 5

Progressive Disclosure

Although section headers exist, the structure is broken: the body starts with commands floating before any header behind a stray closing code fence, and the only external reference ('open resources/implementation-playbook.md') points to a file that does not exist in the bundle — a dangling reference, not merely an unclearly-signaled one. This matches 'minimal structure; references are buried' territory rather than the could-be-better-organized anchor 3.

2 / 5

Total

9

/

20

Passed

Description

71%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 well-formed description that clearly answers both what it does and when to use it, with a distinct named domain. Its weaknesses are limited action specificity (one verb with three attributes) and keyword coverage that omits the artifact names users would naturally mention.

Suggestions

List 2-3 concrete validation actions instead of one verb with attributes, e.g., 'Checks for required artifacts (index.md, product.md, tracks.md), verifies track status markers, and validates track ID naming conventions.'

Add natural trigger keywords users would say, such as the artifact filenames (tracks.md, plan.md) or phrases like 'check Conductor tracks' or 'review project context'.

DimensionReasoningScore

Specificity

The description names the domain ("Conductor project artifacts") and one action ("Validates") with three quality attributes ("completeness, consistency, and correctness"), which matches the anchor for domain plus 1-2 concrete actions but not comprehensive. It does not list several distinct actions (e.g., checking specific artifacts, comparing cross-references), so it falls short of a 4.

3 / 5

Completeness

Both parts are explicit: a clear 'what' ("Validates Conductor project artifacts for completeness, consistency, and correctness") and a 'when' with three concrete trigger scenarios ("Use after setup, when diagnosing issues, or before implementation to verify project context"), structurally matching the top anchor. A 4 would require the 'when' to be less explicit or specific than it is here.

5 / 5

Trigger Term Quality

Relevant keywords are present ("Conductor", "diagnosing issues", "verify project context") but common variations and synonyms are missing — no mention of the artifact names a user would naturally reference (index.md, tracks.md, plan.md, track status). Good but incomplete keyword coverage sits at the 'some relevant keywords, missing variations' anchor rather than a 4.

3 / 5

Distinctiveness Conflict Risk

"Conductor" carves out a clear niche with minimal conflict risk, but the generic triggers ("diagnosing issues", "verify project context") could overlap with general debugging or project-review skills, matching 'mostly distinct; minor overlap risk'. A 5 would require the triggers themselves to be as distinctive as the domain name.

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/conductor-validator/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.