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

83%

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 planning-work in slurpyb/pi-taskfile

SKILL.md
Quality
Evals
Security

Quality

Content

88%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, well-sequenced orchestration skill: lean prose with explicit per-stage validation gates, an error-recovery loop, and clean one-level-deep bundling of the four local reference files. The main gaps are directional rather than demonstrated guidance (no inline example artifact) and sibling-skill links that do not resolve in this bundle.

Suggestions

Fix or qualify the four sibling-skill references (../behavioural-specs, ../task-breakdown, ../writing-plans, ../using-beads) — they do not resolve in this bundle, so mark them as cross-skill pointers available only when the full skill family is installed.

Include one compact filled example of a contract or checkpoint inline (a two-line illustration of the four fields) so the abstract directive "use explicit fields when they make a handoff clearer" has a concrete target without requiring a trip to worked-examples.md.

DimensionReasoningScore

Conciseness

The body is dense prescriptive instruction with zero concept explanations — no "what is planning" padding, no restating what Claude already knows; every sentence issues a directive ("Execute one bounded unit per owner at a time, check its result, and record the observed evidence before dependent work"). Matches the 'lean and efficient; assumes Claude's competence; every token earns its place' anchor; even level 4 would require over-explanation to trim, and none is evident.

5 / 5

Actionability

Concrete scaffolds are provided: the four named contract fields ("Outcome", "Scope and constraints", "Verification", "Completion condition"), a three-row depth selection table with explicit criteria, per-step "Ready when" gates, and a five-item output checklist — comparable to 'mostly executable guidance with minor gaps' for an instruction-only skill. Not 5 because no filled example or template artifact appears in the body itself (demonstrations are delegated to worked-examples.md), and some directives stay directional ("Choose evidence that observes the claimed outcome") without showing what that choice looks like.

4 / 5

Workflow Clarity

Five clearly sequenced stages, each closed by an explicit "Ready when:" validation checkpoint, plus a feedback loop — "When a check fails, use its evidence to diagnose and correct the unit; when attempts repeat the same failure, revisit the premise" — and pause conditions ("Pause the affected work when progress requires a new decision, capability, or authorization"). This matches the level-5 anchor (clear sequence, explicit validation steps, error-recovery loops, checklists); the skill involves no destructive or batch operation, so no cap applies.

5 / 5

Progressive Disclosure

Good structure against the actual bundle: all four referenced files (references/task-contracts.md, decomposition.md, verification.md, worked-examples.md) exist and are substantive, references are one level deep, appear inline at the decision point with a when-to-read condition, and are re-listed with purpose annotations under References. Not 5 because four of the eight referenced paths — ../behavioural-specs/SKILL.md, ../task-breakdown/SKILL.md, ../writing-plans/SKILL.md, ../using-beads/SKILL.md — do not resolve in this bundle, leaving navigation broken for half the reference list.

4 / 5

Total

18

/

20

Passed

Description

72%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 well-formed description with an explicit what-plus-when structure and three concrete trigger scenarios, written in consistent third-person imperative voice with no fluff. Its main weaknesses are trigger vocabulary that is more formal than natural user phrasing and overlap risk with adjacent planning skills it does not differentiate from.

Suggestions

Add natural trigger synonyms users would actually say, e.g. "Use when breaking down a large effort, planning a multi-step project, resuming unfinished work, or updating a plan after new evidence" — replacing jargon like "durable checkpoints" and "work record" in the trigger clause.

Differentiate from adjacent skills by stating the boundary, e.g. "Use for coordinating the overall effort; use task-breakdown or writing-plans when only the handoff artifact is needed" — currently the what-clause ("Coordinate substantial work with... dependencies, handoffs") could match a generic project-planning skill.

Make the what-clause more concrete by naming the deliverable (e.g. "produce scoped work units with contracts, verification evidence, and checkpoints") rather than the abstract "Coordinate substantial work".

DimensionReasoningScore

Specificity

Quotes several distinct capabilities — "Coordinate substantial work with multiple outcomes, dependencies, handoffs, or durable checkpoints", "decomposing work, resuming a tracked effort, or revising a plan", "Reuse the active environment's work record and authorization" — matching the 'lists several specific actions; minor gaps' anchor. Not 5 because terms like "substantial work" and "durable checkpoints" stay abstract without covering the planning domain comprehensively; not 3 because well over 1–2 concrete actions are named.

4 / 5

Completeness

Explicitly answers both questions: what — "Coordinate substantial work with multiple outcomes, dependencies, handoffs, or durable checkpoints... Reuse the active environment's work record and authorization"; when — "Use when decomposing work, resuming a tracked effort, or revising a plan after evidence changes its premises". This matches the level-5 anchor (both clearly present with concrete trigger phrases) rather than level 4, since the when-clause names three specific trigger scenarios rather than a vague condition.

5 / 5

Trigger Term Quality

Relevant keywords present — "decomposing work", "resuming a tracked effort", "revising a plan", "dependencies, handoffs" — but common user phrasings are missing ("break down", "plan this project", "pick up where we left off", "task tracking"), and phrases like "durable checkpoints" and "work record" are jargon users would not naturally say. Fits the 'some relevant keywords but missing common variations or synonyms' anchor better than the level-4 anchor's good natural coverage.

3 / 5

Distinctiveness Conflict Risk

The resumption and "evidence changes its premises" triggers are distinctive, but "Coordinate substantial work with multiple outcomes, dependencies, handoffs" overlaps heavily with generic project-planning and task-breakdown skills — the body itself lists four sibling planning skills whose domains border this one, and the description does not delineate boundaries from them. Fits 'somewhat specific but could still overlap with similar skills'; not 4 because the overlap is with multiple closely related skills rather than a minor one.

3 / 5

Total

15

/

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.kdOx6BQi/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.