CtrlK
BlogDocsLog inGet started
Tessl Logo

write

Rewrites and polishes Chinese or English prose, technical instructions, and product copy. Use when drafting, editing, localizing, or cutting AI tone. Not for code comments or commit messages.

71

Quality

89%

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

The canonical home for this skill is write in tw93/Waza

SKILL.md
Quality
Evals
Security

Quality

Content

92%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-structured, judgment-heavy editing skill: the body stays a routing and stance layer, defers the smell catalogs to one-level-deep references that all exist, and anchors the workflow with an executable, verified punctuation gate and explicit done-when criteria. The only real cost is mild redundancy and a few overlong compound sentences.

DimensionReasoningScore

Conciseness

The body is dense operational rule-content with no concept-explaining padding ("Over-editing is failure, equal to under-editing", "Most polish is subtraction"), but a few rules are restated across sections (the author's-own-draft per-sentence list appears in Core Stance and again in Output) and several bullets are overlong compound sentences (the "A piece has a speaker" bullet) that could be trimmed.

4 / 5

Actionability

The Mode Picker routes each ask to a named file ("Contains Chinese characters (default prose) loads `references/write-zh.md`"), the Punctuation Gate block is executable after one explicitly documented substitution ("Replace `<skill-base-dir>` with the installed Write skill or Waza dispatcher directory"), and the gate script exists in scripts/ and passes a smoke test; the Gotchas table maps concrete observed failures to concrete rules.

5 / 5

Workflow Clarity

The sequence is clear (Pre-flight 1-2-3, Mode Picker, mode procedures, Hard Rules, Punctuation Gate, Output contract with explicit "Done when" criteria) and validation is explicit and mandatory ("Before returning any produced text ... resolve the checker across install layouts and run it", "Fix every finding while preserving meaning"), with feedback loops in Gotchas ("Re-review the fix diff itself"), a Document Review checklist, and batch-edit reconciliation; the batch-operation validation cap does not trigger because validation is present.

5 / 5

Progressive Disclosure

SKILL.md is a routing hub whose every referenced path resolves in the bundle (all 10 references/*.md files plus scripts/check-punctuation.sh verified present), references are one level deep with only well-signaled lateral sibling pointers (e.g., write-technical.md -> write-product-localization.md), and each mode row names exactly which file to load and when.

5 / 5

Total

19

/

20

Passed

Description

83%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 that explicitly states what, when, and what-not with a concrete trigger clause and an explicit exclusion boundary. Its only weakness is that trigger coverage inside the description field itself misses several natural synonyms that the frontmatter's separate when_to_use field carries.

DimensionReasoningScore

Specificity

"Rewrites and polishes Chinese or English prose, technical instructions, and product copy" names the domain and the when-clause adds several concrete actions ("drafting, editing, localizing, or cutting AI tone"), fitting the several-specific-actions anchor; it is not 5 because the body's own mode table (document review, paragraph coherence, tweet/social posts, bilingual drift checks) shows coverage gaps.

4 / 5

Completeness

It explicitly answers both what ("Rewrites and polishes Chinese or English prose, technical instructions, and product copy") and when with concrete trigger phrases ("Use when drafting, editing, localizing, or cutting AI tone"), matching the anchor-5 good-example structure exactly; the when-clause is explicit and specific, not weakly implied.

5 / 5

Trigger Term Quality

The description carries natural user phrasings ("drafting", "editing", "localizing", "cutting AI tone") with good coverage, but the description field itself omits common variations users say ("proofread", "rewrite", "review this document", "推特/tweet") that the skill's own when_to_use field and body modes demonstrate.

4 / 5

Distinctiveness Conflict Risk

The explicit exclusion boundary ("Not for code comments or commit messages") and the bilingual/AI-tone niche keep it mostly distinct with minimal conflict risk, but the generic trigger verbs "drafting, editing" carry minor overlap risk with closely related writing skills, fitting anchor 4 rather than the narrow-niche anchor 5.

4 / 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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
tw93/Waza
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.