CtrlK
BlogDocsLog inGet started
Tessl Logo

chat-x-custom-component

帮助开发者创建 @blueking/chat-x 自定义 message 组件。当用户需要开发自定义消息类型时使用。

53

Quality

67%

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 ./bcs-services/bcs-project-manager/.cursor/skills/chat-x-custom-component/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%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 brief, non-verbose overview that points to (nonexistent) reference files, but it fails as working guidance: the multi-step workflow is unelaborated labels, only one step has supporting code, and the navigation section is redundant and dangling. The skill reads as a stub whose real content was expected in the missing reference files.

Suggestions

Expand the four-step workflow into concrete sub-steps with an explicit validation or test checkpoint after integration (e.g. what to verify in MessageContainer before proceeding), instead of a single arrow diagram of bare labels.

Add executable code for steps 2-4 — a minimal component definition, the MessageContainer integration snippet, and a test/verification command — so the main flow is instructable from the body, not just step 1.

Fix navigation: remove the duplicated '📦 可用资源' section, annotate each reference with what it covers (e.g. 'API reference: see api-reference.md'), ensure the referenced files actually exist in references/, and either add the promised IF-THEN loading rules or delete the note citing them.

DimensionReasoningScore

Conciseness

The core content is lean with no over-explanation, but the entire '📦 可用资源' reference list is duplicated verbatim (lines 49-55 and 59-67) and a note references 'IF-THEN 规则' that do not exist in the body — clear waste that needs tightening, so not 4.

3 / 5

Actionability

Real TypeScript snippets exist for type extension and useMessageSlotId, but the workflow's core steps (create component, integrate into MessageContainer, test) have no code or specifics — the skill describes rather than instructs them, fitting 'some concrete guidance but incomplete'; not 4 due to these key gaps.

3 / 5

Workflow Clarity

The flow is a single arrow diagram of bare step labels ('1. 声明类型扩展 → 2. 创建组件 → 3. 集成到 MessageContainer → 4. 测试') with no elaboration, commands, or validation checkpoints — structurally identical to the anchor-2 example '1. Open the document / 2. Make changes / 3. Save and close'. Not 3 because checkpoints are not even implicit and only step 1 has any supporting detail.

2 / 5

Progressive Disclosure

The body has a sensible overview shape with sections and one-level references, but the reference list is a bare unannotated dump (no per-topic signaling), is duplicated, points to files that do not exist in the bundle (no references/ directory present), and the promised IF-THEN loading rules are absent. Not 2 because nothing that belongs in separate files is inlined.

3 / 5

Total

11

/

20

Passed

Description

73%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 concise, third-person description with an explicit 'use when' clause and a clearly distinct niche. Main weaknesses are limited action coverage (only 'create') and trigger phrasing that repeats the capability statement rather than adding concrete variations.

DimensionReasoningScore

Specificity

Names the domain (@blueking/chat-x custom message components) and one concrete action ('创建...组件'), matching the anchor for domain plus 1-2 concrete actions; it falls short of 4 because no further actions (register, integrate, test) are listed.

3 / 5

Completeness

Both are present: what ('帮助开发者创建 @blueking/chat-x 自定义 message 组件') and an explicit when-clause ('当用户需要开发自定义消息类型时使用'), so above the 3 cap. It is not 5 because the when-clause largely restates the what and could be more concrete with distinct trigger phrases.

4 / 5

Trigger Term Quality

'自定义 message 组件', '自定义消息类型', and '@blueking/chat-x' are natural trigger terms covering both English and Chinese phrasings, giving good keyword coverage; a few natural variations (e.g. 'custom message', '扩展消息类型') are missing, so not 5.

4 / 5

Distinctiveness Conflict Risk

Scoped to a single named library (@blueking/chat-x) and a single component type (custom message), a clear niche with distinct triggers and minimal conflict with other skills.

5 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
TencentBlueKing/bk-bcs
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.