CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pencil-design

使用 Pencil MCP 创建/编辑 .pen 设计文件,或导出为 React 代码。 Use when: 设计 UI、编辑 .pen 文件、从设计稿生成代码。 Not for: 纯代码实现(无设计稿)、非 Pencil 工具的设计工作。 Output: .pen 设计文件 或 React/Tailwind 组件代码。

Quality

83%

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.

The body is an unusually disciplined operational SOP: concrete tool inventory, hard limits, an explicit workflow with validation checkpoints and feedback loops, and a mistakes table drawn from real failures. Its main weaknesses are narrative padding from project anecdotes that could be compressed into bare rules, and the absence of a skill-owned reference bundle, leaving everything inline.

Suggestions

Compress the war-story anecdotes (F076 quote, F174 D2b, '明厨亮灶' philosophy) into one-line rules — e.g., 'dark command-center styling on warm-palette products gets rejected; screenshot existing UI first' — keeping the lesson while cutting the narrative.

Add one or two literal MCP call examples (e.g., an open_document argument payload and a 2-op batch_design body) so request shapes are copy-paste ready rather than inferred from prose.

Split the Common Mistakes table and the Style Consistency Gate SOP into a references/ file (e.g., references/style-gate.md) so SKILL.md stays a lean overview with well-signaled, in-bundle one-level-deep references.

DimensionReasoningScore

Conciseness

The body is mostly dense and useful (tool table, hard limits, path rules), but includes several narrative asides that could be tightened: the quoted operator reaction in the F076 story ('不能说一模一样,只能说毫不相关'), the 'F174 D2b 教训' reference, and the '明厨亮灶' philosophy flavor text. These project anecdotes carry some signal but are padded beyond what the actionable rule needs, matching the 'mostly efficient but could be tightened' anchor.

3 / 5

Actionability

Highly concrete guidance: exact MCP tool names with purposes, the hard limit 'batch_design 每次最多 25 ops', the literal command 'git rev-parse --show-toplevel', and a concrete filename example ('F096-interactive-rich-blocks-ux.pen'). Minor gaps keep it below a 5: no literal call/argument examples (e.g., a sample batch_design op or open_document payload), so the reader must infer the exact request shapes.

4 / 5

Workflow Clarity

The workflow diagram lays out a clear sequence with explicit validation steps (get_editor_state first, get_screenshot verification, side-by-side style comparison, post-save re-open via open_document to verify integrity) and feedback loops for error recovery ('不一致 → 修正配色/布局后重新 batch_design'; '否决 → 记录反馈 → 回到 batch_design'). Batch operations are explicitly bounded and validated, matching the top anchor.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so all content is inline in a well-sectioned ~145-line body. The two external references ('../.cat-cafe-shared-refs/in-context-observability-checklist.md' and 'interaction-narrative.md') are clearly signaled one level deep with stated purpose, but they point outside the skill bundle, and at this length the Common Mistakes table and style-gate SOP sit at the edge of what belongs inline. Good structure with minor organization gaps rather than an exemplary overview-plus-references split.

4 / 5

Total

16

/

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.

The description is a strong example: it states concrete capabilities in third person, gives an explicit 'Use when' clause with natural trigger phrases, defines boundaries with 'Not for', and declares its output format. The only weakness is slightly incomplete action coverage (no mention of reading/analyzing existing designs) and a few missing natural synonyms.

DimensionReasoningScore

Specificity

Names the domain (Pencil MCP, .pen files) and several concrete actions — '创建/编辑 .pen 设计文件' and '导出为 React 代码' — plus explicit output artifacts ('.pen 设计文件 或 React/Tailwind 组件代码'). Minor gaps in coverage: reading/analyzing existing designs and screenshot verification, which the body covers, are not mentioned; not comprehensive enough for a 5.

4 / 5

Completeness

Clearly and explicitly answers both 'what' ('使用 Pencil MCP 创建/编辑 .pen 设计文件,或导出为 React 代码') and 'when' ('Use when: 设计 UI、编辑 .pen 文件、从设计稿生成代码') with concrete trigger phrases, and goes further with 'Not for' exclusions and an explicit 'Output' line. This matches the top anchor exactly.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — '.pen 文件', '设计稿', '设计 UI', '从设计稿生成代码' — giving good coverage including the file extension. A few natural synonyms users might say (原型/prototype, mockup, '切图') are missing, and the bare keyword 'pencil' lives in the separate triggers field rather than the description, so it falls short of the comprehensive-synonym anchor at 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Pencil MCP + .pen files) with distinct triggers and minimal conflict risk; the 'Not for: 非 Pencil 工具的设计工作' and 'Not for: 纯代码实现(无设计稿)' clauses explicitly fence off the nearest overlapping skills (other design tools, pure coding).

5 / 5

Total

18

/

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

zts212653/clowder-ai

Path

cat-cafe-skills/pencil-design/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.