CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

77

Quality

96%

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

100%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 instruction-style skill body: everything is repo-specific and non-obvious, commands are copy-paste ready, the workflow embeds validation with explicit failure-handling loops, and bundle content is cleanly partitioned with all referenced files present. No changes needed.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence throughout: rule ids with one-line summaries, the exact output format "SEV<TAB>RULE<TAB>path:line<TAB>snippet", exit-code semantics, and config gotchas — no filler and no explanation of concepts Claude already knows. Even the maintainer and known-limitations sections are dense, non-inferable facts that earn their tokens.

5 / 5

Actionability

Fully executable guidance: three copy-paste-ready gate invocations ("uv run python .agents/skills/kiln-conventions/scripts/conventions_gate.py --worktree" etc.), the allowlist procedure with a reason-line format, and a concrete FAIL/WARN decision tree with an example justification. The self-check section converts each rule id into a checkable condition.

5 / 5

Workflow Clarity

A clear five-step sequence (read rules → read per-area references → write → run gate → self-check) where the gate is an explicit validation checkpoint, with feedback loops for error recovery (FAIL → fix and re-run; unfixable → report with rule id, path:line and the refactor it waits on) and a checklist for what the gate cannot see. The reviewer and maintainer workflows are separately sequenced.

5 / 5

Progressive Disclosure

The overview stays in SKILL.md while bulk content is split one level deep and verified to exist: rules in references/rules.md, per-area facts selected via a path→reference table (core.md, server_desktop.md, web_ui.md), and the gate plus its tests, config and allowlist under scripts/. The only external pointer (kiln-ui) is another skill, appropriately referenced rather than duplicated.

5 / 5

Total

20

/

20

Passed

Description

92%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, well-scoped description that states concrete capabilities, an explicit invocation condition, and a topic-coverage list. Third-person voice throughout, with only minor room to add common synonyms such as 'coding style' or 'PR review' to the trigger vocabulary.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — "code conventions and per-area gotchas", "a diff gate that enforces the mechanical ones" — alongside a comprehensive coverage list ("comments, startup and entry points, globals and module state, config reads, module layering, library-vs-app rules and async I/O") and concrete scopes ("Python, TypeScript or Svelte code", the four repo areas). It exceeds the level-4 anchor's 'minor gaps in coverage'.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' ("Kiln's code conventions and per-area gotchas, plus a diff gate that enforces the mechanical ones") and the 'when' ("Invoke before writing or changing any Python, TypeScript or Svelte code in the Kiln repo ..., and when reviewing such a change") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Python, TypeScript or Svelte code", "writing or changing", "reviewing such a change", and the concrete repo paths. A few natural synonyms users might say (e.g. "coding style", "lint", "PR") are missing, so it fits the level-4 anchor rather than the comprehensive-synonym level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

It is tightly scoped to the named Kiln repo with specific languages and directory paths, giving it a clear niche with minimal conflict risk; the one adjacent skill (kiln-ui) is explicitly carved out in the body. Not the level-4 anchor because there is no meaningful overlap risk with other skills.

5 / 5

Total

19

/

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