CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kiln-conventions

Kiln's code conventions and per-area gotchas, plus a diff gate that enforces the mechanical ones. Invoke before writing or changing any Python, TypeScript or Svelte code in the Kiln repo (libs/core, libs/server, app/desktop, app/web_ui), and when reviewing such a change. Covers comments, startup and entry points, globals and module state, config reads, module layering, library-vs-app rules and async I/O.

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary process-oriented skill body: numbered workflow, copy-paste-ready gate commands with output format and exit-code semantics, explicit feedback loops for FAIL/WARN handling, a self-check checklist for review-only rules, and clean conditional loading of one-level-deep references keyed by edited paths. The only notable trim opportunity is the maintainer-focused "Maintaining the gate" section.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no explanations of uv, pytest, or general concepts; every gate rule is referenced by id rather than restated). It falls short of the 5 anchor because the ~20-line "Maintaining the gate" section — config notes, glob syntax, pytest invocation — serves a maintainer rather than a code-change audience and could be trimmed or moved to a reference; it is noticeably above the 3 anchor since the rest is lean and padded nowhere.

4 / 5

Actionability

Guidance is fully executable: three copy-paste-ready invocations of the gate (``uv run python .agents/skills/kiln-conventions/scripts/conventions_gate.py --worktree`` / ``--range`` / ``--files``), the exact output format (``SEV<TAB>RULE<TAB>path:line<TAB>snippet``), exit-code semantics, per-severity handling instructions, and a concrete example WARN justification. It matches the 5 anchor (copy-paste ready commands covering the common cases).

5 / 5

Workflow Clarity

A clear 5-step sequence with explicit validation (step 4 runs the gate on the change; exit 1 means a FAIL), feedback loops for error recovery (fix and re-run, allowlist with a reason line, or report an unfixable FAIL with rule id and path:line), and a checklist for what the gate cannot see (step 5's rule-by-rule self-check), plus a separate reviewer workflow. This matches the 5 anchor's "explicit validation steps; feedback loops; checklists".

5 / 5

Progressive Disclosure

The body is a workflow overview with well-signaled, one-level-deep references: a path-to-reference table tells the agent to read only ``references/rules.md`` plus the per-area file matching the edited paths (all four reference files and all cited scripts exist, and every rule id cited in the body is defined in rules.md). Content is appropriately split between SKILL.md, references, and scripts, and navigation is easy; the inline maintainer section is clearly labeled and too minor to drop this to the 4 anchor.

5 / 5

Total

19

/

20

Passed

Description

87%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 that explicitly states what the skill provides (conventions, per-area gotchas, an enforcing diff gate) and when to invoke it, with concrete repo paths and languages as triggers. Its only weakness is minor: the trigger vocabulary omits a few natural synonyms like "editing" or "refactoring".

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities — "Kiln's code conventions and per-area gotchas, plus a diff gate that enforces the mechanical ones" — and lists coverage topics ("comments, startup and entry points, globals and module state, config reads, module layering, library-vs-app rules and async I/O"), leaving only minor gaps. It falls short of the 5 anchor because it names content areas rather than multiple specific executable actions like "extract/fill/merge".

4 / 5

Completeness

It explicitly answers both questions: the "what" is "code conventions and per-area gotchas, plus a diff gate that enforces the mechanical ones" with a topic list, and the "when" is a concrete trigger clause ("Invoke before writing or changing any Python, TypeScript or Svelte code… and when reviewing such a change"). This matches the 5 anchor (clear what AND when with concrete trigger phrases); anchor 4 would require the "when" to be less explicit.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: "Invoke before writing or changing any Python, TypeScript or Svelte code in the Kiln repo… and when reviewing such a change", plus concrete paths (libs/core, libs/server, app/desktop, app/web_ui). A few natural variations users might say ("editing", "refactoring" Kiln code) are missing, so it fits the "good keyword coverage; a few natural terms missing" anchor rather than the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a named repo ("in the Kiln repo") with specific sub-paths and languages, giving it a clear niche with distinct triggers and minimal conflict risk with other skills. It is well above the 4 anchor ("minor overlap risk with closely related skills") because the repo and path scoping make false triggers very unlikely.

5 / 5

Total

18

/

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

Kiln-AI/Kiln

Path

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