CtrlK
BlogDocsLog inGet started
Tessl Logo

tech-writing

技术文章对外写作:从内部实践到读者能代入的叙事。 Use when: 写技术博客、公众号文章、社区分享、对外 longform、技术文章 review、写推广语。 Not for: 内部文档/spec(直接写)、PPT(用 ppt-forge)。 Output: 有呼吸感的技术文章 + 读者反馈聚类分析。

72

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

77%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable writing-craft skill with a clear phased workflow and validation gate, weakened only by metaphor-driven verbosity and a dangling reference to a non-existent checklist file.

Suggestions

Provide refs/ai-taste-checklist.md in a references/ bundle or inline its contents, since Phase 3 currently points to a file that is not present.

Trim the cat-cafe metaphor scaffolding (猫咖味/进化链) where a direct statement would carry the same guidance, reducing tokens without losing the editorial principles.

Convert the dangling external 范本 paths (cat-cafe-tutorials/docs/lessons/...) into a short note on what to look for, or bundle the excerpts, so the skill is self-contained.

DimensionReasoningScore

Conciseness

Mostly efficient and project-specific rather than explaining basics Claude knows, but the cat-cafe metaphors (猫咖味/进化链) and parenthetical flourishes add tokens that could be trimmed without losing the guidance.

2 / 3

Actionability

Concrete and specific for an instruction-only skill: named techniques with worked examples (时间锚点 '2026-02-04 23:47', 翻译句 arrows, bad/good pairs) and a numbered Phase 3 self-check table give copy-ready editorial heuristics.

3 / 3

Workflow Clarity

Clear phased sequence (Phase 0→5) with an explicit validation gate (Phase 3 门禁) and a feedback loop (Phase 5 拥抱负面反馈 → rewrite), summarized end-to-end in the 下一步 section.

3 / 3

Progressive Disclosure

Phases are well-organized and external 范本 paths are signaled, but refs/ai-taste-checklist.md is referenced while no references/ bundle directory exists — a dangling one-level reference that should be either supplied or inlined.

2 / 3

Total

10

/

12

Passed

Description

100%Weight 40%Scale 1-3

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 description that states concrete capabilities, gives natural trigger terms, and explicitly separates its scope from adjacent skills via Use when/Not for clauses.

DimensionReasoningScore

Specificity

Names the domain (技术文章对外写作) and lists multiple concrete actions — 写技术博客、公众号文章、社区分享、对外 longform、技术文章 review、写推广语 — plus a concrete Output (有呼吸感的技术文章 + 读者反馈聚类分析).

3 / 3

Completeness

Explicitly answers both what (对外技术文章写作 + Output) and when (Use when clause with concrete triggers, plus a Not for boundary), satisfying the highest anchor.

3 / 3

Trigger Term Quality

Good coverage of natural terms a Chinese-speaking user would say: 写文章, 技术分享, 博客, longform, 公众号, 对外发布, 社区分享, 推广语, reinforced by the Use when clause.

3 / 3

Distinctiveness Conflict Risk

Clear niche (对外技术写作) with an explicit Not for boundary (内部文档/spec, PPT 用 ppt-forge), making it unlikely to trigger for the wrong skill.

3 / 3

Total

12

/

12

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.

Validation15 / 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
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.