CtrlK
BlogDocsLog inGet started
Tessl Logo

tech-writing

技术文章对外写作:把内部实践变成读者能代入、证据可见的文字与页面叙事。 Use when: 写技术博客、公众号文章、社区分享、对外 longform、技术文章 review、文章配图与推广语。 Not for: 内部文档/spec(直接写)、PPT(用 ppt-forge)、单独生成图片(用 image-generation)、纯调研报告(用 deep-research)。 Output: 文章叙事弧 + claim/证据边界 + 视觉叙事图谱 + 页面级自检。

68

Quality

84%

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

81%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-crafted, opinionated writing skill: tightly phased workflow with explicit gates and a feedback loop, plus concrete good/bad examples that make the guidance executable. Main gaps are minor repetition across sections, reliance on unexplained internal codenames, and a couple of loosely signaled reference paths.

Suggestions

Deduplicate the metaphor-budget and source-audit guidance, which appear in both Phase 3/技术叙事 and Common Mistakes, to reclaim tokens and sharpen the checklist.

Briefly gloss internal codenames (F102, F200, KD-8, F203, 猫咖/operator) on first use, or replace them with generic role names, so the guidance is executable without the internal repo context.

Link and annotate refs/ai-taste-checklist.md the way refs/visual-narrative.md is linked, and either bundle or one-line-summarize the docs/lessons exemplars and the shared narrative-clarity reference.

DimensionReasoningScore

Conciseness

The body is dense craft guidance with no padding over concepts Claude already knows — pairs like 'AI 味 = "我们发现这个系统存在一致性风险。" vs 猫咖味 = "深夜三点,Redis 6399 突然报错…"' earn their tokens. It is not a 5 because points repeat across sections (the 'one core metaphor budget' rule appears in Phase 3 and again verbatim-ish in Common Mistakes, and the source-audit caveat appears twice), so it could be tightened.

4 / 5

Actionability

Concrete, executable guidance throughout: the 铁律 with bad/good rewrites, translation examples ('KD-8 架构 → 就像把判断权交给开车的猫'), a specified Figure Contract field list (reader question / claim / source / form / five-second takeaway / caption), and a feedback-to-fix table. It stops short of 5 because key examples lean on unexplained internal codenames (F102, F200, KD-8, F203, 猫咖, operator) and a Figure Contract template is described but never shown filled in, leaving minor gaps for an agent without the internal repo context.

4 / 5

Workflow Clarity

Phases 0–6 form a clear sequence, ending with an explicit pipeline ('写完一章 → 对 claim 建 Figure Contract → 听文字节奏并缩小看页面 → 过 Phase 4 门禁 → 给operator审钩子与五秒结论 → 发布') that includes validation gates (Phase 4 自检, 五秒测试), a checklist reference, and a feedback-recovery loop (Phase 6 maps each complaint type to a concrete fix). This matches the 5 anchor's sequence + explicit validation + feedback loops + checklist.

5 / 5

Progressive Disclosure

Structure is good: detailed visual-narrative material is properly deferred with a clearly signaled one-level-deep link ('见 [`refs/visual-narrative.md`](refs/visual-narrative.md)'), and section headers organize the phases. It is not a 5 because 'refs/ai-taste-checklist.md' is mentioned without a link or annotation of its contents, and the other references (docs/lessons exemplars, ../.cat-cafe-shared-refs/narrative-clarity.md) are neither bundled nor summarized, so navigation relies on paths that cannot be verified from this bundle.

4 / 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: explicit what/when/not-for structure, concrete output artifacts, natural Chinese trigger phrases, and explicit routing away from sibling skills. The only minor weaknesses are artifact-level rather than action-level specificity and a couple of missing trigger synonyms.

DimensionReasoningScore

Specificity

The description names the domain ('技术文章对外写作:把内部实践变成读者能代入、证据可见的文字与页面叙事') and lists several concrete deliverables ('文章叙事弧 + claim/证据边界 + 视觉叙事图谱 + 页面级自检'), which is a list of specific actions. It is not a 5 because the phrasing stays at the artifact level without naming the concrete editorial actions (e.g., rewriting with time anchors, figure contracts) that fully cover the skill's scope.

4 / 5

Completeness

It explicitly answers both what ('把内部实践变成…文字与页面叙事' plus a concrete Output line) and when ('Use when: 写技术博客、公众号文章…'), with concrete trigger phrases. It goes further than the 5 anchor by also adding a 'Not for' exclusion clause, so it clearly matches the top anchor.

5 / 5

Trigger Term Quality

The 'Use when' clause packs in natural phrases users would actually say ('写技术博客、公众号文章、社区分享、对外 longform、技术文章 review、文章配图与推广语'), supplemented by a frontmatter triggers list with synonyms like 博客, 公众号, 推广语, 视觉叙事. A few natural variations (e.g., '写篇文章', '技术传播') are missing, so it falls just short of comprehensive synonym coverage at 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (external-facing technical longform writing) and actively disambiguates adjacent skills in the 'Not for' clause ('PPT(用 ppt-forge)、单独生成图片(用 image-generation)、纯调研报告(用 deep-research)'), giving minimal conflict risk — exactly the clear-niche pattern of the 5 anchor.

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.

Validation14 / 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 missing, 1 suspicious

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.