CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cw-setup-project

Create or initialize a durable writing home with VOICE.md, STYLE.md, examples/, and drafts/. Use when Scribe identifies a first-time writer with no established writing context after resolving the target, or when the user explicitly asks to set up, scaffold, initialize, or migrate a self-contained writing folder.

Quality

85%

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

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 skill body is well-structured, actionable, and concisely written with clear safety guards around destructive setup and migration operations. Minor improvements are possible around making commands fully copy-pasteable and ensuring external references resolve within the skill bundle.

Suggestions

Replace the '<plugin-root>' placeholder with a concrete resolution snippet or note so the bash commands are copy-paste ready.

Verify or inline the '../../references/context-contract.md' reference so it resolves within the skill bundle rather than relying on a plugin-level path.

Add an explicit validate-fix-retry checkpoint (e.g., re-run the creator and confirm created/preserved output) to lift workflow clarity to a full feedback loop.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence, with no padding explaining concepts Claude already knows ('The script copies the canonical templates... It refuses to modify a non-empty folder'); not a 5 because prescriptive rule lists like 'Never put argument...' could be tightened slightly.

4 / 5

Actionability

Provides an exact folder tree and executable bash commands with specific flags ('--add-missing', '--with-audience') plus the script's documented behavior; not a 5 because the '<plugin-root>' placeholder prevents literal copy-paste even though its resolution is explained.

4 / 5

Workflow Clarity

Clear sequenced flow (resolve target, create, optional audience, migrate, begin guides, handoff) with safety checkpoints ('refuses to modify a non-empty folder', 'inspect it first', 'Show the migration summary before changing', 'Preserve TASTE.md until the user explicitly approves'); not a 5 because there is no explicit validate-fix-retry error-recovery loop.

4 / 5

Progressive Disclosure

Well-organized sections with a one-level-deep reference to the bundled 'scripts/create_project.py' (present in the bundle) and a clearly signaled external pointer to '../../references/context-contract.md'; not a 5 because that referenced file is not within the skill's own bundle, a minor organization gap.

4 / 5

Total

16

/

20

Passed

Description

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

A strong, specific description that clearly states both capability and trigger conditions with natural user phrasing. It distinguishes itself well from neighboring skills through niche-specific triggers.

DimensionReasoningScore

Specificity

Names concrete artifacts ('VOICE.md, STYLE.md, examples/, and drafts/') and actions ('Create or initialize', 'migrate'), listing several specific actions with only minor coverage gaps; not a 5 because it does not enumerate a comprehensive set of distinct capabilities.

4 / 5

Completeness

Explicitly answers 'what' ('Create or initialize a durable writing home with VOICE.md, STYLE.md, examples/, and drafts/') and 'when' with concrete trigger phrases ('Use when Scribe identifies a first-time writer... or when the user explicitly asks to set up, scaffold, initialize, or migrate').

5 / 5

Trigger Term Quality

Includes several natural user phrases ('set up, scaffold, initialize, or migrate a self-contained writing folder') with good synonym coverage; not a 5 because the terms are domain-internal with no file-extension-style or common-variation synonyms.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (Compound Writing writing-home setup) with distinct, specific triggers ('Scribe identifies a first-time writer with no established writing context') and minimal overlap risk with other skills.

5 / 5

Total

18

/

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-setup-project/SKILL.md

Revision

8fd0ec8

Reviewed

Table of Contents

DiscoveryImplementationValidation

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.

Claim skill