CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

mcclowes/writing-style

Max's house writing style and grammar for any prose you generate for him - docs, READMEs, PR descriptions, commit messages, Slack, emails, code comments, error messages, blog posts, and replies in chat. Use this whenever you are writing or editing English prose meant for Max or sent on his behalf, even when he doesn't explicitly ask for a particular style. Apply it by default to anything wordier than a one-line answer; favour warm-but-blunt, concise writing, US English, sentence case, the Oxford comma, and zero AI jargon. Do not use it for code itself, config, or data formats.

Quality

92%

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

Overview
Quality
Evals
Security
Files

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 body is a dense, highly actionable style guide: literal banned-word lists, five before/after transformations, a self-check heuristic, and context-specific calibration. The soft spots are conciseness and progressive disclosure — the mic-drop rule is explained twice, and at roughly 95 lines the banned lists and examples could be externalized to keep SKILL.md leaner.

Suggestions

Fold the Example 5 explanation into the mic-drop bullet in "Rhythm and structure" (or vice versa) — the rule is currently explained in full twice, and one occurrence can carry the point.

Move the banned word/phrase lists and/or the five worked examples into a one-level reference file (e.g., references/banned.md, references/examples.md) referenced from the body, keeping SKILL.md to the core voice rules and letting the lists load on demand.

DimensionReasoningScore

Conciseness

The body is dense and Max-specific throughout — it states preferences rather than explaining concepts Claude already knows, and the banned word/phrase lists are compact list-form with no padding. Minor trimmable redundancy keeps it below a 5: the mic-drop rule is fully explained in "Rhythm and structure" and then re-demonstrated with its own explanation in Example 5, the dash guidance recurs in Example 4's parenthetical, and there are flavor asides ("(Yes, even though he's British about most things...)").

4 / 5

Actionability

For an instruction-only skill this is maximally actionable: literal banned word and phrase lists that can be cut on sight ("delve, leverage (as a verb), utilize..."), five concrete before/after transformation pairs covering the common failure cases, an executable self-check ("read your first sentence. If deleting it loses nothing, delete it"), and per-context calibration with concrete examples ("Fix race condition in cache eviction").

5 / 5

Workflow Clarity

A simple single-task skill (apply these style rules whenever writing prose for Max) whose single action is unambiguous: a governing principle up front ("When in doubt, cut words and warm up the tone"), hard rules, then a "Calibration by context" section that sequences how the formality dial moves by output type. No destructive or batch operations exist, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The single-file body is well organized with a logical section flow (voice → hard rules → banned → padding → marketing tone → rhythm → examples → calibration) and no buried content. However, the rubric's simple-skill carve-out (a 5 from well-organized sections alone) covers only skills under 50 lines with no need for external references; this body is roughly 95 lines, and the banned word/phrase lists and five worked examples are inlined where a one-level reference file could hold them to keep the core file lean.

4 / 5

Total

18

/

20

Passed

Description

95%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 near-exemplary description: it names a precise niche, enumerates the concrete surfaces it covers and the specific style rules it applies, and gives an explicit "Use this whenever..." trigger with a default-on clause and clear exclusions. The only deduction is the second-person voice ("you generate", "you are writing"), which the rubric penalizes on specificity.

DimensionReasoningScore

Specificity

The description comprehensively enumerates concrete surfaces ("docs, READMEs, PR descriptions, commit messages, Slack, emails, code comments, error messages, blog posts, and replies in chat") and concrete style rules ("US English, sentence case, the Oxford comma, and zero AI jargon"), which is anchor-5 material. However, it is written in second person ("any prose you generate for him", "whenever you are writing or editing English prose"), which the judging guidelines explicitly penalize by reducing specificity by 1.

4 / 5

Completeness

Both what and when are explicit and concrete: the what names the house style and its specific rules, and the when is a multi-conditioned explicit trigger ("Use this whenever you are writing or editing English prose meant for Max or sent on his behalf, even when he doesn't explicitly ask for a particular style") plus a default-on clause and a negative boundary ("Do not use it for code itself, config, or data formats").

5 / 5

Trigger Term Quality

Natural trigger terms cover the domain comprehensively: "docs, READMEs, PR descriptions, commit messages, Slack, emails, code comments, error messages, blog posts" are exactly the words a user says when asking for prose, and "writing or editing English prose" plus "anything wordier than a one-line answer" catch the remainder. No meaningful natural terms are missing for a prose-style skill.

5 / 5

Distinctiveness Conflict Risk

"Max's house writing style" is a clear personal niche with distinct triggers, and the explicit exclusions for code, config, and data formats preclude overlap with adjacent skills. A request to write prose for Max is unambiguous.

5 / 5

Total

19

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Reviewed

On this page