CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

conductor-revert

Git-aware undo by logical work unit (track, phase, or task)

Quality

70%

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-revert/SKILL.md
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 delivers an exceptionally well-sequenced, safety-first git revert procedure with concrete commands, strong validation checkpoints, and thorough edge-case handling. Its main weaknesses are boilerplate filler sections and a long single-file layout with bulky inline dialog templates that could be trimmed or offloaded to references.

Suggestions

Remove the generic 'Use this skill when', 'Do not use this skill when', 'Instructions', and 'Limitations' boilerplate sections, which restate nothing specific to this skill and consume tokens.

Move the long ASCII dialog templates (selection menu, execution plan box, conflict/verification screens) into a references/ file (e.g. UI_TEMPLATES.md), keeping only the required behavioral rules inline.

Replace the `{test command}` / `{relevant check}` placeholders in Verification with concrete discovery steps (e.g. 'read the track's plan.md or project config for the test command; if none, ask the user').

DimensionReasoningScore

Conciseness

The core operational content is dense and efficient (exact git commands, tight safety rules), but generic boilerplate sections pad it out — 'Use this skill when', 'Do not use this skill when', an 'Instructions' section of placeholders like 'Clarify goals, constraints, and required inputs', and a 'Limitations' section that repeat nothing skill-specific. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; a 2 would require several padded explanatory sections throughout, whereas here the padding is confined to a few template blocks.

3 / 5

Actionability

The guidance is largely executable: concrete commands such as `git log --oneline --grep="{trackId}" --grep="Task {X.Y}" --all-match` and `git revert --no-edit abc1234`, exact argument formats, exact confirmation protocol, and precise marker updates. Minor gaps remain — `{test command}` and 'Check application: {relevant check}' placeholders, and steps like 'Determine task range for the phase by reading plan.md' given without a command — placing it at 'mostly executable guidance with minor gaps' rather than fully copy-paste ready (5).

4 / 5

Workflow Clarity

The multi-step destructive workflow is fully sequenced with explicit validation checkpoints and feedback loops: pre-flight repo/cleanliness checks, a full execution plan displayed before any operation, mandatory explicit 'YES' confirmation, immediate HALT on any conflict with user options, and post-revert verification with recovery guidance. This matches the top anchor 'clear sequence with explicit validation steps; feedback loops for error recovery' — the destructive-operation cap is clearly satisfied.

5 / 5

Progressive Disclosure

The single-file body (no bundle files exist) is well organized with clearly labeled sections in logical order (pre-flight, selection, discovery, plan, execution, updates, verification, edge cases), each independently navigable. It fits 'good structure; most content is appropriately placed; minor organization gaps' — not a 5 because the ~376 lines include long inline dialog templates (menus, ASCII plan boxes, edge-case screens) that could be split into reference files, though nothing is buried or nested.

4 / 5

Total

16

/

20

Passed

Description

53%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 concise and names a concrete, distinct capability (git undo by track/phase/task), but it lacks any 'when to use' trigger guidance and omits the natural term 'revert' that users would most likely say. It reads as a title rather than a trigger-enabled description.

Suggestions

Add an explicit 'Use when...' clause with concrete triggers, e.g. 'Use when the user wants to revert or undo work done under a Conductor track, phase, or task.'

Include the natural synonyms users would say — 'revert', 'roll back', 'undo commits' — alongside 'undo' to improve trigger matching.

Briefly enumerate the key capabilities (discover track commits, show a revert plan, execute git reverts, update plan.md) so the 'what' is comprehensive rather than a single action.

DimensionReasoningScore

Specificity

The description names the domain ("Git-aware undo") and one concrete capability ("by logical work unit (track, phase, or task)"), but does not enumerate the actual operations (commit discovery, execution planning, plan.md updates, verification). It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; a 4 would require several specific actions listed, which is not the case.

3 / 5

Completeness

The 'what' is clear (git-aware undo at track/phase/task granularity), but there is no 'Use when...' clause or equivalent trigger guidance — 'Git-aware' only weakly implies the 'when'. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3; not a 4 because the 'when' is absent rather than present-but-imprecise.

3 / 5

Trigger Term Quality

It includes some relevant natural keywords ("Git", "undo", "track, phase, or task"), but misses the most common phrases a user would say for this task — "revert", "roll back", "undo my last commit/task" — leaving keyword coverage at 'some relevant keywords but missing common variations or synonyms'. Not a 2, since 'Git' and 'undo' are genuine natural terms rather than generic filler.

3 / 5

Distinctiveness Conflict Risk

The '(track, phase, or task)' vocabulary ties it to a distinct Conductor-style workflow system, making it mostly distinguishable; however, 'Git-aware undo' broadly overlaps with any generic git revert/undo skill, so minor conflict risk remains. It sits above 'could still overlap with similar skills' (3) and below 'clear niche with distinct triggers' (5) because the trigger phrases themselves are not distinctive.

4 / 5

Total

13

/

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

Path

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