CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

domain-modeling

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/domain-modeling/SKILL.md

The canonical home for this skill is domain-modeling in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 tight, well-organized behavioral skill: concise, third-person-adjacent directives with concrete example phrasings and explicit decision criteria, and no concept padding. Its main defect is structural — both format references point at files absent from the bundle, so the promised detailed guidance is unreachable.

Suggestions

Add the referenced CONTEXT-FORMAT.md and ADR-FORMAT.md to the bundle (or inline the essential entry/ADR templates), since both links currently dangle and the skill depends on them for the exact formats.

Tighten progressive_disclosure by either shipping the format files under references/ with matching link paths or inlining a minimal example entry so the skill is self-contained.

Trim secondary tokens (the parenthetical contrast with 'merely reading CONTEXT.md' and one of the two ASCII layout trees) to push conciseness to the top anchor.

DimensionReasoningScore

Conciseness

The body is lean and directive — terse sections ("Challenge against the glossary", "Offer ADRs sparingly") with example phrasings and two compact file-layout trees, assuming Claude's competence throughout. A few tokens could be trimmed (the parenthetical contrasting with merely reading CONTEXT.md, and the two ASCII trees), so it sits just below the 'every token earns its place' 5 anchor and clearly above the 'some unnecessary explanation' 3 anchor.

4 / 5

Actionability

For an instruction-only skill the guidance is highly actionable: verbatim challenge phrasings ("Your glossary defines 'cancellation' as X... Which is it?"), three explicit numbered ADR criteria, and lazy-creation rules for files. It loses a point because the actual formats are delegated to CONTEXT-FORMAT.md and ADR-FORMAT.md, which are not in the bundle — so a key executable detail (the entry format) is unavailable — leaving minor gaps rather than fully complete guidance.

4 / 5

Workflow Clarity

The organization is clear and unambiguous: file-structure rules up front, then five concrete session behaviors each with an exact trigger and response, plus an explicit decision gate for ADRs (all three criteria or skip). No destructive or batch operations exist, so no validation cap applies; it is not a 5 because the sections are parallel heuristics rather than an explicitly sequenced process with checkpoints.

4 / 5

Progressive Disclosure

The body itself is well-sectioned and the two references are clearly signaled one level deep ([CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md), [ADR-FORMAT.md](./ADR-FORMAT.md)), but the bundle contains no such files and no references/ directory — both links are dangling, so the disclosed detail is actually missing. Scored against the actual bundle structure this is a real organization defect, placing it at 'some structure but could be better organized' (3) rather than the 'appropriately placed' 4 anchor.

3 / 5

Total

15

/

20

Passed

Description

78%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: it states a clear what and an explicit, multi-trigger when in third person, with the concrete artifact names (CONTEXT.md, ADR) doing real work. Weaknesses are mild — the what-clause itself is abstract ('build and sharpen') and glossary/naming synonyms are absent from the trigger set.

DimensionReasoningScore

Specificity

The what-clause "Build and sharpen a project's domain model" names the domain but the actions are generic, while the when-clause supplies the only concrete actions ("writing or editing a CONTEXT.md, or recording or editing an ADR"). This lands between the 'actions are minimal or generic' (2) and '1-2 concrete actions' (3) anchors — the concrete artifact-level actions in the trigger earn 3, but it is not a comprehensive action list so 4 is unwarranted.

3 / 5

Completeness

It explicitly answers what ("Build and sharpen a project's domain model") and when ("Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR") with three concrete trigger phrases — matching the top anchor. Not below 4 because the when-clause is explicit and multi-triggered, not weakly implied.

5 / 5

Trigger Term Quality

"codebase terminology", "CONTEXT.md", and "ADR" are natural terms a user would say, plus the artifact filename CONTEXT.md is an exact trigger — good keyword coverage. Common synonyms like "glossary", "naming", "ubiquitous language", or the spelled-out "architecture decision record" are missing, which keeps it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Domain modeling with CONTEXT.md/ADR triggers carves a fairly clear niche with distinct file-based triggers. Minor overlap risk remains with general documentation and code-review skills that also touch ADRs or terminology, so it does not fully reach the 'minimal conflict risk' 5 anchor.

4 / 5

Total

16

/

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

tonykay/transcriber

Path

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