CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kb-lint

Health-check a knowledge base and report structural, content, and cross-reference problems by severity — dead links, index drift, orphans, stale claims, unresolved contradictions. Reports only; never repairs without approval. Use when the user says lint, health check, review the wiki, or check consistency.

Quality

95%

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-only skill body: tight, operational check definitions with severity tiers, an explicit safety gate for running lint scripts, prompt-injection hygiene, and a concrete report format with coverage disclosure. No padding, no inferred-only steps, and structure appropriate to a self-contained skill.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: "A report, not a repair. Read `./CLAUDE.md`, then scan" and one-line check definitions like "broken link — a link whose target file does not exist" with zero concept explanations. Every line carries non-obvious policy (e.g., "Compare resolved commits, not tag spellings"), matching the 'every token earns its place' anchor; the level-4 anchor's 'minor instances of over-explanation' cannot be identified.

5 / 5

Actionability

For an instruction-only skill the guidance is fully operational: exact paths (wiki/index.md, log.md, raw/), machine-checkable check definitions ("overclaimed support — `support: solid` on a page whose `sources:` lists one"), an explicit safe-script gate, and a concrete report format ("Group by severity, numbered, each with the file path and the one-line fix"). Per the rubric's code-vs-instruction note, the absence of code is not penalized; the level-4 'minor gaps' anchor fits worse than fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The sequence is explicit and ordered (read CLAUDE.md → script-first inspection with skip-and-report on unsafe behavior → independent inventory → checks → report), with validation checkpoints throughout: "a successful exit is not proof that every check ran", "State which files and checks were covered and which were skipped. Never present a partial scan as a clean bill of health", and error paths for a missing index or unsafe script. The read-only lint has coverage verification standing in appropriately for fix-retry loops, matching the level-5 anchor.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed: the skill is self-contained with clear sections (Script first, Scan, Checks, Report, Rules) and easy navigation, and the checks catalog is needed on every invocation so inlining it is the correct placement. The level-4 anchor requires 'minor organization gaps', which are absent; content is appropriately (not) split for a skill of this size.

5 / 5

Total

20

/

20

Passed

Description

88%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 states concrete capabilities, an explicit safety boundary, and explicit trigger guidance in third person. The only weaknesses are a few missing natural trigger synonyms and slight overlap risk with generic code-lint/consistency requests.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete reported problems — "dead links, index drift, orphans, stale claims, unresolved contradictions" — plus severity grouping and a reports-only boundary ("Reports only; never repairs without approval"). This matches the comprehensive-coverage anchor; nothing is vague or padded, and the level-4 anchor's 'minor gaps in coverage' does not apply since the problem taxonomy is complete for a KB lint.

5 / 5

Completeness

It explicitly answers both questions: 'what' via "Health-check a knowledge base and report structural, content, and cross-reference problems by severity" and 'when' via an explicit "Use when the user says..." clause with concrete trigger phrases. This is a direct match to the level-5 anchor; level 4 ('when' could be more explicit) is undercut by the enumerated trigger list.

5 / 5

Trigger Term Quality

The trigger clause "Use when the user says lint, health check, review the wiki, or check consistency" gives good natural-phrase coverage, but common variations like "audit the wiki", "find broken links", or "knowledge base check" are absent. This fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym/extension coverage of the level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The knowledge-base/wiki niche is clear and triggers like "review the wiki" are distinct, but bare "lint" and "check consistency" are common programming terms that could also fire for code-linting or code-consistency requests — minor overlap with closely related skills. Not the minimal-conflict clarity of level 5, but well above the broad overlap of level 3.

4 / 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

bibryam/minimal-karpathy-llm-wiki-skill

Path

skills/kb-lint/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.