CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-work

Coordinate substantial work with multiple outcomes, dependencies, handoffs, or durable checkpoints. Use when decomposing work, resuming a tracked effort, or revising a plan after evidence changes its premises. Reuse the active environment's work record and authorization.

Quality

72%

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 ./.agents/references/agent/ref.09YqDHhB/SKILL.md
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.

A tightly written process skill with excellent workflow structure: staged sequence, explicit readiness gates, failure-driven feedback loops, and clean one-level-deep reference files. The main gaps are abstract, template-less guidance in the body (specifics all live one hop away) and a References section whose cross-skill links are dead in this environment.

Suggestions

Inline a compact fill-in template or one mini contract example in stage 2 so the four-field contract is immediately usable without opening references/task-contracts.md.

Fix or remove the four cross-skill references (../behavioural-specs, ../task-breakdown, ../writing-plans, ../using-beads) that do not resolve, or note explicitly that they apply only when those sibling skills are installed.

State the compact-path rule once (it currently appears in Role, stage 2, and Output) and drop the duplicated link list in the References section in favor of the inline, context-anchored pointers.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence — no concept explanations, no padding — and defers all detail to reference files. It falls short of anchor 5 because the "quick answer stays compact / need not load this specialist" message is repeated in three places (Role, stage 2, Output) and several doubly-qualified sentences could be trimmed without loss.

4 / 5

Actionability

Concrete elements exist — the four contract fields (Outcome, Scope and constraints, Verification, Completion condition), the depth-selection table, and the five-bullet checkpoint/handoff list — but most execution guidance is abstract direction ("Choose evidence that observes the claimed outcome", "Update the authoritative record") with the working specifics a reference-hop away. This matches anchor 3 (some concrete guidance but incomplete, key details missing) rather than anchor 4's mostly-executable guidance.

3 / 5

Workflow Clarity

Five clearly sequenced stages, each closed by an explicit "**Ready when:**" validation checkpoint, plus a genuine error-recovery feedback loop ("When a check fails, use its evidence to diagnose and correct the unit; when attempts repeat the same failure, revisit the premise"), pause conditions for missing authorization, and a resume/reconcile stage with a final output checklist. This matches anchor 5 (explicit validation steps, feedback loops, checklists) and exceeds anchor 4, whose checkpoints are only "mostly present".

5 / 5

Progressive Disclosure

Scored against the actual bundle: SKILL.md is a ~110-line overview and all four in-scope references (task-contracts, decomposition, verification, worked-examples) exist, are one level deep, and are each signalled inline with an explicit "read when" condition plus a purpose line in the References section. It misses anchor 5 because the References section duplicates the inline links and four of its eight entries point outside the bundle (../behavioural-specs, ../task-breakdown, ../writing-plans, ../using-beads) and do not resolve in this environment — half the reference list is unresolvable.

4 / 5

Total

16

/

20

Passed

Description

58%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 well-formed: third person, no fluff, explicit "Use when" clause, and a recognizable coordination niche. Its weakness is abstraction — the stated capabilities and triggers are process language rather than the concrete actions and natural synonyms that would sharpen both specificity and trigger quality.

Suggestions

Replace abstract capability nouns with concrete observable actions (e.g., "Break work into verifiable units, record checkpoints, map prerequisites and handoffs, resume work from a saved record") so the what reads like specific operations.

Add the natural synonyms users actually say — "break down", "project plan", "milestones", "pick up where we left off", "change of plan" — alongside "decomposing" and "resuming a tracked effort".

Sharpen the boundary against adjacent planning/task-management skills (e.g., "Use when work has multiple owners or durable checkpoints, not for single-task planning") to reduce overlap risk.

DimensionReasoningScore

Specificity

The description names the coordination/planning domain and actions like "decomposing work, resuming a tracked effort, or revising a plan" and "Reuse the active environment's work record and authorization", but these are process abstractions rather than concrete capabilities with observable outputs. It goes beyond anchor 2 (domain plus generic action) yet falls short of anchor 4's "several specific actions".

3 / 5

Completeness

Both halves are explicit: what ("Coordinate substantial work with multiple outcomes, dependencies, handoffs, or durable checkpoints... Reuse the active environment's work record") and when ("Use when decomposing work, resuming a tracked effort, or revising a plan after evidence changes its premises"). It sits between anchors 4 and 5: the when clause has concrete trigger phrases, but the what relies on abstract terms like "substantial work" and "durable checkpoints" rather than concrete capabilities, so it does not clearly reach anchor 5.

4 / 5

Trigger Term Quality

Trigger phrases "decomposing work", "resuming a tracked effort", and "revising a plan" capture some relevant keywords, but "decomposing" is planning jargon and common natural phrasings like "break down", "project plan", "milestones", or "pick up where we left off" are absent. This matches anchor 3 (some relevant keywords, missing common variations) rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

The multi-outcome/dependency/handoff framing carves out a niche, but "decomposing work" and "revising a plan" are shared territory with closely related planning and task-breakdown skills, and nothing here fences those boundaries. Anchor 3 (somewhat specific, could still overlap with similar skills) fits better than anchor 4's "minor overlap risk with closely related skills".

3 / 5

Total

13

/

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

relative_links

Relative link issues: 4 suspicious

Warning

Total

15

/

16

Passed

Repository

slurpyb/pi-taskfile

Path

.agents/references/agent/ref.09YqDHhB/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.