CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cs-notes-writing-style

Write or refine Chinese technical notes and articles in a concise, evidence-led voice. Use for substantive drafting or rewriting, not every Chinese reply.

68

Quality

85%

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

82%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 dense, disciplined instruction-only skill: nearly every token is an executable directive, and risky edit operations are guarded by read-back and a closing checklist. The gaps are illustrative rather than structural — no before/after examples for a style skill, no recovery step behind the final checklist, and a cross-skill link that cannot be verified from this bundle.

Suggestions

Add one short before/after pair of Chinese sentences (e.g., a slogan-style sentence vs. its evidence-led rewrite) to make the voice rules concrete.

Extend the completion checklist with a recovery step (what to fix and re-check when an item fails), mirroring the read-back loop already used for collaborative edits.

Make the ../managed-lark-docs/SKILL.md link resolvable from this bundle, or inline the minimal patch/read-back steps so the Feishu-maintenance path is self-contained.

DimensionReasoningScore

Conciseness

Every sentence carries an executable directive ('用短句、明确主语、具体动词', '实验结论保留版本、条件、指标和适用范围'); there is no padding, no explanation of concepts Claude already knows, and nothing to trim — matching anchor 5's lean/every-token-earns-its-place standard, above anchor 4's 'minor instances of over-explanation'.

5 / 5

Actionability

Directives are concrete and checkable ('真正的数学公式使用块级数学语法', '先读最新内容与评论、高亮等人工标记,再做局部修改并读回'), but a style skill with no before/after example leaves some rules as judgment calls ('必要的技术密度', '结构健康时再做局部融入'), fitting anchor 4's minor-gaps level rather than anchor 5's specific examples covering common cases.

4 / 5

Workflow Clarity

A clear arc is present — prepare ('先确认读者、用途和落点') → writing/editing rules → final verification checklist ('完成时检查:读者能否理解核心判断…') — with an explicit read-back checkpoint for collaborative edits; but there is no error-recovery step when a checklist item fails, so it matches anchor 4 rather than anchor 5's explicit feedback loops. Validation for edit operations is present (read-back + checklist), so no destructive-operation cap applies.

4 / 5

Progressive Disclosure

The 25-line body is self-contained and appropriately scoped for its size, and its single external pointer ([managed-lark-docs](../managed-lark-docs/SKILL.md)) is clearly signaled and one level deep — but that path does not resolve in this bundle (no sibling skill or references/ directory exists), a minor organization gap that keeps it at anchor 4 rather than anchor 5's clean fully-verifiable structure.

4 / 5

Total

17

/

20

Passed

Description

82%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 two-sentence description that states what the skill does, when to use it, and when not to. Its only weakness is capability coverage: 'Write or refine' names just two actions, leaving specificity thinner than the rest of the description.

Suggestions

Name one or two more concrete actions in the description (e.g., restructures the heading tree of long notes, edits existing collaborative docs) to lift specificity beyond the two verbs 'Write or refine'.

Add one or two natural synonyms users would actually say (e.g., 'polish', 'edit', 'blog posts') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('Chinese technical notes and articles') and exactly two concrete actions ('Write or refine'), matching the 1-2-concrete-actions anchor; it does not list several specific actions (no restructuring, collaborative-doc editing, etc.), so it sits below anchor 4 and clearly above anchor 2's minimal/generic actions.

3 / 5

Completeness

'Write or refine Chinese technical notes and articles in a concise, evidence-led voice' explicitly answers the what, and 'Use for substantive drafting or rewriting, not every Chinese reply' is an explicit when-clause with concrete trigger phrases plus a negative guard — matching anchor 5's standard of both answered with concrete triggers; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'Chinese technical notes and articles', 'drafting or rewriting', 'refine', 'Chinese reply'. It misses common variations a user might say (e.g., 'edit/polish', 'blog posts', '中文文章'), fitting anchor 4 rather than anchor 5's comprehensive synonym coverage, and well above anchor 3's single-phrase level.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Chinese technical writing voice) with distinct triggers; the exclusion 'not every Chinese reply' and the 'substantive' qualifier actively prevent mis-triggering on general Chinese conversation or translation skills — minimal conflict risk per anchor 5, not merely 'mostly distinct' as in anchor 4.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

huangruiteng/CS-Notes

Path

.codex/skills/cs-notes-writing-style/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.