coding-standard

Creates and updates project coding standards with evidence-based examples and path-scoped rule integration.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/amirbiron/Han --skill coding-standard-amirbiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: coding-standard
Source: https://github.com/amirbiron/Han/tree/main/han-coding/skills/coding-standard
Command: npx skills add https://github.com/amirbiron/Han --skill coding-standard-amirbiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams accumulate inconsistent conventions across a codebase, and ad-hoc style rules either go undocumented or get written as vague documents that drift out of date and get over-applied. This Skill produces durable, evidence-grounded coding standards that stay accurate as the code evolves and are surfaced to Claude Code only when relevant. ## Core Features & Use Cases - Three operating modes: create a new standard from scratch, convert an existing document (such as an ADR) into a standard, or update an existing standard while preserving its frontmatter. - Evidence-gathering agents: dispatches codebase-explorer agents to find real correct-usage and anti-pattern examples with durable, greppable anchors instead of bare line numbers. - YAGNI and adoption-bias audits: rejects standards better handled by linters, demands concrete evidence the pattern exists today, and structurally guards against over-application with decision trees and "when not to apply" sections. - Path-scoped integration: routes each standard into per-file-type index files under .claude/rules/coding-standards/ so Claude Code loads only a small index and opens full standards on demand. - Use Case: Ask it to standardize how Svelte stores shape state; it explores the codebase for existing store patterns, drafts the standard from real examples, runs adversarial reviews with junior-developer and information-architect agents, and wires it into the TypeScript/Svelte rule indexes. ## Quick Start Ask the assistant to create a coding standard for a topic such as "naming conventions for API route handlers" and let it gather codebase evidence before writing.

Frequently Asked Questions about coding-standard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a coding standard for my project?▼

Invoke the skill with a topic, and it gathers real codebase examples via explorer agents, drafts the standard from a template with durable anchors, runs adoption-bias and adversarial reviews, and registers it in the per-file-type index files under .claude/rules/coding-standards/.

How do I convert an ADR into a coding standard?▼

Pass the ADR path as the argument. The skill maps ADR sections to standard sections using its conversion mapping reference, ranks one rationale as primary, deletes or cross-links the source document depending on whether it is fully subsumed, and marks the new standard as accepted.

When should I not write a coding standard?▼

Skip standards for conventions that linters or formatters enforce, well-known language idioms, or patterns the codebase does not use yet. The skill's YAGNI check requires concrete evidence such as three inconsistent in-codebase examples or a recurring review finding before proceeding.

How are coding standards loaded by Claude Code?▼

Standards are never loaded directly. Per-file-type index files under .claude/rules/coding-standards/ carry paths frontmatter; when Claude reads a matching file it loads only the index, then decides which listed standards to open with the Read tool.

Why does the skill avoid line numbers in code references?▼

Bare file:line citations go stale when lines shift. The durable-reference rule requires citing greppable anchors such as exported symbols or stable section headings, with line ranges used only during research, never in the committed document.