CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-fragments

Grilling session that mines the user for fragments — heterogeneous nuggets of writing (claims, vignettes, sharp sentences, half-thoughts) — and appends them to a single document as raw material for a future article. Use when the user wants to develop ideas before imposing structure, or mentions "fragments", "ideate", or "raw material" for writing.

75

Quality

92%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description that clearly communicates a distinctive, well-defined skill. It specifies concrete actions (mining fragments, appending to a document), provides rich examples of what constitutes a fragment, and includes an explicit 'Use when...' clause with natural trigger terms. The description is concise yet comprehensive, making it easy for Claude to select this skill appropriately from a large pool.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'mines the user for fragments', 'heterogeneous nuggets of writing (claims, vignettes, sharp sentences, half-thoughts)', and 'appends them to a single document as raw material'. The parenthetical examples add specificity about what kinds of fragments are collected.

3 / 3

Completeness

Clearly answers both what ('grilling session that mines the user for fragments and appends them to a single document') and when ('Use when the user wants to develop ideas before imposing structure, or mentions "fragments", "ideate", or "raw material" for writing'). The 'Use when...' clause is explicit.

3 / 3

Trigger Term Quality

Includes natural trigger terms users would say: 'fragments', 'ideate', 'raw material', 'writing', 'develop ideas', 'before imposing structure'. These cover both the specific vocabulary and the broader intent a user might express.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche: an interactive ideation/fragment-collection session for pre-structural writing. The specific workflow (grilling + appending fragments to a document) and trigger terms ('fragments', 'ideate', 'raw material') are unlikely to conflict with general writing, editing, or brainstorming skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a well-crafted skill that clearly defines a novel interaction pattern (fragment grilling) with concrete format examples and explicit behavioral rules. Its strongest aspects are the actionable file format specification, the re-read-before-write safety pattern, and the clear separation of core instructions from supporting detail. Minor verbosity in the fragment definition section is the only notable weakness.

DimensionReasoningScore

Conciseness

The skill is mostly efficient but includes some unnecessary elaboration. The 'What is a fragment' section with its long list of examples and the novelist's diary metaphor adds context that could be trimmed. However, the fragment concept is genuinely novel and needs definition, so the explanation is partially justified.

2 / 3

Actionability

The skill provides concrete, specific guidance: exact file format with a complete markdown example, explicit behavioral rules (re-read before writing, append-only, no headings, HR separators), and clear handling of edge cases (no path given, user edits between turns, cut/rewrite/merge commands). Claude knows exactly what to do.

3 / 3

Workflow Clarity

The workflow is clear and includes important validation-like checkpoints: always re-read before writing to preserve user edits, never overwrite, append only. The sequence (ask for path → capture from first message → H1 with working title → append fragments silently → handle edit requests) is unambiguous. The re-read-before-write pattern serves as a feedback loop protecting against data loss.

3 / 3

Progressive Disclosure

For a standalone skill with no bundle files, the content is well-organized into clear sections: a concise 'what-to-do' block with core instructions, then 'supporting-info' with fragment definition, file format example, and writing rhythm guidelines. The structure is logical and appropriately sized without needing external references.

3 / 3

Total

11

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
mattpocock/skills
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.