CtrlK
BlogDocsLog inGet started
Tessl Logo

lirantal/writing-style-explainer

Gives you writing style instructions for Explainer type articles including tone of voice, writing style, structure, content formatting and more.

55

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is concise and well-structured with a clean pointer to a real reference file, but it stops short of executable examples or validation steps that would make the style rules fully actionable and verifiable.

Suggestions

Add a short before/after example illustrating the inline-link rule and the opening-paragraph constraint so guidance is concrete and copy-paste ready.

Include a verification step or checklist (e.g. 'Confirm ≥3 inline canonical links and no terminal References section before publishing') to close the feedback loop.

Optionally surface one or two high-value fields from writing-style.json (e.g. structure_pattern) inline so users get the shape without opening the asset.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — each rule states a constraint and its rationale with no padding or explanation of concepts Claude already knows.

3 / 3

Actionability

It gives concrete prohibitions and a measurable rule (≥3 descriptive inline links) but provides no executable examples or templates illustrating the expected output, leaving guidance partially abstract.

2 / 3

Workflow Clarity

Rules are listed as numbered steps but there are no validation checkpoints or feedback loops to verify an article conforms, which the rubric flags for batch/risky operations.

2 / 3

Progressive Disclosure

The body is a concise overview that points to a real one-level-deep reference (assets/writing-style.json) with a clearly signaled link, and the referenced file exists.

3 / 3

Total

10

/

12

Passed

Description

50%

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 conveys the skill's purpose and domain clearly but lacks an explicit 'Use when...' trigger and relies on the vague 'and more' instead of concrete capabilities. It is competent but not exemplary.

Suggestions

Add an explicit trigger clause, e.g. 'Use when writing or editing an Explainer-type technical article and you need the correct tone, structure, and formatting rules.'

Replace 'and more' with concrete specifics (e.g. 'inline linking rules, opening-paragraph constraints, section ordering') so capabilities are comprehensive.

Include natural trigger terms users would say, such as 'blog post', 'technical article', or 'style guide'.

DimensionReasoningScore

Specificity

Names the domain ('Explainer type articles') and lists several aspects ('tone of voice, writing style, structure, content formatting') but trails off with 'and more' rather than enumerating concrete actions, so it is not comprehensive.

2 / 3

Completeness

It states what the skill does but has no 'Use when...' or equivalent explicit trigger guidance, which per the rubric caps completeness at 2.

2 / 3

Trigger Term Quality

Includes relevant terms ('writing style', 'Explainer type articles') that a user might say, but misses common variations such as 'blog post', 'technical article', or 'style guide' and leans on the vague 'and more'.

2 / 3

Distinctiveness Conflict Risk

'Explainer type articles' carves out a niche, but the description is generic enough to overlap with other writing/editing style skills.

2 / 3

Total

8

/

12

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.

Reviewed

Table of Contents