CtrlK
BlogDocsLog inGet started
Tessl Logo

codebase-design

用于设计深模块的共享词汇。适用于用户想设计或改进模块接口、寻找深化机会、决定 seam 放在哪里、让代码更容易测试或更适合 AI 导航,或其他技能需要深模块词汇时。

73

Quality

91%

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

92%

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

The content is lean, actionable, and well-organized for a design-vocabulary skill, with concrete examples and heuristics that respect Claude's intelligence. The main gap is progressive disclosure: the body points to two deeper references that do not exist as actual bundle files.

Suggestions

Either create DEEPENING.md and DESIGN-IT-TWICE.md with the promised content (dependency categories, seam discipline, design-it-twice sub-agent workflow) or remove those links so navigation is not broken.

If keeping the references, place them under a references/ directory and update the link paths, matching the standard bundle layout.

DimensionReasoningScore

Conciseness

The body is lean and dense: a purposeful glossary, minimal ASCII diagrams, and short code examples, with no padding explaining concepts Claude already knows — every section earns its tokens.

3 / 3

Actionability

It gives concrete, executable guidance: TypeScript testable-vs-hard-to-test code pairs, explicit design questions, and actionable heuristics like the 'deletion test' — concrete enough to apply immediately to a design task.

3 / 3

Workflow Clarity

As an instruction/design skill with no destructive or batch operations, the single-action guidance (apply the deep-module vocabulary and principles when designing code) is unambiguous, and the 'Designing for testability' section provides a clear numbered sequence — meeting the simple-skills allowance.

3 / 3

Progressive Disclosure

The 'Going deeper' section signals one-level-deep references to DEEPENING.md and DESIGN-IT-TWICE.md, but neither file exists in the bundle and there are no references/, scripts/, or assets/ directories, so the navigation is broken — matching the 'references present but not correctly backed / could be better organized' anchor rather than a clean split.

2 / 3

Total

11

/

12

Passed

Description

90%

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 is well-targeted: it states a clear purpose and an explicit, multi-part usage trigger covering the natural situations a user would mention. Its only weakness is framing the skill's behavior through user goals instead of naming the skill's own concrete actions.

Suggestions

Lead with the skill's own concrete actions (e.g. "Establishes a shared vocabulary for deep modules and applies it to interface design, seam placement, and testability") before listing user triggers.

DimensionReasoningScore

Specificity

The phrase "用于设计深模块的共享词汇" names the domain, and "设计或改进模块接口、寻找深化机会、决定 seam 放在哪里" lists several concrete situations, but it frames the user's goals rather than enumerating the skill's own concrete actions, landing at 'names domain and some actions, but not comprehensive' rather than a full action list.

2 / 3

Completeness

It explicitly answers both what ("用于设计深模块的共享词汇") and when ("适用于用户想设计或改进模块接口…时"), with an explicit trigger clause rather than only implied usage.

3 / 3

Trigger Term Quality

Natural trigger phrases a user would actually say are present — "设计或改进模块接口", "寻找深化机会", "决定 seam 放在哪里", "让代码更容易测试" — giving good coverage of terms the target audience would use.

3 / 3

Distinctiveness Conflict Risk

The niche is narrow and specific (deep-module design vocabulary, seam placement, AI navigability), with distinct triggers unlikely to fire for unrelated skills.

3 / 3

Total

11

/

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.