CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

yes-md

6-layer AI governance: safety gates, evidence-based debugging, anti-slack detection, and machine-enforced hooks. Makes AI safe, thorough, and honest.

Quality

62%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

The canonical home for this skill is yes-md in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

66%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 highly actionable, well-sequenced governance guidance with strong validation checkpoints and feedback loops — its workflow clarity is exemplary. Its main weakness is token efficiency: the same shortcut taxonomy is repeated across three tables and multiple PUA comparisons, so a third of the file could be cut with no loss of function.

Suggestions

Consolidate the Seven Deadly Shortcuts table, Anti-Slack Detection table, and Evidence Table into a single shortcut-to-response table — they restate the same failure modes three times.

Collapse the scattered PUA comparisons ("PUA says NO", "The difference from PUA", the Compatibility section) into one brief paragraph.

Move the 11-row Evidence Table into a references/ file and keep a two-row exemplar inline, shortening SKILL.md toward a true overview.

DimensionReasoningScore

Conciseness

The Seven Deadly Shortcuts table, the Anti-Slack Detection table, and the 11-row Evidence Table restate essentially the same failure modes three times, and PUA comparisons recur ("PUA says NO. YES says YES.", "The difference from PUA", plus a dedicated Compatibility section) alongside motivational framing ("You are a professional engineer..."). This is several padded, redundant sections — beyond the 'some unnecessary explanation' of anchor 3 — though the concrete commands keep it above anchor 1's conceptual over-explanation.

2 / 5

Actionability

As an instruction-only skill it provides concrete, executable guidance: specific commands (`curl -v`, `node -v`, `lsof`, `cat config.yaml | grep key`), ❌/✅ example pairs for each rule, explicit banned-phrase lists, and a failure-count escalation ladder with mandatory actions. Not 5 because a few directives remain abstract ('Check downstream services, routes, configs', 'Store the lesson') and the backup command uses an unexplained placeholder (`file.yaml.bak-{description}`).

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit validation checkpoints: each Safety Gate has a trigger and mandatory action, the escalation ladder (2→Switch, 3→Five-Step Audit, 4→Isolate, 5+→Structured Handoff) is a built-in feedback loop, and the Bug Closure Protocol's 'fix → verify → revert → verify it breaks again → re-apply fix' plus the Ripple Check and Deploy pre-flight checklists cover error recovery. This matches anchor 5's clear sequence with explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The body is well organized with clear section headers, tables, and no nested references, and everything a reader needs is discoverable in one pass. Not 5 because at ~220 lines with three overlapping tables, content such as the Evidence Table and the shortcut catalogs arguably belongs in a separate reference file, and the under-50-line simple-skill exception does not apply.

4 / 5

Total

15

/

20

Passed

Description

42%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 names a clear domain and several distinct features, but relies on coined jargon rather than natural trigger terms, omits any 'use when' guidance, and pads with a vague marketing tagline. It would rarely be selected by a user expressing a need in their own words.

Suggestions

Add an explicit trigger clause, e.g. 'Use when AI guesses without evidence, deflects verification to the user, retries the same fix repeatedly, or claims a fix is done without testing it.'

Replace coined jargon ('anti-slack detection', 'machine-enforced hooks') with natural user phrases like 'stop AI from guessing', 'verify fixes before reporting done', and 'prevent careless file or deployment changes'.

Drop the vague tagline 'Makes AI safe, thorough, and honest' and the unexplained '6-layer' count (only four layers are named) in favor of concrete capability statements.

DimensionReasoningScore

Specificity

The description names four distinct features ("safety gates", "evidence-based debugging", "anti-slack detection", "machine-enforced hooks"), but these are mechanism labels rather than concrete actions, and "Makes AI safe, thorough, and honest" is a vague tagline. It does not reach 4 because there are no concrete action verbs comparable to 'extracts text, fills forms'; it stays above 2 because the domain is named with multiple distinct features, not minimal or generic coverage.

3 / 5

Completeness

There is a clear 'what' ("6-layer AI governance: safety gates, evidence-based debugging, anti-slack detection, and machine-enforced hooks") but no 'Use when...' clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the 'when' is not weakly implied — it is simply missing.

3 / 5

Trigger Term Quality

Only "AI governance" and "debugging" are phrases a user would naturally say when needing this skill; "anti-slack detection" and "machine-enforced hooks" are coined jargon, and natural trigger phrases like 'AI keeps guessing' or 'verify before done' are entirely absent. It fits 2 rather than 3 because the majority of the description is invented terminology rather than relevant keywords missing only synonyms.

2 / 5

Distinctiveness Conflict Risk

The coined terms ("anti-slack detection", "YES.md") give the skill some distinct identity, but the broad behavioral claim "Makes AI safe, thorough, and honest" overlaps heavily with many quality/discipline skills. It is somewhat specific but could still overlap with similar skills, matching anchor 3 rather than 4's 'minor overlap risk'.

3 / 5

Total

11

/

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/yes-md/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.