CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apm-9-recover

Recover an APM agent's working context. Use only when the User manually invokes this skill.

Quality

81%

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

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 an exemplary lean instruction-only skill: a tight five-step recovery procedure with explicit role handling, ask-user checkpoints, and clear delegation to sibling APM skills instead of duplicating their file lists. The only meaningful gap is the absence of an explicit verification step confirming the rebuilt state before continuing, and reliance on framework placeholders for full executability.

DimensionReasoningScore

Conciseness

The body is lean and prescriptive with zero padding: it assumes APM knowledge (never explains what compaction, a Handoff, or the bus are) and every sentence carries an instruction, matching 'Lean and efficient; assumes Claude's competence; every token earns its place'. It is not a 4 because there is no over-explanation that could be trimmed — even the gating paragraph adds a condition ('or an APM instruction directs you here') beyond the frontmatter.

5 / 5

Actionability

Guidance is concrete and directive — reread '{SKILL_PATH:apm-2-initiate-manager} §1', keep the current prompt's 'log_path', record the recovery in 'the Tracker's Notes' — with both Manager and Worker branches covered, fitting 'Mostly executable guidance; concrete code or commands with minor gaps'. It is not a 5 because key operations resolve through templated placeholders and external structures ({VERSION}, {SKILL_PATH:...}, 'the bus and the code') rather than fully literal, self-contained instructions; not a 3 because no key details are missing for the APM context it targets.

4 / 5

Workflow Clarity

Five numbered steps in a clear sequence with explicit checkpoints — 'If neither settles it, ask' (step 1), 'Ask the User about gaps the files cannot settle' (step 3), and the report-back in step 5 — matching 'Clear sequence with most checkpoints present; minor validation gaps'. It is not a 5 because there is no explicit verification that the rebuilt state matches the pre-loss state before continuing; not a 3 because checkpoints are explicit, not merely implied, and the operation is non-destructive so no cap applies.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files, and the body is well organized (title, gating, context, numbered procedure) while correctly delegating the file lists to the sibling initiation skills via clearly signaled one-level references ('{SKILL_PATH:apm-2-initiate-manager} §1'), matching both the under-50-lines guideline and 'Clear overview with well-signaled one-level-deep references'. No nesting or buried references exist, so no lower anchor fits.

5 / 5

Total

18

/

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 is concise, uses third person, and clearly identifies a distinct APM-specific niche with an explicit manual-invocation when-clause. Its main weaknesses are thin action coverage (one action) and missing the natural scenario terms (compaction, lost conversation, resume) that would help a user recognize when to invoke it.

Suggestions

Add one or two more concrete actions to the description, e.g. 'Rebuilds state from the file lists, logs, and the bus' instead of the single generic action 'Recover an APM agent's working context'.

Include the triggering scenarios as natural keywords, e.g. 'Use after compaction, a lost conversation, or when context must be rebuilt' so users recognize the skill by the situations they would actually describe.

Make the when-clause situational in addition to procedural — state both when it applies (context loss) and that it is manual-invocation only.

DimensionReasoningScore

Specificity

"Recover an APM agent's working context" names the domain (APM agent recovery) and one concrete action, matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because only a single action is listed (no mention of rebuilding state from files, logs, or the bus), and not a 2 because the action is domain-specific rather than generic.

3 / 5

Completeness

Both parts are answered: the what is "Recover an APM agent's working context" and the when is the explicit clause "Use only when the User manually invokes this skill", matching 'Has both what and when; when could be more explicit or specific'. It is not a 5 because the when-clause is procedural (manual invocation) rather than concrete situational trigger phrases (e.g., after compaction or context loss).

4 / 5

Trigger Term Quality

Relevant keywords are present ("Recover", "APM agent", "working context") but the natural phrases a user would say in the triggering scenarios — "compaction", "lost conversation", "resume" — are absent, fitting 'Some relevant keywords but missing common variations or synonyms'. It is not a 4 because more than a few natural terms are missing.

3 / 5

Distinctiveness Conflict Risk

"APM agent's working context" carves out a clear niche with the distinctive term APM, and the manual-invocation-only condition means it cannot auto-trigger for the wrong skill, matching 'Clear niche with distinct triggers; minimal conflict risk'. No neighboring anchor fits better since no other skill domain is plausibly conflated with APM context recovery.

5 / 5

Total

15

/

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

sdi2200262/agentic-project-management

Path

templates/skills/apm-9-recover/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.