CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

zero-hallucination-coder

Runs a disciplined Discuss → Map → Decompose → Execute → Verify loop that grounds code in verified structure — no invented APIs, no assumed imports, no placeholder code — with a lazy-senior-dev YAGNI ladder that deletes unnecessary code before it is written. Use when a coding task is high-stakes, complex, or spans existing code (auth, databases, migrations, multi-file features), or when the user explicitly asks to plan carefully before coding, avoid hallucinated code, or work rigorously. Not for trivial edits, typos, or throwaway one-off scripts — those do not need the full loop.

68

Quality

85%

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

The canonical home for this skill is zero-hallucination-coder in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 is a highly actionable, well-sequenced process skill: every phase has an exact output template with worked examples, hard gates on UNKNOWNs, and explicit feedback loops. Its main weakness is token efficiency — a non-executional credits table, rules duplicated across sections, and definitional asides could be trimmed or split into reference files without losing any guidance.

Suggestions

Remove or compress the Credits & Inspiration section to a single line (or move it to a reference file) — it costs ~12 lines of context without changing execution.

Deduplicate rules that appear twice: the placeholder prohibition (Phase 4 Step B vs. Anti-Pattern 3) and the story-size thresholds (Phase 3 right-sizing vs. Proactive Triggers) should live in one authoritative place.

Trim definitional asides Claude doesn't need, e.g. the parenthetical explaining what "context rot" is in the Context Engineering Rules section, keeping only the actionable rule.

DimensionReasoningScore

Conciseness

The body is mostly efficient templates and rules, but it carries unnecessary weight: the 12-line "Credits & Inspiration" table contributes nothing to execution, rules are duplicated across sections (placeholder ban in Phase 4 Step B and Anti-Pattern 3; story-size limits in Phase 3 and Proactive Triggers), and asides define concepts Claude already knows ("context rot — the silent quality degradation as the context window fills"). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim profile of the 4 anchor.

3 / 5

Actionability

Every phase ships a copy-paste-ready output template (CODEBASE MAP, IMPLEMENTATION PLAN, PONYTAIL CHECK, SELF-REVIEW, HANDOFF, VERIFICATION REPORT) with concrete worked examples such as "[KNOWN] UserService.ts → calls → AuthService.authenticate()" and "Add `validateToken(token: string): boolean` to AuthService" vs the too-big "Build the authentication system". Guidance is fully executable for a process skill — exact formats, exact thresholds (>300 lines, >3 files, >2 acceptance criteria), and exact inline comment conventions. Not below 5 because no common case lacks a concrete template.

5 / 5

Workflow Clarity

The five phases are strictly sequenced with explicit validation checkpoints and feedback loops: "Never write code that depends on an [UNKNOWN]", "If any UNKNOWN exists, stop and resolve it before writing code", "Do not proceed to the next story until the user confirms", and the gap-recovery loop "If any story has a gap, write a micro-story to close it and run Phase 4 again". This matches the 5 anchor's 'explicit validation steps; feedback loops for error recovery; checklists'. A minor wrinkle — the short-circuit section drops Map for abbreviated loops while the Modes section keeps it — is not enough to drop a level.

5 / 5

Progressive Disclosure

The single file is well-sectioned with clear headers, templates, and tables, and no references are needed for the core loop, so navigation is easy. But it is a ~270-line monolith where the Credits & Inspiration table and possibly the per-phase templates could live in separate one-level-deep reference files, matching 'good structure; most content is appropriately placed; minor organization gaps' rather than a cleanly split overview.

4 / 5

Total

17

/

20

Passed

Description

83%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 strong description: it names a concrete five-phase pipeline with specific anti-hallucination guarantees, provides explicit 'use when' triggers with concrete domains and an explicit exclusion clause, and stays in third person. The only minor deductions are for slightly abstract phrasing ('grounds code in verified structure'), a few missing natural trigger synonyms, and moderate overlap risk with general careful-coding skills.

DimensionReasoningScore

Specificity

Concrete named actions: "Runs a disciplined Discuss -> Map -> Decompose -> Execute -> Verify loop", "no invented APIs, no assumed imports, no placeholder code", and a "YAGNI ladder that deletes unnecessary code before it is written". Minor gaps remain — phrases like "grounds code in verified structure" are slightly abstract and the concrete artifacts the user receives (codebase map, story list, verification report) are not named — so it fits 'several specific actions; minor gaps' rather than the fully comprehensive anchor.

4 / 5

Completeness

Both what and when are explicit: the 'what' names the five-phase loop, the anti-hallucination guarantees, and the YAGNI ladder; the 'when' gives concrete trigger conditions ("high-stakes, complex, or spans existing code (auth, databases, migrations, multi-file features)", "explicitly asks to plan carefully before coding, avoid hallucinated code") plus an explicit not-for clause. This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

Natural user phrasings are present: "plan carefully", "avoid hallucinated code", "work rigorously", plus concrete trigger domains ("auth, databases, migrations, multi-file features") and anti-triggers ("trivial edits, typos, throwaway one-off scripts"). A few common variants are missing (e.g. "don't make up APIs", "be careful with this codebase"), matching 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The zero-hallucination framing ("no invented APIs, no assumed imports, no placeholder code") carves out a distinct niche with a clear selection phrase ("avoid hallucinated code"). Risk of overlap remains with generic planning or rigorous-coding skills since "complex" and "high-stakes" coding tasks are broad territory, keeping it at 'mostly distinct; minor overlap risk' rather than a fully distinct niche.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/zero-hallucination-coder/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.