CtrlK
BlogDocsLog inGet started
Tessl Logo

semi-design-guide

使用 Semi Design 组件的完整指南,包括 MCP 工具使用流程、常见模式、最佳实践。当你需要查询 Semi Design 组件、生成组件代码或解决使用问题时,请使用此技能。

55

Quality

62%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./ecosystem/semi-ui-skills/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%

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

The body is a clean, well-structured index that sets up the MCP tooling and points to focused reference files, but it relies on bundle files that are missing, leaving its actionable guidance, workflow, and progressive disclosure incomplete.

Suggestions

Add the missing WORKFLOWS.md and BEST_PRACTICES.md bundle files so the referenced navigation links resolve to real content.

Remove the overlap between "概述" and "文件说明", and trim the "包含" bullet lists to brief purpose statements so the index stays lean.

Include at least a minimal concrete usage example or the first step of the MCP query workflow directly in the body so the skill is actionable without the bundle files.

DimensionReasoningScore

Conciseness

The body is a reasonably lean index, but the "概述" section overlaps with "文件说明", the "包含" bullet lists enumerate bundle-file contents as mild padding, and "Semi Design 是字节跳动推出的企业级 UI 组件库" lightly explains context Claude largely already knows.

2 / 3

Actionability

It provides one concrete, copy-paste-ready artifact (the MCP server JSON config), but the core usage instructions are delegated to WORKFLOWS.md/BEST_PRACTICES.md rather than given in the body, leaving key details incomplete.

2 / 3

Workflow Clarity

A four-step sequence is signaled ("查找组件 → 查询详情 → 查看源码 → 查看函数实现"), but it appears only as a description of WORKFLOWS.md's contents, with no validation checkpoints or feedback loops presented in the body itself.

2 / 3

Progressive Disclosure

The overview is well-organized with clearly signaled one-level-deep references and a navigation table, but the referenced bundle files (WORKFLOWS.md, BEST_PRACTICES.md) do not actually exist, so content is not genuinely split and the links are dead.

2 / 3

Total

8

/

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 is well-targeted to a distinct niche and answers both what and when with an explicit trigger clause, but its second-person voice and slightly padded first sentence prevent top marks on specificity and trigger-term breadth.

DimensionReasoningScore

Specificity

The description lists concrete actions ("查询 Semi Design 组件、生成组件代码或解决使用问题"), which would normally reach 3, but it uses explicit second-person voice ("当你需要...请使用此技能" / "When you need... please use this skill"), which per the guidelines reduces specificity by 1.

2 / 3

Completeness

It clearly states what the skill does ("使用 Semi Design 组件的完整指南,包括 MCP 工具使用流程、常见模式、最佳实践") and provides an explicit trigger clause ("当你需要...请使用此技能"), answering both what and when.

3 / 3

Trigger Term Quality

It includes relevant natural terms ("Semi Design 组件", "生成组件代码", "查询") but lacks common variations such as specific component names (Table/Form) or "UI 组件库", so coverage is incomplete.

2 / 3

Distinctiveness Conflict Risk

"Semi Design" is a specific named product with triggers tied to its own components and tooling, giving it a clear niche that is unlikely to conflict with other skills.

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, 1 suspicious

Warning

Total

15

/

16

Passed

Repository
DouyinFE/semi-design
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.