CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-fragments

Writing, explore——挖掘原始 fragments,暂不施加任何结构。

53

Quality

58%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/in-progress/writing-fragments/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, actionable instruction skill with a clear workflow and concrete file-format guidance; its main weakness is moderate conciseness, with a few conceptual passages that could be tightened. No bundle files are present, so progressive disclosure rests on internal organization, which is solid.

Suggestions

Tighten the 'What is a fragment' and leading-word passages: trim the novelist's-diary metaphor and condense the leading-word elaboration to its load-bearing point, since the bullets already convey the idea.

Add a brief concrete example of the grilling-session questioning rhythm so the core action is fully executable rather than implied.

Consider moving the eight-fragment-type bullet list into a reference file if the skill grows, keeping SKILL.md as a lean overview pointing to it.

DimensionReasoningScore

Conciseness

The body is mostly efficient and defines skill-specific terms (fragment, leading word) that Claude does not already know, but the novelist's-diary metaphor and the extended leading-word elaboration are conceptual flourish that could be trimmed. It fits anchor 3 ("Mostly efficient but includes some unnecessary explanation or could be tightened") rather than 4, which requires only minor instances of over-explanation.

3 / 5

Actionability

Guidance is concrete and specific for an instruction-only skill: append to a single markdown file, separate fragments with "\n---\n", place a single H1 working title on first write, re-read before each write, append-only, and treat cut/rewrite/merge as first-class commands. It is anchor 4 ("Mostly executable guidance... with minor gaps") rather than 5 because the grilling-session questioning approach itself is underspecified.

4 / 5

Workflow Clarity

A clear sequence is given (ask once for path → capture from first sentence → first write adds H1 → append with separators → re-read before each write → never overwrite), and re-read-before-write plus never-overwrite act as checkpoints preserving user edits. It is anchor 4 rather than 5 because there is no explicit error-recovery feedback loop, though the destructive/batch validation cap does not apply to this conversational skill.

4 / 5

Progressive Disclosure

The skill is a single self-contained SKILL.md (no references/, scripts/, or assets/ bundle files exist) organized into clear <what-to-do> and <supporting-info> sections with sub-headings, and there are no nested references. It is anchor 4 ("Good structure; most content appropriately placed; minor organization gaps") rather than 5 because the conceptual sub-sections (leading word, novelist's diary) lean toward material that a stricter split could externalize.

4 / 5

Total

15

/

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 is middling across all dimensions: it names a concrete action and a niche but lacks any "when to use" guidance, comprehensive trigger synonyms, or a multi-action capability list. It communicates intent adequately but would not reliably surface for the right user request.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user wants to explore writing ideas, brainstorm fragments, or gather raw material before structuring an article.'

Expand trigger terms with natural synonyms users actually say — brainstorm, freewrite, writing 素材, draft ideas, leading words — not just 'Writing, explore, fragments'.

List 2-3 concrete actions (run a grilling interview, append fragments to a single markdown file, surface leading words) instead of the single 'excavate fragments' action.

DimensionReasoningScore

Specificity

The phrase "挖掘原始 fragments" names the writing domain and one concrete action (excavate raw fragments), with "暂不施加任何结构" as a behavioral constraint, but it does not list multiple concrete actions. It sits at anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") rather than 2 because the excavate-fragments action is more concrete than the generic "Processes PDF files" example.

3 / 5

Completeness

It conveys a clear "what" (excavate raw fragments without imposing structure) but provides no "Use when..." clause or explicit trigger guidance, so per the rubric guideline completeness is capped at 3. It is not 4 because "when" is entirely absent rather than merely weak.

3 / 5

Trigger Term Quality

"Writing", "explore", and "fragments" are relevant keywords a user might say, but common variations and synonyms (brainstorm, freewrite, 素材, draft ideas) are missing. This matches anchor 3 ("Some relevant keywords but missing common variations or synonyms") rather than 4, which would require fuller natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The explore/don't-structure framing carves out a niche distinct from structuring writing skills, but the leading term "Writing" is broad and could overlap with general brainstorming or ideation skills. It fits anchor 3 ("Somewhat specific but could still overlap with similar skills") rather than 4, which would require mostly-distinct triggers.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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