CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-resume

Pick up where you left off from a previous session — use after context resets, compaction, or new conversations

58

Quality

68%

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 ./.claude/skills/skill-resume/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 delivers a genuinely clear, well-validated phase workflow with concrete commands and routing tables — its strongest dimension. Its weaknesses are redundancy (duplicated failure messages, restated trigger lists, four full example blocks) and monolithic structure: nothing is split into reference files, and the scripts it depends on are absent from the bundle, leaving the progressive-disclosure story incomplete.

Suggestions

Cut duplication: remove Example 1 (identical to the Phase 1 failure block), drop the 'Quick Reference' and 'Bottom Line' sections that restate earlier content, and keep at most two representative example outputs inline.

Move the four full example outputs and the 'Integration with Other Skills' section into a references/ file (e.g. EXAMPLES.md) linked one level deep, keeping SKILL.md to the phase workflow and routing table.

Resolve the ./scripts/octo-state.sh dependency: either ship the script in the bundle's scripts/ directory or document where the plugin provides it, so the primary commands are executable as shipped.

DimensionReasoningScore

Conciseness

The body is operational rather than educational (no explaining of concepts Claude already knows), but it carries substantial duplication: Example 1 repeats the Phase 1 failure message verbatim, the 'Quick Reference' table restates the 'When to Use' list, 'The Bottom Line' restates the core principle, and four full example outputs each restate the summary template. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' — clearly below score 4's 'minor instances' and above score 2's 'several padded explanatory sections'.

3 / 5

Actionability

Commands are concrete and copy-paste ready (octopus state-path resolution, read_state, grep/sed extraction with expected output formats, routing tables). It falls short of score 5 because ./scripts/octo-state.sh is invoked as the primary interface but does not exist in this skill's bundle, so the commands are not fully executable as shipped without assuming an external plugin layout.

4 / 5

Workflow Clarity

Phases 0-6 are explicitly sequenced with hard checkpoints ("Stop here - do not proceed to Phase 2", existence checks with exit 1, refusal to resume incompletely when state-path fails), a full routing table by status, phase-specific guidance, and error-recovery direction for every failure mode. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

Section structure and headers are good, but the ~540-line body inlines content that belongs in separate reference files (four full example outputs, the integration-with-other-skills notes, the Quick Reference table), and it references ./scripts/octo-state.sh and context/*.md files that are not present in the bundle. This matches 'some structure but could be better organized; content that should be separate is inline' — below score 4's 'most content appropriately placed', above score 2's 'minimal structure'.

3 / 5

Total

15

/

20

Passed

Description

66%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 cleanly pairs a purpose with an explicit 'use when' clause and occupies a distinct niche, but it under-specifies what the skill actually does and omits the most natural trigger words ("resume", "continue") that the body's own trigger block lists. Third-person voice is respected and it is concise.

Suggestions

State the concrete actions in the description, e.g. "Restores session state from the previous workflow — loads project context, shows recent history and blockers, and routes to the next step".

Add the natural trigger phrases users actually say ("resume", "continue", "what was I doing") to the 'when' clause, mirroring the trigger block in the frontmatter.

Optionally name the state artifacts it reads (.octo/STATE.md or the handoff file) to further sharpen distinctiveness from generic continuation requests.

DimensionReasoningScore

Specificity

The description names the domain ("previous session") and one action ("Pick up where you left off"), but that action is generic — it never states what the skill concretely does (restore state, load context, display history, route to next action). It fits the 'names domain and 1-2 concrete actions, but not comprehensive' anchor and is clearly below score 4, which expects several specific listed actions.

3 / 5

Completeness

Both parts are present: the 'what' ("Pick up where you left off from a previous session") and an explicit 'when' clause ("use after context resets, compaction, or new conversations"). Score 5 requires concrete trigger phrases on both sides; the 'what' side stays vague (no mention of state restoration or context loading), so it sits at 'both present; when could be more explicit/specific' territory rather than clearly above it.

4 / 5

Trigger Term Quality

"pick up where I left off" is a natural user phrase, and the situational triggers ("context resets, compaction, or new conversations") cover real scenarios, but the most common user phrasings — "resume", "continue", "what was I doing" — are absent from the description. This matches 'some relevant keywords but missing common variations or synonyms' rather than score 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

Session resumption after context loss is a clear niche with distinct situational triggers, and the phrasing is unlikely to fire for unrelated skills. It matches 'clear niche with distinct triggers; minimal conflict risk'; the only mild risk is overlap with generic 'continue' requests, which is not enough to drop to score 4.

5 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (542 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
nyldn/claude-octopus
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.