CtrlK
BlogDocsLog inGet started
Tessl Logo

natural-writing

Contains well-defined rules for creating natural, accurate, and readable writing. Use whenever authoring longer text, like analysis documents, PR or CL descriptions, or documentation.

69

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

90%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 body is an exemplary rules skill: dense, concrete, and free of the very AI-isms it bans, with bad/good example pairs throughout that make every rule directly checkable. Its only soft spot is that it presents a rule catalog without any guidance on applying it during a writing pass, which leaves workflow clarity and progressive disclosure at a strong-but-not-perfect level.

DimensionReasoningScore

Conciseness

The body is a lean rule catalog: every section states a rule plus one short bad/good pair (e.g., '"The library *is* a center for learning."'), with no padding, no explanation of concepts Claude already knows, and no introductory throat-clearing beyond two sentences. It matches anchor 5 ('lean and efficient; every token earns its place') and exceeds anchor 4 because there are essentially no over-explanatory passages to trim.

5 / 5

Actionability

As an instruction-only skill, the guidance is fully actionable: exhaustive banned-word lists ('delve, underscore, ... nestled'), precise replacement patterns ('Bad/Good' example pairs), and unambiguous rules like 'Never generate a citation unless you are looking at the source'. This meets the rubric's instruction-skill standard for a 5 — specific guidance whose examples cover the common cases — and is above anchor 4 because there are no gaps in coverage of the stated failure modes.

5 / 5

Workflow Clarity

This is a single-purpose rules skill, so no multi-step sequence is expected, and the single action (apply these rules when authoring) is largely unambiguous — matching the simple-skill provision. It sits at anchor 4 rather than 5 because the body never says when or how to apply the rules in a writing workflow (e.g., draft freely, then check against sections 1-4 before finishing), leaving a minor gap in how the six sections are ordered or used together; no validation cap applies since nothing destructive or batch-oriented is involved.

4 / 5

Progressive Disclosure

A single SKILL.md with no bundle files, organized into six numbered sections with clear sub-headers and no nested references — nothing is buried and navigation is easy. It earns anchor 4 rather than 5 because at ~150 lines it exceeds the under-50-line simple-skill case: the word lists in section 1 and the rules catalog are appropriately inline, but there is no overview/navigation aid or split of long reference material, which keeps it just short of the top anchor.

4 / 5

Total

18

/

20

Passed

Description

78%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 well-formed description with an explicit 'Use whenever...' clause and natural trigger artifacts, mirroring the strongest reference examples in structure. Its main weakness is that the 'what' stays abstract ('contains well-defined rules') rather than naming concrete capabilities such as identifying AI-isms or rewriting flagged patterns.

Suggestions

Name 1-2 concrete capabilities in the what-clause (e.g., 'Flags and rewrites AI-isms — overused vocabulary, puffery, and formulaic structures — in drafted text') to raise specificity from generic 'rules' to concrete actions.

Broaden trigger synonyms to cover other natural long-form artifacts users mention, such as blog posts, essays, reports, or READMEs, to approach comprehensive trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("natural, accurate, and readable writing") and a single general action ("Contains well-defined rules for creating...") but lists no concrete operations comparable to 'extract text, fill forms'. Anchor 3 (domain plus 1-2 concrete actions, not comprehensive) is the closest fit; it is above anchor 2 because the purpose is stated more concretely than 'Processes PDF files', and below anchor 4 because no several specific actions are enumerated.

3 / 5

Completeness

Both parts are explicit: what ("Contains well-defined rules for creating natural, accurate, and readable writing") and when ("Use whenever authoring longer text, like analysis documents, PR or CL descriptions, or documentation") with concrete trigger phrases. This mirrors the anchor-5 example structure; a weaker 'what' keeps it from being ambiguous, and anchor 4 would require a less explicit 'when' than the one present.

5 / 5

Trigger Term Quality

"Use whenever authoring longer text, like analysis documents, PR or CL descriptions, or documentation" covers natural phrases users would say (PR/CL descriptions, documentation, analysis documents). It falls short of anchor 5 because common synonyms like 'blog posts', 'essays', 'reports', or 'README' are missing, but exceeds anchor 3's 'some relevant keywords' breadth.

4 / 5

Distinctiveness Conflict Risk

"natural-writing" with triggers around longer-form authoring is mostly distinct from data/file-manipulation skills, but 'documentation' and 'PR or CL descriptions' overlap with dedicated documentation and commit-message writing skills. Minor overlap with closely related skills matches anchor 4; it is above anchor 3 because the natural/human-readable framing is a clear niche, and below anchor 5 because the 'authoring longer text' trigger is fairly broad.

4 / 5

Total

16

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
flutter/agent-plugins
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.