CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

decider

Load to create, search, or supersede an architecture decision record.

Quality

75%

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 ./.agents/skills/decider/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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.

A lean, token-efficient policy overview with strong warrant criteria, binding-semantics rules, and clean workflow dispatch. Weaknesses concentrate in execution wiring: the `check` validation command is orphaned from the workflows, no example CLI run is shown, and most referenced detail files are missing from the bundle.

Suggestions

Wire `check` into the workflows as an explicit validation checkpoint, e.g., "after any INDEX or record edit, run `decisions check`; fix and re-run until clean."

Ship the referenced `workflows/`, `schemas/`, and `templates/` files alongside SKILL.md (or inline the minimal creation steps) so every referenced path resolves within the bundle.

Add one concrete example invocation with its output shape (e.g., `decisions search "auth"`) so CLI usage is copy-paste ready without consulting --help first.

DimensionReasoningScore

Conciseness

The body is ~50 lines of dense policy with zero padding: "A record exists to stop a reversal: a reviewer or a future agent, reading the code alone, would undo the choice because the code cannot show its reason" carries a full warrant rule in one sentence, and CLI detail is deferred to "decisions --help". Nothing explains concepts Claude already knows, and every token earns its place.

5 / 5

Actionability

Concrete guidance throughout: the CLI invocation ".agents/skills/decider/scripts/decisions <command> [options]", exact file pointers ("workflows/create-decision.md", "schemas/decision-format.md", "templates/decision-entry.md"), a warning against a nonexistent command ("There is no bare `issue` action; use `search --issue`"), and a literal approval sentence to say. It falls short of 5 because no example command run or output shape is shown inline — usage is delegated entirely to --help and the referenced files.

4 / 5

Workflow Clarity

The Workflows table gives clean trigger-to-file dispatch, the reading protocol is ordered ("Read a hit's INDEX row first", "Read an active or superseded record's document before treating it as binding"), and the approval gate is explicit ("Never create a decision document without explicit user approval"). But the `check` action is listed among the CLI's actions yet never sequenced into any flow, and supersession/removal — operations that edit the INDEX and existing records — have no inline validation loop; per the guideline capping workflows with such operations at 3, this cannot score 4.

3 / 5

Progressive Disclosure

SKILL.md is a proper overview with clearly signaled, one-level-deep references (the Workflows table, the "Format:" line, `decisions --help`), and the CLI script does exist in the bundle (scripts/decisions). However, the referenced `workflows/create-decision.md`, `workflows/update-decision.md`, `schemas/decision-format.md`, `templates/decision-entry.md`, and `templates/index-row.md` are not present in the actual bundle, so navigation to the core procedural detail cannot be completed or verified — more than the minor organization gap of a 4.

3 / 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 specific, niche-clear description built on three concrete verbs over a well-defined artifact. Its main weakness is the absence of an explicit "Use when..." trigger clause, which leaves the "when" only weakly implied and caps completeness.

Suggestions

Add an explicit trigger clause, e.g., "Use when recording, finding, or replacing an architecture decision (ADR), or when maintaining the decisions INDEX."

Include the synonyms "ADR" and "decision log" so users who use the abbreviation still trigger the skill naturally.

Mention INDEX maintenance alongside create/search/supersede to close the coverage gap against the skill's actual capabilities.

DimensionReasoningScore

Specificity

"create, search, or supersede" lists three concrete actions on a named artifact ("an architecture decision record"), matching the anchor for several specific actions with minor gaps. It is not 5 because the skill's own body shows broader coverage (INDEX maintenance, list/get/check actions, retirement/removal) that the description omits; not 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

The "what" is clear ("create, search, or supersede an architecture decision record") but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by "Load to". Per the judging guideline, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

"architecture decision record" is exactly the natural phrase a user would say, reinforced by the action verbs "create", "search", "supersede". A few natural terms are missing — the common abbreviation "ADR" and synonyms like "decision log" — so it sits at good-but-not-comprehensive keyword coverage rather than 5.

4 / 5

Distinctiveness Conflict Risk

"architecture decision record" names a clear niche, and the create/search/supersede verb set maps uniquely to ADR management — a user mentioning decisions or ADRs would not plausibly route to a different skill. Conflict risk with general documentation skills is minimal.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 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

Total

14

/

16

Passed

Repository

vanillagreencom/kendex

Path

.agents/skills/decider/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.