CtrlK
BlogDocsLog inGet started
Tessl Logo

minimal-prose-discipline

Writing-time discipline for the prose an agent speaks to a human (replies, reports, pointers): a protected core never rewritten (code, commands, paths, errors, negators, numbers), filler dies, no narration, auto-clarity where terse misleads

59

Quality

68%

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 ./skills/minimal-prose-discipline/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 disciplined, well-structured instruction-only skill: rules are specific, each carries an executable test, and a verification checklist closes the loop. The main gaps are the absence of a worked before/after prose example and minor verbosity in the rationale passages and the companion-relationship section.

Suggestions

Add one short before/after example pair (a padded reply and the same reply after the discipline) — for a writing skill this is the equivalent of executable code.

Trim the per-rule rationales that restate the rule (e.g. the filler and compression paragraphs each carry 1-2 sentences beyond what the test needs).

Merge or shrink the "Relationship to the other companions" section, which largely restates the Scope section's boundary.

DimensionReasoningScore

Conciseness

The body is tight and rule-dense — no padding, no explanations of concepts Claude already knows, and each rule carries only a rationale and a test. It is not a 5 because some rationales run past the rule itself (e.g. "the model already omits them by default when writing well, so a sentence built around them is load without signal") and the "Relationship to the other companions" section repeats distinctions the Scope section already drew.

4 / 5

Actionability

Concrete, specific guidance throughout: filler is enumerated by example ("just", "basically", "actually"; "sure", "of course"), negators listed ("not/never/no/only/except"), and every rule ends in an executable test plus a closing Verification checklist. It stops short of 5 because there is no worked before/after example of a reply applying the discipline — the closest thing to copy-paste-ready material for a writing skill.

4 / 5

Workflow Clarity

The application sequence is coherent (apply rules while writing → suspend the discipline in the enumerated risky passages → resume → verify via the closing checklist), and the Verification section provides explicit checkpoints. It is not a 5 because the process is presented as parallel rules rather than a sequenced flow, and the auto-clarity suspension/resumption loop is stated but not illustrated with a recovery example.

4 / 5

Progressive Disclosure

A single-file skill (~68 lines) with no external references, and none needed: every section (Scope, The Discipline, Auto-clarity, Relationship, Verification) is core content that belongs inline, with clear headers making navigation trivial. No bundle files exist, so all guidance is appropriately placed at the top level.

5 / 5

Total

17

/

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.

A dense, specific description that clearly defines the what and delineates scope from sibling disciplines, but it omits any explicit 'Use when...' trigger and leans on internal jargon, so users searching for natural terms like 'concise' or 'verbose' would not reliably surface it.

Suggestions

Add an explicit trigger clause, e.g. "Use when writing chat replies, status reports, or session-close summaries, or when the user asks for more concise/less verbose responses."

Include natural user vocabulary (concise, verbose, wordy, shorter replies) so trigger matching works against the phrases users actually say.

Replace or gloss internal jargon ("protected core", "auto-clarity") with plainer equivalents in the description; the body can keep the coined terms.

DimensionReasoningScore

Specificity

The description names the domain ("the prose an agent speaks to a human (replies, reports, pointers)") and lists several concrete behaviors: "a protected core never rewritten (code, commands, paths, errors, negators, numbers), filler dies, no narration, auto-clarity where terse misleads". It falls short of 5 only because the actions are compressed into rule names rather than a comprehensive capability list.

4 / 5

Completeness

The "what" is clearly stated (a writing-time discipline over conversational prose with enumerated rules), but there is no "Use when..." clause or equivalent explicit trigger guidance — "Writing-time discipline" only weakly implies when to invoke it. Per the judging guideline, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords exist ("prose", "replies", "reports", "filler", "narration", "terse"), but the natural phrases a user would actually say when they need this skill — "too verbose", "be more concise", "shorter replies", "wordy" — are absent, and terms like "protected core" and "auto-clarity" are skill-internal jargon rather than user vocabulary.

3 / 5

Distinctiveness Conflict Risk

The niche is sharply drawn — prose the agent speaks vs. artifacts it builds — and the scope is explicitly fenced ("replies, reports, pointers", not code or documents). It is not a 5 because the trigger phrasing does not itself distinguish it from sibling minimal-code/agent-doc disciplines, leaving minor overlap risk with general conciseness-style skills.

4 / 5

Total

14

/

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
Yeachan-Heo/oh-my-claudecode
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.