CtrlK
BlogDocsLog inGet started
Tessl Logo

quality-gate

开发完成后的自检门禁:愿景对照 + spec 合规 + 验证。 Use when: 准备对交付作完成声明、需要整理风险匹配的自证。 Not for: 收到 review 反馈(用 receive-review)、merge(用 merge-gate)。 Output: Spec 合规报告(含愿景覆盖度)。

60

Quality

70%

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 ./cat-cafe-skills/quality-gate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

This is a highly actionable, well-sequenced operational skill: every step carries exact commands, hard block conditions, and a concrete report template with error-recovery paths. Its weaknesses are token efficiency (heavy inline incident history and date-stamped revision notes) and structure (a monolithic ~280-line file with no bundle references, where lesson narratives and the dogfood/checklist detail belong in separate files).

Suggestions

Move incident-history narratives (F041, F177, F209 lessons with dates) into a separate lessons/appendix reference file, keeping only the operative rule and a one-line pointer in the main body — this would substantially cut token cost.

Extract the Step 4.5 Dogfood-Your-Slice details (scope rules, Why reflection, report format) and the Step 2.5 close-gate keyword matrix into dedicated reference files under references/, leaving short summaries with clear links in SKILL.md.

Consolidate date-stamped revision notes (e.g. "2026-07-15 修订", "2026-03-11 教训") into a single changelog/old-patterns section so time-sensitive text does not interrupt the workflow instructions.

DimensionReasoningScore

Conciseness

The ~280-line body inlines extensive incident history and dated revision narratives — e.g. "F041 教训:AC 全打勾,但operator的原始需求…根本没进 AC", "Why(F209 反思 2026-05-23): Phase B alias registry: AC-B1~B5 全 ✅…", and "2026-07-15 修订:raw keyword 自动 BLOCK 误杀正常文本" — which is padding that competes with operational instructions. It is above 1 because most of the underlying rules are project-specific and non-obvious rather than generic explanations of concepts Claude already knows, but the repeated lesson storytelling and inline date-stamped revisions are clearly unnecessary at this volume.

2 / 5

Actionability

Guidance is fully executable: exact commands ("curl -sf http://localhost:3004/health", "node scripts/check-hotfix-pattern.mjs", "pnpm check:architecture-ownership", "git status --short | rg '^.. [^/]+\.(png|jpe?g|webp|...)$'"), exact keyword lists for the tail scan, and a copy-paste-ready Quality Gate Report template covering the common cases. Confirmed not 4 because commands, expected outputs, and the report format are all specified with no material gaps.

5 / 5

Workflow Clarity

The process is a clearly sequenced Step 0 through Step 8 with explicit validation checkpoints (BLOCK rules, "任一命中 → BLOCK", "不得挑绿灯报告、隐去红灯") and error-recovery feedback loops ("Gate 未通过时: P1 遗漏 → 补完再过 gate", "修到绿灯再交付"). Matches the anchor-5 pattern of explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The body has real structure (named sections, Quick Reference table, report template) and signals external references with explicit paths ("schema: `../.cat-cafe-shared-refs/close-gate.md`", "执行细则:`../.cat-cafe-shared-refs/vision-evidence-workflow.md`") — but no bundle files exist (references/, scripts/, assets/ are absent) and large blocks that belong in separate reference files (the 60-line Dogfood-Your-Slice section, the close-gate keyword matrix, all incident-history narratives) are inlined in one monolithic file. Fits anchor 3 better than 2 because references are present and clearly signaled even though much content that should be separate is inline.

3 / 5

Total

15

/

20

Passed

Description

71%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.

The description is well-structured with explicit what/when/not-for boundaries and a concrete output artifact, giving it strong completeness and distinctiveness. Its main weakness is trigger phrasing: the natural trigger keywords live in a separate `triggers` frontmatter field while the description's own Use-when clause is formal and jargon-tinged.

Suggestions

Fold one or two natural trigger phrases (e.g. "开发完了", "准备 review", "自检") into the description's Use-when clause so the description field itself carries the terms users would actually say.

Replace the jargon phrase "需要整理风险匹配的自证" with plainer wording such as "需要用真实命令输出证明声明" to improve natural keyword coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "愿景对照 + spec 合规 + 验证" (vision check + spec compliance + verification), "整理风险匹配的自证" (assemble risk-matched evidence), and a concrete output artifact "Spec 合规报告(含愿景覆盖度)" (spec compliance report with vision coverage). Falls short of 5 because the actions are terse labels rather than fully enumerated capabilities, and above 3 because multiple specific actions plus a defined output are named.

4 / 5

Completeness

Both "what" (self-check gate performing vision check, spec compliance, and verification, producing a compliance report) and "when" ("Use when: 准备对交付作完成声明、需要整理风险匹配的自证") are explicitly present, plus a "Not for" boundary clause. Not 5 because the "when" clause uses formal phrasing rather than concrete natural trigger phrases, which anchor 5 requires; clearly above 3 since the when-clause is explicit, not weakly implied.

4 / 5

Trigger Term Quality

The description's own "Use when: 准备对交付作完成声明、需要整理风险匹配的自证" contains relevant terms (完成声明, review) but the phrasing is formal and misses common natural variations like "开发完了" or "自检" — those natural phrases only appear in the separate `triggers` frontmatter field, not in the description itself. Not 4 because keyword coverage within the evaluated description text is partial and jargon-leaning ("风险匹配的自证").

3 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (pre-completion self-check by the author) and explicitly disambiguates sibling skills: "Not for: 收到 review 反馈(用 receive-review)、merge(用 merge-gate)". This is the anchor-5 pattern of a distinct niche with minimal conflict risk.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
zts212653/clowder-ai
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.