CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

glossary

Maintain a project's glossary of domain terms, usually in docs/GLOSSARY.md. Use when looking up terms, adding or updating definitions, renaming concepts, or auditing a glossary against repository docs, code, and decision records for missing, stale, duplicated, or misplaced entries.

Quality

90%

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

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

A well-structured, actionable instruction skill: three clearly sequenced modes, a concrete entry-format template, and sensible guardrails (propose-only audits, ambiguity checks before edits). The main improvement opportunities are removing the small redundancy between Workflow Notes and the conventions section, and adding a post-edit verification checkpoint.

Suggestions

Remove or merge the duplicated guidance — 'Before any edits, read the existing glossary' in Workflow Notes repeats the 'Discover the Local Convention' section.

Add an explicit post-edit verification step in Mode 2 (e.g. confirm the inserted entry follows the section's ordering and that any link target exists) to close the feedback loop.

Trim overlap between the 'Where a Term Goes' section-audience rules and the numbered list of 'Common sections' under glossary creation.

DimensionReasoningScore

Conciseness

Efficient and assumes Claude's competence ('Use `rg` to find real usage before defining or renaming a term'; 'Glossaries are usually short enough to load entirely'), but there is minor redundancy: 'Before any edits, read the existing glossary' in Workflow Notes restates the 'Discover the Local Convention' section, and the section-audience guidance slightly overlaps 'Where a Term Goes'. Fits the 4 anchor (minor trimming possible) rather than the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Concrete, executable guidance throughout for an instruction-only skill: a copy-paste entry-format template ('**Term** - One-line definition. Link to...'), concrete cross-link examples ('[ADR-005](adr/ADR-005-example.md)', '`src/example.ts`'), a specific command ('Use `rg`...'), and fully specified numbered steps per mode. Nothing is vague or pseudocode-like; fits the 5 anchor.

5 / 5

Workflow Clarity

Three modes with clearly sequenced numbered steps and real checkpoints: 'Confirm the term or a near-duplicate does not already exist', 'If the definition, canonical name, or placement is ambiguous, propose the wording first and ask the user to choose', and propose-only audits ('Keep audits propose-only unless the user explicitly asks'). Fits the 4 anchor due to a minor validation gap — no explicit verification step after applying an edit (e.g. re-checking placement or link validity post-edit) — so it does not reach the 5 anchor's explicit feedback loops.

4 / 5

Progressive Disclosure

A single self-contained file with a clear section hierarchy (what it is/is not, conventions, placement, ordering, format, three run modes, heuristics, notes) and no bundle files. Nothing that belongs in a separate file is inlined, there is no nesting, and navigation is easy — fitting the 5 anchor via the simple-skill exception for well-organized self-contained content.

5 / 5

Total

18

/

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 description: third-person, concise, and explicit about both what the skill does and when to use it, with specific trigger verbs covering lookup, update, rename, and audit workflows. The only weakness is modest synonym coverage for natural user phrasings.

Suggestions

Add common user phrasings as triggers, e.g. 'define a term', 'what does X mean in this project', or 'jargon/vocabulary' alongside 'looking up terms'.

Consider mentioning acronym expansion or alias handling in the description since these are first-class capabilities in the body.

DimensionReasoningScore

Specificity

Names the domain ('project's glossary of domain terms, usually in docs/GLOSSARY.md') and lists multiple concrete actions: 'looking up terms, adding or updating definitions, renaming concepts, or auditing... for missing, stale, duplicated, or misplaced entries'. Coverage spans all of the skill's modes comprehensively, matching the top anchor rather than the 'minor gaps' anchor below.

5 / 5

Completeness

Explicitly answers 'what' ('Maintain a project's glossary of domain terms, usually in docs/GLOSSARY.md') and 'when' ('Use when looking up terms, adding or updating definitions, renaming concepts, or auditing a glossary...') with concrete trigger phrases. This matches the 5 anchor exactly; the 4 anchor's weaker 'when' does not apply.

5 / 5

Trigger Term Quality

Natural keywords like 'looking up terms', 'adding or updating definitions', 'renaming concepts', and 'GLOSSARY.md' are present and would be said by users, but a few natural synonyms are missing ('define a term', 'jargon', 'vocabulary', 'what does X mean'). Falls between the 4 anchor ('good keyword coverage; a few natural terms missing') and the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (glossary maintenance) with distinct triggers (term lookup, definition updates, renaming, auditing against docs/code/decision records). Minimal overlap with other documentation skills; matches the 5 anchor ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

chattocorp/chatto

Path

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