CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pickup

This skill should be used when preparing a pickup checklist when starting a task, rehydrating context from the latest handoff note if available.

63

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/00-utilities/pickup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 lean, well-structured instruction skill: concrete commands, explicit fallback logic, and clear output expectations with no token waste. The only real gap is minor — a few steps (PR number derivation, tmux attach criteria) rely on judgment rather than executable commands, and there are no explicit verification checkpoints.

DimensionReasoningScore

Conciseness

The ~30-line body is lean and assumes competence: no background concepts are explained, and every line is instruction, command, or decision logic ('run `pnpm run docs:list` if present', 'trust the repo state and call out the mismatch'). This matches anchor 5 ('Lean and efficient; every token earns its place'); anchor 4 would require minor over-explanation to trim, which is absent.

5 / 5

Actionability

Mostly executable, copy-paste-ready commands are given (`git status -sb`, `gh pr view <num> --comments --files`, `tmux capture-pane -p -J -t codex-shell:0.0 -S -200`), with specific handoff-note glob paths. Minor gaps keep it at anchor 4: `gh pr view <num>` needs a number and the fallback 'derive PR from branch' gives no command, and 'attach if needed' states no criterion. Not anchor 5 because guidance is not fully copy-paste ready across the common cases.

4 / 5

Workflow Clarity

A clear numbered sequence (1-6) is preceded by a prioritized handoff-note step with explicit fallback paths ('If no handoff note exists, continue with the standard pickup steps'), and the Notes section adds an error-recovery rule for contradictions. This matches anchor 4 ('Clear sequence with most checkpoints present; minor validation gaps'); it is not 5 because there are no explicit validation/verification checkpoints after actions (e.g. what to do if the tmux attach fails or the PR number cannot be derived). No destructive or batch operations are involved, so the workflow cap of 3 does not apply.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the skill is under 50 lines with well-organized sections (handoff-first, numbered steps, Output format, Notes) that need no external references. Per the rubric's simple-skill note, this earns anchor 5 ('well-organized sections' for a short skill with no need for external references).

5 / 5

Total

18

/

20

Passed

Description

62%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 concise, uses an explicit 'should be used when...' trigger, and names its niche distinctly. Its weaknesses are limited concrete actions in the 'what' and a thin set of natural trigger synonyms, leaving it solid but not exemplary.

Suggestions

Enumerate what the pickup checklist actually covers (e.g. 'checks repo state, CI/PR status, live tmux sessions, and plans the next 2-3 actions') to raise specificity from 1-2 actions to several.

Add natural user phrasings and synonyms to the trigger, such as 'use when resuming work, picking up where you left off, or when a handoff note exists'.

Make the 'when' more concrete (e.g. 'when starting a new session/thread or resuming a previous task') instead of the generic 'when starting a task'.

DimensionReasoningScore

Specificity

The description names its domain ('pickup checklist', 'handoff note') and 1-2 concrete actions — 'preparing a pickup checklist' and 'rehydrating context from the latest handoff note' — but coverage is not comprehensive; the actual checklist steps (repo state, CI, tmux, planning) are absent. This matches anchor 3 ('Names domain and 1-2 concrete actions, but not comprehensive') and not anchor 4, which requires several specific actions, nor anchor 2, since the actions given are specific rather than minimal/generic.

3 / 5

Completeness

Both parts are explicitly present: 'what' = 'preparing a pickup checklist... rehydrating context from the latest handoff note', and 'when' = 'should be used... when starting a task'. This matches anchor 4 ('Has both what and when; when could be more explicit or specific') — the 'when' is generic timing rather than concrete trigger phrases, so anchor 5 does not fit; it is explicitly stated, so anchor 3 (when only weakly implied) does not fit either.

4 / 5

Trigger Term Quality

Relevant keywords are present ('pickup checklist', 'starting a task', 'handoff note', 'rehydrating context'), but common user phrasings and synonyms are missing — e.g. 'resume work', 'pick up where I left off', 'read the handoff'. This fits anchor 3 ('Some relevant keywords but missing common variations or synonyms'), not anchor 4, which requires good coverage with only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct ('pickup checklist', 'rehydrating context', 'handoff note' are distinctive terms), with only minor overlap risk against a closely related 'handoff' skill. Anchor 4 ('Mostly distinct; minor overlap risk with closely related skills') fits; anchor 5 is not earned because 'when starting a task' is a broad trigger that could fire at the start of nearly any task, and anchor 3 is too low given the distinctive vocabulary.

4 / 5

Total

14

/

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

marchatton/agent-skills

Path

.agents/skills/00-utilities/pickup/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.