CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-for-routine

Use when writing the unattended night prompt for a routine after grilling-for-routine, when freezing a deterministic step into a Fixed-step Skill, or when the night prompt needs steps and a done-when.

59

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/writing-for-routine/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 tightly written craft guide with an exemplary steps-plus-done-when workflow and checkable validation, and it correctly contains no code padding. Its weaknesses are a redundant MUST list that duplicates earlier sections and inlined per-run detail that belongs in reference files per the skill's own disclosure rule.

Suggestions

Cut the trailing MUST/MUST NOT block or the duplicated rules in Shape/Fixed-step Skill so each rule has one home, per the skill's own 'one home' principle.

Move the Run handoff section and the handoff.md format block into a reference file (e.g. references/handoff.md) and link to it, keeping SKILL.md to the core craft and steps.

Define or link what 'the gate' is in Step 1, since the gate's content lives in grilling-for-routine and is not restated here.

DimensionReasoningScore

Conciseness

The prose is terse and imperative throughout ("Write numbered steps. Each step has a done-when."), but the closing MUST/MUST NOT block (lines 88-100) repeats rules already stated in Shape and Fixed-step Skill ("Do not use em dashes" vs "MUST NOT use em dashes", "No second-person identity" vs "MUST NOT assign a second-person identity"), which violates the skill's own 'Keep each rule in one home' principle. This is 'mostly efficient but could be tightened', not 4, because the duplication is a noticeable block (~13 of 101 lines) rather than a minor trim.

3 / 5

Actionability

The body gives concrete paths (~/.dora/harness/<slug>/handoff.md, .env), a literal handoff.md format block, and numbered steps with checkable done-whens; as an instruction-only skill the guidance is executable. It stops short of 5 because some instructions assume external context from grilling-for-routine ('Read the grill answers. Use the gate.' never defines the gate here) and the example prompt block covers only the poll/skip/apply shape.

4 / 5

Workflow Clarity

The Steps section is a clear 5-step sequence where every step carries an explicit, checkable done-when, step 4 is a dedicated validation pass ("no second-person identity, no em dashes, every step has a done-when"), and step 5 defines the handoff back to grilling-for-routine. This matches 'clear sequence with explicit validation steps; checklists for complex processes'.

5 / 5

Progressive Disclosure

Sections are well-labeled and the skill is ~100 lines with no bundle files, but detail that its own rule says belongs 'in a later file' (the Run handoff mechanics, the handoff.md format block, the dora session/wire tooling notes in the opening) is inlined in SKILL.md. This fits 'some structure but content that should be separate is inline', not 4, since no references exist at all to offload that detail.

3 / 5

Total

15

/

20

Passed

Description

66%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 highly trigger-focused with three explicit 'Use when' clauses and a distinct niche, but it front-loads internal jargon and only weakly states what the skill actually produces. Stating the outputs (prompt.md, the Fixed-step Skill, steps with done-whens) up front would raise both specificity and completeness.

Suggestions

Lead with a capability statement before the Use-when clause, e.g. 'Write prompt.md and Fixed-step Skills as numbered steps with checkable done-whens. Use when...' so the 'what' is explicit rather than embedded in trigger clauses.

Add plain-language synonyms alongside the internal jargon (e.g. 'night prompt (unattended overnight run)') so trigger terms match what a user would naturally say.

Mention the concrete deliverables (handoff.md run-state file, skip-step rules) to broaden the action coverage beyond the two currently named.

DimensionReasoningScore

Specificity

The description names 1-2 concrete actions ("writing the unattended night prompt", "freezing a deterministic step into a Fixed-step Skill") but does not comprehensively cover what the skill produces (no mention of handoff.md, skip steps, or the Fixed-step Skill's helper-file rules). It sits at the 'names domain and 1-2 concrete actions' anchor, below 4 because coverage of capabilities is thin and above 2 because the actions named are genuinely concrete.

3 / 5

Completeness

The 'when' is explicit and strong (three distinct "Use when..." clauses), and a 'what' is present but only embedded inside the trigger clauses rather than stated as a capability summary. This fits anchor 4 ('both what and when; when could be more explicit' — here inverted: the what could be more explicit), not 5 because the what-side is partial, and not 3 because the what is more than weakly implied.

4 / 5

Trigger Term Quality

Keywords like "night prompt", "routine", "Fixed-step Skill", and "done-when" are relevant within this workflow, but they are internal jargon with no common variations or synonyms offered (e.g., no mention of 'unattended run', 'overnight pass', or 'prompt.md'). This matches 'some relevant keywords but missing common variations', not 4 ('good coverage, a few natural terms missing') because a user outside this ecosystem would not naturally say most of these phrases.

3 / 5

Distinctiveness Conflict Risk

The description carves a clear niche anchored to its companion skill ("after grilling-for-routine", "Fixed-step Skill", "done-when") that no generic writing skill would match. It fits 'clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

15

/

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

saif-shines/doraval

Path

skills/writing-for-routine/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.