CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

90%

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.

A tight, well-structured body that carries all stage rules, agent behaviors, and the template convention in minimal tokens. Its two gaps are executable specificity — template names left as placeholders and promote/publish mechanics left implicit — and the absence of an explicit review checkpoint before shipping.

Suggestions

List the available template names (e.g. idea, draft, published) in the Templates section instead of the bare `<name>` placeholder so template selection is fully executable.

Spell out the promote and publish mechanics — the exact write/move operation and which frontmatter fields to set or clear at each stage transition (idea → draft, draft → published).

Add a brief checklist for drafts in `status: review` (what to verify before shipping) to close the workflow's only checkpoint gap.

DimensionReasoningScore

Conciseness

At ~24 lines the body is pure rules: an ASCII flow diagram, per-folder rules with specific thresholds ("idle more than 30 days", "idle more than 14 days") and named frontmatter fields, and a one-line template convention. Nothing explains concepts Claude already knows and every token earns its place, matching the 'lean and efficient' anchor rather than 4, which would require some over-explanation to trim.

5 / 5

Actionability

Mostly executable guidance: concrete frontmatter fields (`status: drafting/review`, `published_at`, `canonical_url`, `channel`), a concrete path pattern (`drafts/<slug>/research/`), and a real call shape (`write({ document: { path, template: "<name>" } })`). It stops short of 5 because the template name is a placeholder with no enumerated template list, and the promote/publish mechanics (which write/move operation, which fields to set at each transition) are implied rather than given.

4 / 5

Workflow Clarity

The three-stage sequence is clearly laid out (ideas → "commit to writing it" → drafts → "ship" → published) with per-stage rules and an immutability guardrail ("Treat as immutable; to revise, copy to a new draft"). Not 5 because there are no explicit validation/review checkpoints — the `status: review` stage is named but what to check before shipping is never specified — though this is prose work rather than a destructive/batch operation, so the 3-cap for missing validation does not apply.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files and no need for external references, and the simple-skill exception applies: the sections (flow diagram, per-folder rules, Templates) are well-organized and the one external pointer (the platform `/open-knowledge` skill) is clearly signaled and one level deep. No content that belongs in a separate file is inlined, so neither the 4 nor the 3 anchor fits better.

5 / 5

Total

18

/

20

Passed

Description

92%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 description: it names a concrete three-stage lifecycle, enumerates the specific actions (capture, start/revise, review, publish), provides an explicit 'Read when' trigger clause with natural phrases, and explicitly delimits its relationship to the platform skill. The only minor gap is synonym coverage for writing-form terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full lifecycle — "capture an idea, start or revise a draft, review a piece before it ships, or publish it" — plus a concrete what ("a three-stage drafting flow, ideas → drafts → published"), giving comprehensive coverage for the domain. It does not fall to 4 because no meaningful capability of the pack is left unmentioned, and the voice is third person throughout.

5 / 5

Completeness

Both halves are explicit: the what ("a three-stage drafting flow, ideas → drafts → published") and a concrete when-clause ("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"). This matches the top anchor with concrete trigger phrases, so it cannot be 4 where 'when' would be less explicit.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — "capture an idea", "start or revise a draft", "review a piece", "publish it" — giving good keyword coverage. Not 5 because common synonyms and form-specific terms (e.g. "edit", "essay", "article", "post", "newsletter") are missing, though it stays above 3 since the core trigger vocabulary is well covered.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (Writing Pipeline project folders) and explicitly manages the nearest-neighbor conflict: "Complements the platform `open-knowledge` skill; does not replace it." Triggers are conditioned on the project's folders and writing-lifecycle requests, so overlap risk is minimal; score 4 would require some unresolved overlap with a closely related skill, which is not the case.

5 / 5

Total

19

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

inkeep/open-knowledge

Path

packages/server/assets/skills/packs/writing-pipeline/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.