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.

68

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

The canonical home for this skill is deep-work in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 SKILL.md body is well-written: a tight four-step workflow with executable commands, explicit exit-code validation, and refusal-driven feedback loops. Its critical flaw is that the entire supporting bundle is missing — the three scripts the steps invoke, the three reference documents, and the two assets are all dead paths, so none of the promised material can actually be reached or run.

Suggestions

Ship the bundle: create scripts/shallow_work_auditor.py, scripts/time_block_planner.py, and scripts/focus_session_logger.py so the documented commands (and their exit-2 refusals) actually run, and verify each command example in the body against the shipped scripts.

Add the referenced detail files — references/deep_work_canon.md, references/time_blocking_method.md, references/shallow_work_budget.md, assets/example_time_block_plan.md, and assets/shutdown_checklist.md — or remove their links until they exist, since all eight referenced paths are currently dead.

Trim redundancy in the "Rules" section and "What this does": the 4-hour ceiling and two-batch rules are each stated four times; stating each once at its point of application would tighten the body without losing clarity.

DimensionReasoningScore

Conciseness

The body is lean: four short steps with executable commands, a scripts table, and one-line reference descriptions — no explanations of concepts Claude already knows. It falls short of 5 because of mild redundancy: the 4-hour cap and two-window batching rule each appear four times ("What this does", Step 2, the scripts table, and "Rules"), and the "Rules" section largely restates constraints already stated where they apply.

4 / 5

Actionability

The guidance itself is concrete and complete — copy-paste bash invocations with realistic argument values ("--task 'Write investor update:60' ... --budget 50"), documented exit codes ("OVER-BUDGET (exit 2)"), subcommands (log/status/streak), and stated refusal behaviors. It is not 5 because "fully executable, copy-paste ready" fails in practice: the three invoked scripts do not exist in the bundle, so every command errors on first run.

4 / 5

Workflow Clarity

The four steps (classify → block → log → shutdown) are clearly sequenced with explicit validation checkpoints and error-recovery feedback: "OVER-BUDGET (exit 2) means cut, batch, or delegate before any schedule is built" and the two planner refusals that "name what to defer" / "name what to drop — the day never silently extends". This matches the 5 anchor (explicit validation steps plus feedback loops for error recovery) and exceeds 4, whose defining gap ("minor validation gaps") is absent.

5 / 5

Progressive Disclosure

The in-body structure is well signaled — a references table, an assets list, and one-level-deep links like [references/deep_work_canon.md] with one-line descriptions — but the actual bundle is empty: no scripts/, references/, or assets/ directories exist, so all eight referenced paths are dead links. Scored against the actual bundle structure per the rubric guidelines, navigation to the detail material is impossible, fitting the 2 anchor (references effectively unusable); it is not 3 because the problem is not organization of the text but total absence of the referenced files.

2 / 5

Total

15

/

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.

A strong description: explicit "Use when..." triggers with slash-command variants, followed by a third-person capability list with concrete, quantified actions. The only weakness is mild overlap risk with generic calendar-blocking skills via the "time-block their calendar" trigger.

DimensionReasoningScore

Specificity

The description lists multiple specific 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", "logs focus sessions against a weekly target" — with quantitative constraints included. It matches the 5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, since the capability list covers the full workflow (classify, schedule, batch, log) with no gaps.

5 / 5

Completeness

Both questions are explicitly answered with concrete trigger phrases: "when" via "Use when someone wants to plan a deep work day, time-block their calendar or task list, ... or says '/deep-work' or '/time-block'" and "what" via the third-person capability list. This is the 5 anchor verbatim in structure; it is not 4 because the when-clause is fully explicit and enumerates specific triggers rather than a generic "Use when working with...".

5 / 5

Trigger Term Quality

Natural phrases a user would actually say are covered comprehensively with synonyms and variants: "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 the explicit "/deep-work" and "/time-block" invocations. Both noun and verb forms of the domain terms appear; no common variation is obviously missing, fitting the 5 anchor over 4.

5 / 5

Distinctiveness Conflict Risk

The niche (personal attention budgeting and deep-work scheduling) is clearly framed and most triggers ("shallow work", "focus hours", "shutdown ritual", "/deep-work") are distinct, but "time-block their calendar or task list" overlaps with generic calendar/scheduling skills a user might reach for instead. Fits the 4 anchor (mostly distinct, minor overlap risk with closely related skills); not 5 because one real collision surface exists, not 3 because the overall framing is unmistakably deep-work-specific.

4 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 18 missing

Warning

Total

13

/

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.