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

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

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.

A well-organized, actionable skill body that delegates detail to a bundled script and templates while keeping clear workflow sections and safety guards. Minor gaps are the placeholder in the command and the absence of an explicit post-create verification checkpoint.

Suggestions

Replace the <plugin-root> placeholder in the example command with a concrete resolution instruction (e.g., a one-liner showing how to derive it from SKILL.md's location) so the command is copy-paste ready.

Add an explicit validation step after creation (e.g., list the resulting structure and confirm VOICE.md/STYLE.md/examples/drafts exist) before the Handoff section.

Tighten the intro sentence and the "Keep The Split Clear" prose to trim the small amount of framing that does not directly drive action.

Dimension	Reasoning	Score
Conciseness	The body is efficient and well-structured with minimal framing (e.g., the single intro sentence), though lines like "Create one portable folder that can travel independently of the plugin..." could be trimmed slightly.	4 / 5
Actionability	Provides concrete, mostly executable commands ("python3 \"<plugin-root>/skills/cw-setup-project/scripts/create_project.py\" \"/path/to/writing-home\"" plus the --add-missing variant), but the <plugin-root> placeholder prevents pure copy-paste readiness.	4 / 5
Workflow Clarity	Clearly sequenced sections (resolve target, create, handle existing folder, keep split clear, migrate, begin guides, handoff) with checkpoints in the migration sub-flow and built-in script safety (refuses non-empty, never overwrites); the main create path lacks an explicit post-create verification step.	4 / 5
Progressive Disclosure	Well-organized into clear sections with one-level-deep references to the bundled scripts/create_project.py (verified present) and defaults/project-template/, keeping the body an overview rather than inlining template details.	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 the capability and multiple explicit trigger conditions. It is third-person, avoids fluff, and stakes out a distinct niche with minimal conflict risk.

Dimension	Reasoning	Score
Specificity	Names the domain and concrete actions ("Create or initialize a durable writing home with VOICE.md, STYLE.md, examples/, and drafts/") with specific artifacts, but does not enumerate every downstream action like onboarding handoff, so it sits just below comprehensive.	4 / 5
Completeness	Explicitly answers both what (create/init a writing home with the named files and folders) and when ("Use when Scribe identifies a first-time writer... or when the user explicitly asks to set up, scaffold, initialize, or migrate"), with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes several natural trigger phrases a user would say ("set up, scaffold, initialize, or migrate a self-contained writing folder"), giving good synonym coverage, though a few common variations like "writing project" are absent.	4 / 5
Distinctiveness Conflict Risk	Targets a clear Compound Writing niche via named surfaces (VOICE.md, STYLE.md, examples/, drafts/) and the Scribe persona, making overlap with unrelated skills minimal.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

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
Commit: 18702f0

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.