CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-shape

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Quality

70%

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 ./.agents/skills/writing-shape/SKILL.md

The canonical home for this skill is writing-shape in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-organized, lean process guide for a conversational writing workflow: clear loop, explicit checkpoints (prerequisite settlement, opening choice, per-block agreement), and concrete conversational moves and format rules. Weaknesses are minor — undefined completion criteria, a few references to a sibling 'ideation' skill with no context, and the absence of a worked example.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no padding, no explaining things Claude already knows, and sections like 'Format arguments to actually have' deliver dense tradeoff rules in few tokens. It falls just short of level 5 because of meta-scaffolding like 'This is a grilling session inverted. In ideation, the question was...' and 'This is the gap-naming of [Pulling from the pile] one level up', which reference a sibling skill the reader has no context for — minor instances of over-explanation that could be trimmed.

4 / 5

Actionability

As an instruction-only skill, the guidance is concrete: a numbered six-step loop, exact questions to ask ("If I cut this, what breaks?"), explicit format rules (table when the same shape repeats 3+ times, callout syntax `> [!TIP]`), and a concrete gap-naming script. It is not level 5 because there is no worked example of a shaping exchange and a few directives stay abstract ("grow paragraph by paragraph" leaves the mining mechanics to inference).

4 / 5

Workflow Clarity

The loop is clearly sequenced with checkpoints: settle prerequisites first, force a choice among candidate openings, get per-block agreement, and the user decides when it's done. Error-recovery is present ('Re-read the file from disk before every write... Never overwrite blindly'). It stops short of level 5 because 'done' is left entirely undefined and there is no explicit recovery path when a chosen opening stops working beyond the conversational prompts.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the body needs none; it is organized into clearly headed sections with working internal anchors ([Grounding](#grounding), [Pulling from the pile](#pulling-from-the-pile)). At ~73 lines it exceeds the under-50-line simple-skill case that would justify a 5, and the unexplained 'In ideation' reference to a sibling skill is a minor organization gap, so level 4 fits better than 5.

4 / 5

Total

16

/

20

Passed

Description

50%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.

The description communicates a clear, concrete 'what' but omits any 'when' guidance, has a jargon term ('exploit') that no user would say, and leans on the broad word 'Writing' for distinctiveness. It sits at the midpoint of the scale: serviceable but under-specified for triggering.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user has a file of raw material (notes, fragments, a transcript) and wants it shaped into a finished article.'

Drop or gloss the internal term 'exploit' — it reads as jargon and is not a phrase a user would naturally say.

Add a few natural synonyms (draft, essay, blog post, turn notes into) to improve trigger-term coverage and distinctiveness from generic writing skills.

DimensionReasoningScore

Specificity

The description names the domain ("Writing") and one concrete action ("shape raw material into an article, paragraph by paragraph"), but "exploit" is internal jargon and no further capabilities are listed, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is above level 2 (the action is genuinely concrete, not generic like 'Processes PDF files') but below level 4, which expects several specific actions.

3 / 5

Completeness

The 'what' is clear (shape raw material into an article, paragraph by paragraph) but there is no 'Use when...' or equivalent trigger clause, so per the judging guideline completeness is capped at 3 ('Has a clear what but when is missing or only weakly implied'). It is not level 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

"writing", "article", "paragraph", and "raw material" are natural user terms, but common variations users would say are missing ("draft", "essay", "blog post", "notes", "turn notes into") and "exploit" is technical jargon no user would utter. This fits 'Some relevant keywords but missing common variations or synonyms' rather than level 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

"shape raw material into an article, paragraph by paragraph" carves out a niche, but the leading word "Writing" is broad and would overlap with general writing, drafting, and editing skills. 'Somewhat specific but could still overlap with similar skills' is the best fit; level 4 would require more distinct trigger phrasing.

3 / 5

Total

12

/

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

tonykay/transcriber

Path

.agents/skills/writing-shape/SKILL.md

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.