smykla-skalski

Validator Error Format Policy — Code Quality skill for Claude Code

Code Quality community intermediate

Comprehensive guide for error reporting and formatting in klaudiush validators.

How to install Validator Error Format Policy

This entry records only its repository, not the path inside it, so there is no exact command to give. Open smykla-skalski/klaudiush and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Validator Error Format Policy does

Comprehensive guide for error reporting and formatting in klaudiush validators.

Alternatives in Code Quality

Import Drawio — Redraw a draw.io file as an editorial diagram at a chosen format, size, and detail level 27.2k ★
Job Stories — Create job stories with acceptance criteria in JTBD format 7.8k ★
Video Script: Claude SEO V1.7.2 — What's New — Duration: ~5 minutes Tone: Natural, conversational, like talking to a friend who knows Claude Code Format: Scr 5k ★

README

Validator Error Format Policy

Comprehensive guide for error reporting and formatting in klaudiush validators.

Error Format Structure

Validators return `*validator.Result` with these fields:

type Result struct {
    Passed      bool                      // Whether validation passed
    Message     string                    // Human-readable error message
    Details     map[string]string         // Additional contextual information
    ShouldBlock bool                      // Whether to block the operation
    Reference   validator.Reference       // Error documentation URL
    FixHint     string                    // Short fix suggestion
}

**Key semantics:**

Passed=true → validation passed (any other state ignored)
Passed=false + ShouldBlock=true → deny (JSON permissionDecision: "deny")
Passed=false + ShouldBlock=false → allow with warning (JSON permissionDecision: "allow")

Reference System

References are URLs that uniquely identify error types: `https://klaudiu.sh/e/{CODE}`

type Reference string

const ReferenceBaseURL = "https://klaudiu.sh/e"

// Example references
RefGitNoSignoff   Reference = "https://klaudiu.sh/e/GIT001"
RefGitMissingFlags Reference = "https://klaudiu.sh/e/GIT010"
RefShellcheck     Reference = "https://klaudiu.sh/e/FILE001"