CtrlK
BlogDocsLog inGet started
Tessl Logo

deep-work

Use when someone wants to plan a deep work day, time-block their calendar or task list, budget or cut shallow work, protect focus hours, track deep-work sessions and streaks, run an end-of-day shutdown ritual, or says "/deep-work" or "/time-block". Classifies tasks deep vs shallow, builds an energy-first time-blocked schedule that refuses deep demand past the 4-hour ceiling, batches shallow work into at most two windows, and logs focus sessions against a weekly target.

75

Quality

94%

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

92%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-structured method skill: executable commands with documented refusal exit codes, a gated four-step workflow, and verified one-level-deep bundle organization. Its only weakness is light philosophical restatement (Newport doctrine the model already knows) in the intro and Rules sections that could be trimmed for token efficiency.

Suggestions

Trim the 'What this does' opening paragraph and the Rules section to operational statements only — e.g., replace 'More than 4 deep hours is fake depth' with 'Refuse schedules exceeding 4 deep hours; defer the excess' — since the rationale already lives in references/deep_work_canon.md.

DimensionReasoningScore

Conciseness

The body is lean and command-driven, but the 'What this does' intro ('A calendar full of reactions is not a plan') and the Rules section editorialize Newport philosophy Claude already knows ('More than 4 deep hours is fake depth', 'open loops steal tomorrow's first block') rather than instructing. This is 'efficient with minor instances of over-explanation that could be trimmed' (4), not 5, since a few sentences are motivational restatement rather than operational content.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with real flags and example values for all three scripts (e.g., 'python scripts/time_block_planner.py --start 08:30 --end 17:00 --lunch 12:30 --task "Write product spec:120:deep"'), documented exit codes, and a script role table. Matches the score-5 anchor: specific examples cover the common cases.

5 / 5

Workflow Clarity

Steps 1–4 are clearly sequenced (classify → budget gate → block → log → shutdown) with explicit validation checkpoints and feedback loops: 'OVER-BUDGET (exit 2) means cut, batch, or delegate before any schedule is built' and 'Two refusals, both exit 2 ... the planner names what to defer / what to drop — the day never silently extends'. This matches the score-5 anchor with explicit validation and error-recovery guidance.

5 / 5

Progressive Disclosure

The SKILL.md is a clear overview with a script table, and well-signaled one-level-deep references and assets ('references/deep_work_canon.md', 'references/time_blocking_method.md', 'references/shallow_work_budget.md', 'assets/example_time_block_plan.md', 'assets/shutdown_checklist.md' — all verified to exist with no nested references inside them), each with a one-line role description. Matches the score-5 anchor: appropriate split, easy navigation.

5 / 5

Total

19

/

20

Passed

Description

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

An exemplary description: explicit 'Use when' triggers with natural synonyms and slash commands, a concrete what-clause in third person, and quantified constraints (4-hour ceiling, two shallow windows, weekly target). The only weakness is minor: overlap risk with generic day-planning/calendar skills is not disambiguated within the description itself.

Suggestions

Add a brief boundary clause to the description (e.g., 'Picks WHEN and HOW to work, not WHAT to do — run task-selection skills first') to disambiguate from general planning/productivity skills within the description itself.

Include one or two more everyday trigger phrasings users might use (e.g., 'plan my day around focus' or 'schedule my tasks') to further widen natural keyword coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Classifies tasks deep vs shallow, builds an energy-first time-blocked schedule that refuses deep demand past the 4-hour ceiling, batches shallow work into at most two windows, and logs focus sessions against a weekly target' — with specific parameters (90-minute blocks implied via body, 4-hour ceiling, two windows, weekly target). It is comprehensive and matches the score-5 anchor; not 4 because there are no coverage gaps.

5 / 5

Completeness

It explicitly answers 'when' ('Use when someone wants to plan a deep work day... or says "/deep-work" or "/time-block"') with concrete trigger phrases, and 'what' (classifies, builds a schedule with hard constraints, batches, logs sessions). Both are explicit and concrete, matching the score-5 anchor; third-person voice is used throughout ('Classifies', 'builds', 'batches', 'logs').

5 / 5

Trigger Term Quality

Natural phrases users would say are comprehensively covered: 'plan a deep work day', 'time-block their calendar or task list', 'budget or cut shallow work', 'protect focus hours', 'track deep-work sessions and streaks', 'run an end-of-day shutdown ritual', plus explicit slash commands '/deep-work' and '/time-block'. This matches the score-5 anchor including synonyms and command variants.

5 / 5

Distinctiveness Conflict Risk

The deep-work/time-blocking niche is mostly distinct with specific triggers, but generic requests like 'plan my day' or 'organize my calendar' could overlap with general productivity or calendar skills, and the disambiguation from siblings (andreessen 3x5 card, project-management) lives in the body's 'Distinct From' section rather than the description. Matches 'mostly distinct; minor overlap risk' (4) rather than 5, which would require the description itself to carry the distinct triggers and boundaries.

4 / 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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
alirezarezvani/claude-skills
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.