CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cw-transition

Generate 3 context-aware transition options between sections. Invoke with /cw-transition or /cw-transition [from section X to section Y].

Quality

74%

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 ./skills/cw-transition/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 generation workflow and explicit output format. Its main weaknesses are minor repetition and a placeholder Lessons section, plus example transitions that remain unfilled templates.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence, with terse tables and principles and no padding about what transitions are; minor repetition between the Principles and Context-Aware Weighting table and the empty Lessons placeholder keep it just below a 5.

4 / 5

Actionability

Provides a concrete 5-step generation sequence, an explicit labeled output template, and a piece-type-to-pattern weighting table — guidance Claude can execute directly; the only gap is that the transition examples in the output template are placeholders rather than worked examples.

4 / 5

Workflow Clarity

As a simple single-purpose generation skill with an unambiguous, clearly sequenced 1-5 process and an explicit output format, it meets the simple-skill bar for a top score; no destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

Tightly organized with clear section headers and no nested references, and needs no external bundle files; the body slightly exceeds the 50-line simple-skill threshold and the empty Lessons placeholder keep it at 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

53%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 clearly states what the skill does but omits an explicit 'Use when...' trigger clause, capping completeness and trigger-term quality at the midpoint. It is distinctive but would benefit from natural-language trigger keywords users actually say.

Suggestions

Add a 'Use when...' clause naming natural trigger phrases (e.g., 'Use when bridging sections, smoothing flow between paragraphs, or connecting ideas across parts of a piece').

Include common synonyms users say ('bridge', 'flow', 'connect') alongside 'transition' to improve trigger-term coverage.

Optionally enumerate the concrete actions (analyze piece type, weight patterns, generate labeled options) to lift specificity above a single named action.

DimensionReasoningScore

Specificity

Names the domain (transitions between sections) and one concrete action (generate 3 context-aware options), but does not enumerate several specific actions, so it sits at the 1-2 concrete actions anchor rather than the comprehensive 4-5 band.

3 / 5

Completeness

Has a clear 'what' (generate 3 transition options) but only an invocation instruction, no 'Use when...' clause; per the rubric a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Contains relevant keywords ('transition', 'between sections') but relies on the slash-command invocation form rather than the natural phrases users say ('bridge', 'flow', 'connect paragraphs'), missing common synonyms.

3 / 5

Distinctiveness Conflict Risk

The transition-between-sections niche and unique command name make it mostly distinct from other skills, with only minor overlap risk against general writing/editing skills; not a clean 5 because it lacks explicit distinguishing trigger phrases.

4 / 5

Total

13

/

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

EveryInc/compound-writing

Path

skills/cw-transition/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.