CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

knowledge-engineering

猫猫指导外部项目文档重构 — AI FDE 知识工程方法论。 Use when: 猫猫部署到外部项目、用户项目缺少结构化文档、需要知识工程指导、冷启动理解业务。 Not for: cat-cafe 项目自身开发、已有完善 docs/ 结构的项目(直接用 CatCafeScanner)。 Output: 文档现状诊断 + 路径选择 + 三层知识注入建议 + 文档骨架模板。

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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-constructed instructional skill: the workflow is clearly phased with user-confirmation feedback loops and a verifiable completion standard, and the guidance is unusually concrete for a non-code skill. Its main structural weakness is monolithic packaging — all four templates live inline in SKILL.md with no reference files, working against progressive disclosure.

Suggestions

Move the four 文档骨架模板 (模板 1-4, ~100 lines) into references/ (e.g. references/template-domain-glossary.md, template-business-rules.md, template-action-mapping.md, template-pattern.md) and have Phase 4 link to them, keeping SKILL.md as an overview.

Deduplicate the 特殊场景处理 section: scenarios C and D are already summarized in the Phase 1 table, so keep only the expanded handling steps and drop the repeated判定信号 or cross-reference the table.

Trim framing overhead: remove the "方法论来源" line whose reference was already redacted, and compress the "核心认知" paragraph to one sentence since the point is restated in Phase 3.

DimensionReasoningScore

Conciseness

The body is dense and instructional with essentially no explanation of concepts Claude already knows, but a few passages could be trimmed — the "核心认知" framing paragraph, the "方法论来源" line with a removed internal reference, and the 特殊场景处理 section which re-expands scenarios C and D already summarized in the Phase 1 table. That matches the efficient-with-minor-trimming anchor.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: numbered 指导步骤 for each knowledge layer, literal question scripts ("A 和 B 能同时存在吗?什么条件下不行?"), exact deliverable paths (project-research/domain-glossary.md), four copy-paste-ready markdown templates, and a completion checklist with quantified coverage ("中型项目通常 10-15 个").

5 / 5

Workflow Clarity

Four phases are explicitly sequenced (assess → path selection → P0→P1 injection → templates) with user-confirmation checkpoints at each step ("请用户确认/补充/修正", "和用户确认", "生成推导报告,展示给用户确认"), a decision gate ("不替用户选——呈现事实后等用户决定"), and a final checklist verified via search_evidence() examples. The operations are documentation-creation, not destructive/batch, so no cap applies.

5 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), and roughly 100 lines of fill-in template skeletons are inlined in the single SKILL.md where they clearly belong in separate reference files the skill could point to. Section structure itself is good, which keeps this above the score-2 'minimal structure' anchor, but content that should be separate is inline with no external references, matching the score-3 anchor.

3 / 5

Total

17

/

20

Passed

Description

87%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 description: it names concrete outputs, gives an explicit Use-when list with a complementary Not-for boundary, and carries natural trigger phrases. The only weakness is mild internal-jargon usage ("三层知识注入", "路径选择") whose meaning is not self-evident from the description alone.

DimensionReasoningScore

Specificity

The description lists four concrete deliverables ("文档现状诊断 + 路径选择 + 三层知识注入建议 + 文档骨架模板") plus a named action ("指导外部项目文档重构"), matching the anchor for several specific actions with minor gaps. It is not a 5 because "三层知识注入" and "路径选择" are internal methodology jargon whose concrete meaning is only unpacked in the body.

4 / 5

Completeness

It explicitly answers both questions: what it does ("文档现状诊断 + 路径选择 + 三层知识注入建议 + 文档骨架模板") and when to use it ("Use when: 猫猫部署到外部项目、用户项目缺少结构化文档..."), plus an explicit "Not for" exclusion — matching the anchor that clearly answers both with concrete trigger conditions.

5 / 5

Trigger Term Quality

Triggers include the natural user phrase "帮我整理文档" plus solid domain terms ("文档重构", "冷启动", "知识工程", "knowledge engineering"), giving good keyword coverage as in the score-4 anchor. It falls short of comprehensive (score 5) because natural English phrasings like "help me organize/document our project" and common synonyms are missing.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (external-project knowledge engineering) with an explicit negative scope ("Not for: cat-cafe 项目自身开发、已有完善 docs/ 结构的项目(直接用 CatCafeScanner)"), which both distinguishes it from and de-conflicts with the related scanner skill — minimal conflict risk.

5 / 5

Total

18

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

zts212653/clowder-ai

Path

cat-cafe-skills/knowledge-engineering/SKILL.md

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.