A well-structured, appropriately brief instruction-only skill that gives concrete, actionable guidance for authoring and normalizing BK-CI skills, backed by a specific acceptance checklist. It consistently lands at 'good with minor gaps': mild redundancy across sections, no example description rewrite, and an unverifiable cross-skill reference.

Suggestions

Add a short before/after example of a weak vs. strong `description` rewrite, since tightening descriptions is the skill's most-cited action but has no illustrative example.

Deduplicate the overlapping guidance between 快速指导, 高信号规则, and 验收清单 (e.g., main-file restraint and content-sinking rules appear three times) to reclaim tokens.

Make the "00-bkci-global-architecture" reference resolvable (a path or link) and add a brief instruction for what to do when the 验收清单 fails, to close the validation feedback loop.

Dimension	Reasoning	Score
Conciseness	The body is lean and high-signal with no generic-concept padding, but "快速指导", "高信号规则", and "验收清单" restate overlapping ideas (e.g., main-file restraint appears in all three forms), leaving minor trimming opportunities that keep it below anchor 5.	4 / 5
Actionability	Provides concrete numbered guidance, a copy-paste-ready recommended skeleton, and a specific acceptance checklist ("只使用小写、数字、连字符", "约 40-80 行"), but the highest-leverage action — rewriting a `description` — lacks a before/after example, so it is not fully anchor 5.	4 / 5
Workflow Clarity	The 快速指导 steps give a clear sequence (determine responsibility → write description → tighten main file → sink content to reference/ → scripts → links) and the 验收清单 acts as a terminal validation checkpoint, but there is no explicit error-recovery loop if the checklist fails, keeping it at anchor 4.	4 / 5
Progressive Disclosure	Well-organized single-file skill with one-level-deep references only (`../../HARNESS.md`) and nothing inlined that belongs in separate files; however, "00-bkci-global-architecture" is a bare skill name with no resolvable path and no bundle files exist to verify navigation, so it falls just short of anchor 5.	4 / 5
	Total	16 / 20 Passed

Description

83%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 strong, third-person, bilingual-domain description that states both concrete capabilities and explicit use-when triggers for skill authoring/normalization in BK-CI. Its only weaknesses are incomplete synonym/variation coverage and slight overlap risk on the generic verbs "压缩/重构".

Dimension	Reasoning	Score
Specificity	Names the domain (BK-CI skill authoring) and several concrete actions — "收紧 `description`、统一主文件骨架、下沉重内容到 `reference/`，并固化渐进式披露规则" — which exceeds the 1-2 actions of anchor 3 but stops short of the comprehensive coverage of anchor 5 (e.g., no auditing or validating existing skills).	4 / 5
Completeness	Explicitly answers both "what" (tighten description, unify skeleton, sink heavy content to reference/, enforce progressive disclosure) and "when" ("编写、压缩或重构 BK-CI skill 时使用…当用户要新增或规范化 skill 时优先使用") with concrete trigger phrases, matching anchor 5.	5 / 5
Trigger Term Quality	Includes natural phrases users would say ("编写、压缩或重构", "新增或规范化 skill") with good coverage, but misses common variations such as "SKILL.md 太长" or "拆分文档", so it falls just short of the synonym-level coverage of anchor 5.	4 / 5
Distinctiveness Conflict Risk	Clear niche (BK-CI skill meta-authoring) with distinct triggers, but "压缩或重构" creates minor overlap risk with a generic document-compression skill, placing it just below anchor 5's minimal-conflict bar.	4 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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
Path: ai/skills/skill-writer/SKILL.md
Commit: d5420f2

Reviewed: 9 days ago

Table of Contents

Discovery Implementation Validation

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.