CtrlK
BlogDocsLog inGet started
Tessl Logo

domain-modeling

构建并打磨项目的领域模型。适用于用户想明确领域术语或通用语言、记录架构决策,或其他技能需要维护领域模型时。

64

Quality

77%

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

80%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is lean, non-padded, and highly actionable with concrete paths, example phrasings, and an ADR gate, but its session guidance reads as behavioral tips rather than a checkpointed workflow, and the two referenced format files do not exist in the bundle.

Suggestions

Provide the referenced CONTEXT-FORMAT.md and ADR-FORMAT.md files (or inline the formats), since both links currently resolve to nonexistent files.

Reframe the 'During the session' guidance as an explicit sequenced workflow with validation checkpoints (e.g., verify glossary consistency after each update) to lift workflow clarity.

Tighten the opening paragraph's defensive clarification about merely reading CONTEXT.md, which adds length without actionable value.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it never explains what a domain model or ADR is — with every section earning its place; the brief opening clarification nudges but does not cross into verbosity, matching the level-3 anchor.

3 / 3

Actionability

It gives concrete file paths (CONTEXT.md, docs/adr/, CONTEXT-MAP.md), copy-ready dialogue examples ('Your glossary defines "cancellation" as X, but you seem to mean Y'), and a specific 3-criteria ADR gate; for an instruction-only skill this is concrete and actionable per the rubric's code-vs-instruction note.

3 / 3

Workflow Clarity

The 'During the session' subsections are sequenced (challenge → sharpen → discuss → cross-reference → update inline → offer ADRs) and the ADR criteria act as a gate, but the steps are behavioral guidelines rather than a hardened process with explicit validation checkpoints, matching the level-2 anchor.

2 / 3

Progressive Disclosure

The body is well-sectioned and signals one-level-deep references via '使用 [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md) 中的格式' and [ADR-FORMAT.md](./ADR-FORMAT.md), but neither referenced file exists in the bundle, so the disclosure leads to dead links rather than detail, which keeps it below level 3.

2 / 3

Total

10

/

12

Passed

Description

75%

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 cleanly states a distinct niche and an explicit when-to-use trigger, but the capability description is a single domain-plus-verb rather than a list of concrete actions, and the trigger terms lean on DDD jargon over natural phrasings.

DimensionReasoningScore

Specificity

Quotes '构建并打磨项目的领域模型' name the domain and a core action (build/refine), but do not enumerate multiple concrete actions as the level-3 anchor requires; it sits above level 1 because it is not vague.

2 / 3

Completeness

It answers both what ('构建并打磨项目的领域模型') and when via an explicit trigger clause ('适用于...时'), satisfying the level-3 anchor; it is not capped at 2 because an explicit Use-when-style trigger is present.

3 / 3

Trigger Term Quality

The clause '适用于用户想明确领域术语或通用语言、记录架构决策' supplies several trigger conditions, but '通用语言' (ubiquitous language) and '领域模型' are DDD jargon and common phrasings are under-covered, matching the level-2 anchor.

2 / 3

Distinctiveness Conflict Risk

Domain modeling with triggers like domain terms, ubiquitous language, and architecture decisions is a clear niche unlikely to fire for unrelated skills, matching the level-3 anchor.

3 / 3

Total

10

/

12

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.

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