CtrlK
BlogDocsLog inGet started
Tessl Logo

conductor-revert

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

46

Quality

50%

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 ./.agent/skills/conductor-revert/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 skill body has a solid, check-pointed pre-flight section but collapses after it: Target Selection is empty, the actual revert logic is delegated to eleven sub-skill files that do not exist, and destructive-operation verification is missing. Boilerplate use/do-not-use sections pad the body without adding information.

Suggestions

Create the referenced `sub-skills/*.md` and `resources/implementation-playbook.md` files (or inline their content) — the body currently links to eleven files that are missing from the bundle, making the skill non-functional.

Fill in the empty "Target Selection" section with the actual revert steps (e.g. `git log` to locate the unit's commits, `git revert <range>` or `git reset`, verification with `git status`/`git log`) so the destructive core has executable instructions and a post-revert validation loop.

Delete the circular "Use this skill when" / "Do not use this skill when" sections and the generic Instructions bullets, replacing them with the real decision tree the sub-skill headings imply.

DimensionReasoningScore

Conciseness

The pre-flight section is lean and useful, but the "Use this skill when" / "Do not use this skill when" sections are circular boilerplate ("Working on revert track tasks or workflows", "The task is unrelated to revert track") and the Instructions bullets ("Apply relevant best practices and validate outcomes") are generic filler — matching the anchor for mostly efficient with some unnecessary padding. Not 2 because there is no over-explanation of known concepts and most tokens do work.

3 / 5

Actionability

Pre-flight checks give concrete, executable guidance ("Run `git status`", "Check `conductor/tracks.md` exists", a specific warning dialog with three options), but the "Target Selection" section is an empty heading and no actual revert commands or steps appear anywhere — the anchor for some concrete guidance that is incomplete. Not 4 because the core operation of the skill has zero executable instructions in the body; not 2 because the pre-flight portion is genuinely executable.

3 / 5

Workflow Clarity

The pre-flight sequence is well ordered with explicit checkpoints (uncommitted-change halt with options, merge/rebase detection with "Halt and explain resolution steps"), but this is a destructive git operation with no post-revert verification or feedback loop, and the main workflow is a heading with no steps. Per the guideline capping destructive/batch skills without validation at 3, this cannot exceed 3; it is above 2 because a real, check-pointed pre-flight sequence is present.

3 / 5

Progressive Disclosure

The body points to `resources/implementation-playbook.md` and eleven `./sub-skills/*.md` files, and none of these exist in the bundle — the navigation is a shell of headings linking to nothing, which is broken rather than merely under-organized. Scored against the actual bundle structure per the guidelines, this fits the anchor for minimal structure with unusable references (2); it is not 3 because references that resolve to nothing provide no navigable organization at all.

2 / 5

Total

11

/

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 identifies a clear, fairly distinct capability, but it omits any "when to use" guidance and lacks the natural trigger synonyms (revert, roll back) that would let users find it. It reads as a one-line summary rather than a complete trigger description.

Suggestions

Add an explicit "Use when..." clause with concrete triggers, e.g. "Use when the user asks to revert, undo, or roll back a track, phase, or task in a Conductor project."

Include the natural synonyms users would say — "revert", "roll back", "uncommit" — since the body is entirely about reverting but the description never uses that word.

Mention 1-2 more concrete capabilities (e.g. "identifies the commits for a unit and reverts them, resolving conflicts") to lift specificity toward a 4.

DimensionReasoningScore

Specificity

"Git-aware undo by logical work unit (track, phase, or task)" names the domain and one concrete action with its three scope units, matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several specific actions (no revert, stash, or conflict-handling steps), so it is below anchor 4 but well above merely naming a domain.

3 / 5

Completeness

The description gives a clear "what" (git-aware undo scoped to track/phase/task) but contains no "Use when..." clause or equivalent trigger guidance, so it sits exactly on the anchor for a clear what with a missing when — and the judging guidelines cap completeness at 3 in that case.

3 / 5

Trigger Term Quality

Terms like "git", "undo", "track", "phase", and "task" are relevant, but common variations a user would actually say — "revert", "roll back", "uncommit" — are absent, fitting the anchor for some relevant keywords with missing synonyms. Not 4 because the natural phrase coverage is thin, not 2 because the keywords present are domain-appropriate rather than generic.

3 / 5

Distinctiveness Conflict Risk

"Git-aware undo by logical work unit (track, phase, or task)" carves a mostly distinct niche with the track/phase/task scoping, leaving only minor overlap risk with generic git-undo or revert skills. It is not a 5 because "Git-aware undo" alone could still match a plain undo/revert request and pull this skill in wrongly.

4 / 5

Total

13

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 11 missing

Warning

Total

13

/

16

Passed

Repository
Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI
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.