CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-workflow

How to work in a Writing Pipeline project (the `writing-pipeline` starter pack): a three-stage drafting flow, ideas → drafts → published. Read when the project has these folders, OR when asked to capture an idea, start or revise a draft, review a piece before it ships, or publish it. Carries the stage flow and review behaviors so that guidance does not live inside template bodies or folder descriptions. Complements the platform `open-knowledge` skill; does not replace it.

70

Quality

86%

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

86%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 an efficient, well-structured overview that gives concrete per-folder agent behaviors and a clear stage flow. It could nudge actionability and workflow clarity higher by enumerating concrete publication targets and adding an explicit review/validate gate before publish.

Suggestions

Enumerate concrete publication targets (e.g. Substack, Ghost, Mirror) tied to `target_form` so the "suggest publication targets" behavior is directly actionable.

Add an explicit review/verification checkpoint between drafts and published (e.g. confirm `status: review` passed and canonical URL resolved before marking immutable) to strengthen the workflow's validation gate.

DimensionReasoningScore

Conciseness

The ~24-line body is lean and assumes Claude's competence: the ASCII stage diagram and terse per-folder rules carry maximum information per token with no padding or over-explanation of known concepts.

5 / 5

Actionability

Concrete guidance is present (a real `write({ document: { path, template } })` call, specific 30/14-day thresholds, concrete paths like `drafts/<slug>/research/`), but some behaviors stay abstract ("suggest publication targets based on `target_form`") with no enumerated targets.

4 / 5

Workflow Clarity

The ideas → drafts → published flow is clearly sequenced with a `status: drafting/review` gate as a checkpoint, but there is no explicit validate→fix→retry feedback loop, leaving a minor validation gap.

4 / 5

Progressive Disclosure

Under 50 lines with no external references needed and well-organized sections (overview diagram, per-folder rules, templates), satisfying the simple-skill exception for a top progressive-disclosure score.

5 / 5

Total

18

/

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.

The description is strong: it concisely states what the skill does, gives explicit use-when triggers, and draws a clear boundary against the related open-knowledge skill. Its only weakness is slightly abstract workflow-stage actions and a few missing natural synonyms.

DimensionReasoningScore

Specificity

Names the domain ("three-stage drafting flow, ideas → drafts → published") and several concrete actions ("capture an idea, start or revise a draft, review a piece before it ships, or publish it"), but stops short of fine-grained operational actions, so it sits just below the comprehensive 5 anchor.

4 / 5

Completeness

Explicitly answers both what ("a three-stage drafting flow, ideas → drafts → published") and when ("Read when the project has these folders, OR when asked to capture an idea, start or revise a draft, review a piece before it ships, or publish it") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural user-facing phrases like "capture an idea", "start or revise a draft", "review a piece", and "publish it" are present, but common synonyms (essay, newsletter, blog post) and form-specific terms are omitted, leaving a few natural terms missing.

4 / 5

Distinctiveness Conflict Risk

A clear niche tied to the writing-pipeline pack with distinct folder-based triggers, plus an explicit boundary ("Complements the platform `open-knowledge` skill; does not replace it") that minimizes conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
inkeep/open-knowledge
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.