CtrlK
BlogDocsLog inGet started
Tessl Logo

domain-modeling

构建并打磨项目的领域模型。适用于讨论 codebase 术语、编写或编辑 CONTEXT.md,或记录或编辑 ADR。

59

Quality

68%

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

Quality

Content

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

The body is an admirably lean, well-organized instruction skill with genuinely actionable example phrasings and crisp ADR criteria. Its critical defect is that both format references dangle — CONTEXT-FORMAT.md and ADR-FORMAT.md do not exist in the bundle — leaving the skill unable to deliver the output formats it mandates.

Suggestions

Add the missing CONTEXT-FORMAT.md and ADR-FORMAT.md files to the bundle (e.g. under references/), or inline the formats into SKILL.md if they are short, so the mandated output formats are actually available.

If the format files are added, point the links at their real paths (./references/CONTEXT-FORMAT.md) instead of ./CONTEXT-FORMAT.md.

Add a brief verify step after glossary or ADR updates (e.g. re-check that CONTEXT.md contains no implementation details) to give the workflow an explicit feedback loop.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no explanations of what domain modeling or ADRs are, no padding, and every section (file trees, example challenge phrasings, the three ADR criteria) earns its tokens — a clear match for anchor 5.

5 / 5

Actionability

Concrete guidance is strong in places — copy-ready challenge lines ("Your glossary defines 'cancellation' as X, but you seem to mean Y - which is it?") and three explicit ADR criteria — but the instructions "使用 [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md) 中的格式" and "使用 [ADR-FORMAT.md](./ADR-FORMAT.md) 中的格式" point to files that do not exist anywhere in the bundle, so the key details defining the required output formats are missing. This matches anchor 3 (some concrete guidance but incomplete, missing key details) rather than 4, since the gap is not minor.

3 / 5

Workflow Clarity

Behaviors are clearly organized with sequencing guidance ("立刻更新...不要批量攒到最后", lazy file creation rules) and a built-in check ("Cross-reference with code") that functions as a validation checkpoint, fitting anchor 4. It is not 5 because there is no explicit validate-and-recover loop for the glossary/ADR updates, though the skill involves no destructive or batch operations that would cap it at 3.

4 / 5

Progressive Disclosure

Section structure in SKILL.md itself is good and the two references are clearly signaled one level deep, but both referenced files (CONTEXT-FORMAT.md, ADR-FORMAT.md) are absent — there is no references/ directory or any other bundle file — so navigating to the format specifications fails entirely. Dangling references make the cross-file structure broken, which is a worse navigation failure than the buried references of anchor 3 and fits anchor 2.

2 / 5

Total

14

/

20

Passed

Description

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

The description has an explicit, well-formed 'use when' clause with three concrete triggers and occupies a fairly distinct niche. Its main weakness is a generic 'what' statement — 'build and polish the domain model' — that never names the concrete capabilities (glossary maintenance, terminology challenges, ADR authoring) the body actually delivers.

Suggestions

Replace the vague 'what' verb phrase with the skill's concrete capabilities, e.g. '维护项目术语表(CONTEXT.md)、挑战模糊术语、编写 ADR' so the description lists what the skill actually does.

Add missing natural trigger synonyms such as glossary/术语表, 架构决策记录, or ubiquitous language so users phrasing the need differently still match.

State the deliverables explicitly (a glossary file and ADR files under docs/adr/) to sharpen both specificity and distinctiveness.

DimensionReasoningScore

Specificity

The 'what' half is only "构建并打磨项目的领域模型" (build and polish the project's domain model) — the domain is named but the capability verbs are generic; concrete artifacts (CONTEXT.md, ADR) appear only in the 'when' clause, which matches anchor 3 (domain plus 1-2 concrete actions) better than anchor 2 since the trigger clause names real deliverables.

3 / 5

Completeness

Both halves are present: an explicit when-clause ("适用于讨论...编写或编辑 CONTEXT.md,或记录或编辑 ADR") with three concrete triggers, plus a what-clause. It sits at anchor 4 rather than 5 because the 'what' ("build and polish the domain model") is generic and does not enumerate concrete capabilities like maintaining a glossary or challenging terminology.

4 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are present — "codebase 术语", "CONTEXT.md", "ADR", "领域模型" — but common synonyms like glossary, 架构决策记录, or ubiquitous language are missing, fitting anchor 4 (good coverage, a few natural terms missing) rather than 5.

4 / 5

Distinctiveness Conflict Risk

The CONTEXT.md/ADR/domain-modeling niche is mostly distinct with clear triggers, matching anchor 4; there is minor overlap risk with general documentation or code-review skills, keeping it below anchor 5's 'clear niche with minimal conflict risk'.

4 / 5

Total

15

/

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
vinvcn/mattpocock-skills-zh-CN
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.