CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

session-context

[Beta] Retrieves task-relevant prior sessions and returns a short, cited brief of decisions, corrections, failed approaches, and unresolved work. Use after the initial intent frame and before finalizing the approach, when asked to find related work, or when a concrete history gap could change the approach.

66

Quality

83%

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

The canonical home for this skill is session-context in pskoett/pskoett-ai-skills

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 dense, well-structured procedural skill with concrete budgets, an exact output template, and thorough validation and fallback handling. Its main costs are repetition across sections and hedge-heavy phrasing that could be tightened, plus a missing worked example.

Suggestions

Deduplicate repeated guidance: consolidate the 'reuse in-context history' rule (lines 27 and 43) and the 'fork does not inherit the conversation' rule (lines 70-71 and 132) into single statements to reduce token cost.

Add one short worked example of a filled-in prior-session brief (one decision, one failed approach, with Evidence/Source lines) so the output contract is unambiguous.

Consider moving the host-specific guidance (Amp/Claude Code/Codex tool details) into a references/ file, keeping SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body avoids explaining known concepts, but repeats guidance: "Reuse history already supplied in context" (line 43) restates "Reuse either source's findings when already in context" (line 27); "do not assume it inherits the conversation" (line 71) repeats "the fork does not inherit the conversation" (line 132); and no-repeat-retrieval rules appear across three sections. It is mostly efficient but could be noticeably tightened.

3 / 5

Actionability

Concrete, executable guidance throughout: numeric budgets ("two search rounds, three candidate sessions read, and a brief of at most roughly 600 tokens"), a copy-paste brief template, exact fallback strings ("No useful prior-session context found within <scope/budget>", "Session history unavailable"), and host-specific tool names. The minor gap is the absence of a worked example of a filled-in finding.

4 / 5

Workflow Clarity

A clearly sequenced procedure (Establish task/access -> Retrieve within budget -> Admit evidence -> Return brief) with explicit checkpoints: stop conditions ("Stop when useful evidence is sufficient, only topical matches remain, or the budget is exhausted"), a verification step ("Check current-state claims against current code, tests, or issue state before relying on them"), a follow-up feedback loop for material gaps, and complete fallback branches for no-match, partial, and unavailable history.

5 / 5

Progressive Disclosure

With no bundle files, the skill is a self-contained SKILL.md with well-organized, clearly headed sections appropriate to its size. The host-specific guidance section (Amp/Claude Code/Codex details) could arguably live in a reference file, a minor organization gap that keeps it below 5.

4 / 5

Total

16

/

20

Passed

Description

83%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 strong description: concrete capabilities, third-person voice, explicit multi-condition use triggers, and a distinct niche. The only weaknesses are slightly thin action enumeration and a few missing natural synonyms.

DimensionReasoningScore

Specificity

"Retrieves task-relevant prior sessions and returns a short, cited brief of decisions, corrections, failed approaches, and unresolved work" names two concrete actions with an enumerated list of deliverable content. It lists several specific actions with minor coverage gaps rather than the comprehensive multi-action coverage of a 5.

4 / 5

Completeness

It explicitly answers both what ("Retrieves task-relevant prior sessions and returns a short, cited brief of decisions, corrections, failed approaches, and unresolved work") and when ("Use after the initial intent frame and before finalizing the approach, when asked to find related work, or when a concrete history gap could change the approach") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural user phrases are present ("find related work", "prior sessions", "history gap"), giving good keyword coverage. Common synonyms such as "past conversations" or "previous chats" are missing, so it falls short of comprehensive 5-level coverage.

4 / 5

Distinctiveness Conflict Risk

The session-history-retrieval niche with triggers like "find related work" and "concrete history gap" is mostly distinct. There is minor overlap risk with general memory/recall-style skills, which keeps it below a clear-niche 5.

4 / 5

Total

17

/

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

pskoett/pskoett-ai-skills

Path

plugin/skills/session-context/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.