CtrlK
BlogDocsLog inGet started
Tessl Logo

utility-components

使用 BK-CI 中的具体工具组件时使用,例如 JWT、安全认证、表达式解析、线程池循环工具和责任链实现。当用户要直接复用这些组件而不是设计框架级实践时优先使用。

59

Quality

74%

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 ./ai/skills/utility-components/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 well-organized, concise router-style body whose entire value depends on four reference files that are missing from the bundle, leaving it with no actionable payload. Fixing the bundle layout would lift most dimensions substantially.

Suggestions

Ship the four cited reference files (or correct the paths) — the skill currently routes users to reference/1-jwt-security.md, reference/2-expression-parser.md, reference/3-thread-pool-loop-util.md, and reference/4-chain-responsibility.md, none of which exist; also align the directory name with the bundle's references/ convention.

Remove the duplicated reference list: 延伸阅读 repeats the exact mapping already given in 快速指导 step 3, and 高信号规则 restates its routing rules — keep one canonical map.

Add one concrete inline pointer per topic (e.g., the key class or entry point for JWT and the expression parser) so the skill retains some actionability even before the reference files are opened.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no concept explanations, no padding — e.g., '工具组件应该优先复用现有实现,而不是重复造轮子'. Minor trims possible: the reference file list is duplicated between 快速指导 and 延伸阅读, and 高信号规则 partially restates 快速指导, keeping it below 5.

4 / 5

Actionability

The topic-to-file routing table ('JWT:reference/1-jwt-security.md' etc.) is concrete, but the guidance dead-ends there: no usage specifics, commands, or examples are given inline, and every referenced file is absent from the bundle. This is 'some concrete guidance but incomplete' rather than mostly executable (4).

3 / 5

Workflow Clarity

快速指导 gives a clear numbered routing sequence — classify the question, pick the topic, enter the corresponding reference doc, else switch to common-technical-practices / microservice-infrastructure — which is unambiguous for this simple router-style skill. No destructive or batch operations, so no validation cap applies; a 5 would require slightly crisper decision criteria for borderline cases.

4 / 5

Progressive Disclosure

The body is structured as a clean one-level overview pointing to four reference files, which would score well — but none of the cited paths (reference/1-jwt-security.md through reference/4-chain-responsibility.md) exist in the bundle, and the directory name 'reference/' does not even match the conventional 'references/'. Navigation fails at the root, so the disclosure structure cannot function.

2 / 5

Total

13

/

20

Passed

Description

75%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 solid description with an explicit use-when clause, natural trigger terms, and a clear contrast against sibling framework-level skills. Its main gap is that the 'what' — what the skill actually provides for these components — is implied by enumeration rather than stated.

DimensionReasoningScore

Specificity

Enumerates concrete component areas ('JWT、安全认证、表达式解析、线程池循环工具和责任链实现') and the action '直接复用这些组件', giving several specifics. It falls short of 5 because it lists topics rather than stating what the skill concretely does with them (e.g., locate, apply, or reuse patterns).

4 / 5

Completeness

The 'when' is explicit ('使用 BK-CI 中的具体工具组件时使用' and '当用户要直接复用这些组件...优先使用'), avoiding the cap at 3 for missing trigger guidance. The 'what' is only implied by the component enumeration rather than explicitly stated, keeping it below 5.

4 / 5

Trigger Term Quality

Contains natural terms a user would actually say — 'JWT', '安全认证', '表达式解析', '线程池', '责任链' — plus the platform name 'BK-CI'. Not 5 because common synonyms and variations (e.g., 鉴权, token, 批量处理) are absent.

4 / 5

Distinctiveness Conflict Risk

The explicit contrast '而不是设计框架级实践' clearly separates it from framework-practice and microservice-infrastructure skills, giving it a distinct niche. Minor overlap risk remains because '安全认证' is broad and could collide with general security skills.

4 / 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-ci
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.