CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

domain-modeling

Build and sharpen the domain model. Trigger: codebase terminology, AGENTS.md, ADRs.

57

Quality

72%

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 ./ywai/skills/domain-modeling/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 lean, disciplined instruction-only skill with genuinely actionable behavioral guidance and good structural clarity. Its one serious defect is that both of its file references are dangling, so the formats it depends on for updating AGENTS.md and creating ADRs are unavailable.

Suggestions

Create the referenced AGENTS-FORMAT.md and ADR-FORMAT.md bundle files (or inline short format examples for each) so the 'Update AGENTS.md inline' and ADR sections are complete without broken links.

Convert the 'During the session' section into a loose ordered flow (detect conflict → sharpen → stress-test → cross-reference → record) with an explicit resolution loop for the contradictions the skill asks the agent to surface.

DimensionReasoningScore

Conciseness

The body is lean with no padding: sections like 'Challenge against the glossary' and 'Offer ADRs sparingly' give instructions in 1-3 sentences each. The single parenthetical aside ('Merely *reading* `AGENTS.md` for vocabulary is not this skill...') does real scope-setting work rather than over-explaining what Claude already knows.

5 / 5

Actionability

Concrete, executable guidance throughout — example challenge dialogue ('Your glossary defines "cancellation" as X, but you seem to mean Y. Which is it?') and a crisp three-condition ADR checklist. It falls short of 5 only because the actual glossary and ADR formats are deferred to AGENTS-FORMAT.md and ADR-FORMAT.md, which do not exist in the bundle, leaving the two most concrete tasks without their format details.

4 / 5

Workflow Clarity

The process is clearly organized (file structure detection via CONTEXT-MAP.md, then session behaviors, then lazy file creation), and 'Cross-reference with code' acts as a verification checkpoint. Not 5: the session behaviors are presented as parallel patterns rather than a sequenced flow with explicit checkpoints, and no explicit feedback loop is described for resolving the contradictions the skill tells the agent to surface.

4 / 5

Progressive Disclosure

Sections are well-organized and the body is appropriately short, but both references — '[AGENTS-FORMAT.md](./AGENTS-FORMAT.md)' and '[ADR-FORMAT.md](./ADR-FORMAT.md)' — point to files that do not exist anywhere in the bundle (no references/ directory, no such files at the root). Navigation to the load-bearing format details is broken, which is worse than having no references at all.

2 / 5

Total

15

/

20

Passed

Description

57%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 terse description with explicit trigger guidance and a distinct niche, but it undersells the skill's actual capabilities. Listing the concrete actions from the body (challenge conflicting terms, maintain the AGENTS.md glossary, write ADRs) would lift both specificity and completeness.

Suggestions

State the concrete actions in the description, e.g. 'Challenge conflicting terminology, maintain the AGENTS.md glossary, and record hard-to-reverse decisions as ADRs.'

Add natural trigger variations users would actually say, such as 'glossary', 'domain terms', or 'ubiquitous language', alongside 'codebase terminology'.

Phrase the trigger as a usage clause ('Use when the user discusses domain terms, mentions AGENTS.md/ADRs, or vocabulary conflicts arise') to reach full completeness.

DimensionReasoningScore

Specificity

'Build and sharpen the domain model' names the domain but offers a single generic action phrase — it never states the concrete capabilities the body delivers (challenge conflicting terms, write glossary entries, create ADRs). This matches anchor 2 ('Names the domain but actions are minimal or generic'); it is not 3 because no second concrete action is stated.

2 / 5

Completeness

Both parts are present: 'Build and sharpen the domain model' answers what, and 'Trigger: codebase terminology, AGENTS.md, ADRs' is equivalent explicit trigger guidance, so the missing-'Use when' cap does not apply. Not 5: the 'what' is a single thin sentence and the trigger phrases are bare nouns rather than concrete usage phrases.

4 / 5

Trigger Term Quality

The trigger 'codebase terminology, AGENTS.md, ADRs' includes some relevant keywords, but misses natural variations a user would actually say — 'glossary', 'domain terms', 'ubiquitous language'. Matches anchor 3 ('Some relevant keywords but missing common variations or synonyms'); not 4 because those gaps are noticeable.

3 / 5

Distinctiveness Conflict Risk

'domain model', 'AGENTS.md', and 'ADRs' carve out a recognizable niche with distinct file-based triggers. Minor overlap risk remains with general documentation- or writing-oriented skills, so it falls just below anchor 5.

4 / 5

Total

13

/

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

YoizenSA/dev-ai-workflow

Path

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