CtrlK
BlogDocsLog inGet started
Tessl Logo

writing

将共享历史中的已验证事实和计算结果整理成符合受众、格式与长度约束的成稿。

62

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./chapter10/multi-role-transfer/skills/writing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 content is an efficient, actionable instruction block for a simple writing skill with clear single-action workflow and no unnecessary explanation. Its only weakness is minimal sectioning, though that is appropriate given its brevity.

DimensionReasoningScore

Conciseness

The body is a lean block that assumes Claude's competence — it states only non-obvious constraints ('保留必要的来源和限定条件', '不得编造引用', '最多调用一次 count_characters') with no padding, matching 'lean and efficient; every token earns its place'.

5 / 5

Actionability

It gives concrete, executable guidance including a specific tool name 'count_characters' and explicit do/don't rules ('直接输出最终答案', '不要...重复调用转换工具'), with only minor gaps versus fully copy-paste-ready examples, fitting 'mostly executable guidance'.

4 / 5

Workflow Clarity

This is a simple single-purpose skill whose single action is unambiguous — gather verified facts, respect constraints, optionally count once, then output directly — so per the simple-skills note workflow clarity scores 5.

5 / 5

Progressive Disclosure

Under 50 lines with no external references and a single well-placed heading, it is well organized for its size but lacks richer sectioning, fitting 'good structure; minor organization gaps' rather than the fully-sectioned 5 anchor.

4 / 5

Total

18

/

20

Passed

Description

58%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 concise and third-person, clearly stating what the skill does and its key constraints, but it lacks an explicit 'Use when...' trigger clause which caps completeness. Trigger term coverage is decent but not comprehensive.

Suggestions

Add an explicit trigger clause, e.g. 'Use when assembling a final draft from verified facts and computed results in the shared history.'

Include more natural synonyms users might say (e.g. 'final answer', 'write-up', 'draft', 'summary') to broaden trigger coverage.

Consider naming file/format extensions or output types if applicable to improve distinctiveness and trigger terms.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions — '整理...已验证事实和计算结果...成稿' constrained by '受众、格式与长度' — with only minor coverage gaps, matching the 'several specific actions; minor gaps' anchor.

4 / 5

Completeness

It gives a clear 'what' (organize verified facts and computation results into a constraint-conforming draft) but no explicit 'when'/'Use when' clause, so per the guideline completeness is capped at 3.

3 / 5

Trigger Term Quality

It includes relevant natural terms like '成稿', '受众', '格式', '长度' but misses common synonyms/variations and has no explicit trigger phrasing, fitting 'some relevant keywords but missing common variations'.

3 / 5

Distinctiveness Conflict Risk

The niche — drafting from shared-history verified facts with audience/format/length constraints — is fairly distinct with only minor overlap risk against general summarization skills, matching 'mostly distinct; minor overlap risk'.

4 / 5

Total

14

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
bojieli/ai-agent-book
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.