CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-technical-diagrams

创建、编辑、诊断并验收说明对象组成、连接、流程、状态、时序、接口或因果机制的技术图解与工程文档。用于说明/培训图、系统与网络拓扑、流程与 SFC、电气/仪控图、机械剖面、科学机制图及其可编辑原生源;按用途与 assurance 区分说明、培训、维护和受控工程声明,不用于以数值规律为主的数据图、保留真实地理位置的地图、产品工作台或参数仿真。

68

Quality

86%

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

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

An unusually rigorous governance-oriented skill body: the gate workflow with per-failure returns and claim ceilings is exemplary, and references are real, one level deep, and conditionally signaled. Weaknesses are repetition of the proof/hash governance across sections and the lack of any worked example showing a filled contract or gate record.

Suggestions

State the proof/scoped-evidence/hash rule once (e.g., in the media and verification contract section) and have td4/td6/td7 rows reference it by name instead of restating it, cutting significant repeated tokens.

Add a compact worked example of one filled 领域契约 record (operation_mode, subtype, positive_for, not_evidence_for, excluded_claims) for a common subtype such as a system topology diagram, so the abstract field list becomes executable.

Move the detailed decoration and image-background rules (color bars, gradients, layered backgrounds) into references/patterns.md, keeping only a one-line gate reference in SKILL.md.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence with no basic-concept padding, but the proof/scoped-evidence/hash governance rules are restated at least four times (media contract section, td4/td6/td7 gate rows, completion conditions), and long gate-table cells repeat the same constraints. This matches 'mostly efficient but could be tightened' rather than the minor-trimming anchor at 4.

3 / 5

Actionability

Highly concrete guidance for an instruction-only skill: exact operation modes (Create|Edit|Diagnose|Audit), exact record fields (operation_mode, positive_for, not_evidence_for, excluded_claims, input_hash, output_hash, build_hash, view_id/purpose/included_ids/claim_scope), and gate ids td0–td7 with defined failure returns. It falls short of fully executable because no worked example of a filled domain contract or gate record is provided, and key machinery (Registry, shared governance from $visual-artifact-design) is referenced but not defined in the bundle.

4 / 5

Workflow Clarity

The td0→td7 gate table gives a clear ordered sequence where every step defines inputs, promotion evidence, claim ceiling, and an explicit failure-return target (e.g., '语义错回 td3;原生/同步错回 td4'), plus a dedicated failure-and-return section. This is exactly the explicit-validation-with-feedback-loops pattern of the top anchor.

5 / 5

Progressive Disclosure

Both referenced files (references/patterns.md, references/tool-profiles.md) exist, are one level deep, and are well signaled with conditional load instructions ('需要子型模型…时读取…;需要选择工具时只读取相关的…'). Minor gap: detailed decoration/visual-semantics rules (color bars, gradients, image backgrounds) are inlined in SKILL.md though they fit the patterns.md mandate, matching the minor-organization-gaps anchor.

4 / 5

Total

16

/

20

Passed

Description

92%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: concrete actions, an explicit when- clause with trigger domains, and deliberate boundary exclusions that minimize conflict with neighboring skills. The only meaningful gap is the absence of natural synonyms and file extensions in the trigger terms.

DimensionReasoningScore

Specificity

The description lists four concrete actions ("创建、编辑、诊断并验收") with a comprehensive enumeration of diagram types (系统与网络拓扑、流程与 SFC、电气/仪控图、机械剖面、科学机制图) and explicit non-goals ("不用于以数值规律为主的数据图、保留真实地理位置的地图、产品工作台或参数仿真"). Coverage extends beyond actions to claim levels, matching the comprehensive anchor rather than the minor-gaps anchor.

5 / 5

Completeness

It explicitly answers "what" (create, edit, diagnose, and accept technical diagrams and engineering documentation) and "when" with concrete trigger phrases ("用于说明/培训图、系统与网络拓扑、流程与 SFC…") plus explicit exclusions ("不用于…"). The trigger guidance is explicit and concrete, matching the top anchor rather than the weaker-'when' anchor at 4.

5 / 5

Trigger Term Quality

Good keyword coverage of natural domain terms (拓扑, 流程, SFC, 时序, 电气/仪控, 机械剖面, 培训图, 技术图解) that users would plausibly say. Missing common synonyms and file extensions (e.g., 原理图, 架构图, .vsd, .dwg), so it falls short of the comprehensive-synonyms anchor at 5 but sits clearly above the missing-variations anchor at 3.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (relational/engineering technical diagrams and their editable native sources) and explicitly disclaims adjacent domains (numeric data charts, geographic maps, product workbenches, parameter simulation), which sharply reduces overlap with dataviz or mapping skills. Minimal conflict risk, matching the clear-niche anchor.

5 / 5

Total

19

/

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

EverMind-AI/Raven

Path

plugins-dist/design-engine/raven_design/skills/create-technical-diagrams/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.