CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ac-session-manager

Session lifecycle management for autonomous coding. Use when starting sessions, resuming work, detecting session type (init vs continue), or managing auto-continuation between sessions.

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 ./skills/ac-session-manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 well structured with mostly API-accurate code examples, but it is undermined by a broken bundle: six of the seven referenced files do not exist, the prompt content that PROMPTS.md should hold is inlined instead, and detection logic is redundantly presented three times. The auto-continuation workflow also lacks any failure-handling or validation checkpoints.

Suggestions

Create the referenced files (references/SESSION-LIFECYCLE.md, references/PROMPTS.md, references/MULTI-SESSION.md) or remove the References section — pointing readers at nonexistent files breaks progressive disclosure entirely.

Fix the Scripts section to match the actual bundle: session_detector.py, auto_continue.py, and prompts.py do not exist; their logic lives inside session_manager.py.

Remove the redundant ASCII lifecycle diagram (it duplicates the Session Types table and Detection Logic code) and add error-recovery guidance for the auto-continue loop (e.g., what to do when a session fails or a feature stalls).

DimensionReasoningScore

Conciseness

The body is mostly lean code and tables, but the session-type detection logic is presented three times (ASCII lifecycle box, Session Types table, and Detection Logic code block), and the Quick Start section repeats the Operations section — clear tightening opportunities. Not anchor 4 because the redundant ASCII-art diagram plus triple duplication is more than 'minor instances of over-explanation'.

3 / 5

Actionability

The code examples are concrete and mostly match the actual API of the existing scripts/session_manager.py (detect_type, run_initializer, run_continuation, configure_auto_continue, shutdown, SessionConfig), covering the common cases. Not anchor 5 because 'SessionManager.create(...)' does not exist in the module, and the Scripts section lists three files (session_detector.py, auto_continue.py, prompts.py) that are not present in the bundle.

4 / 5

Workflow Clarity

The lifecycle is well sequenced (DETECT → CREATE → RUN → END, with a session-types table and multi-session flow diagram), but the auto-continuation loop is a batch/automated operation with no validation or error-recovery checkpoints — there is no guidance for what happens when a session fails, a feature never passes, or the SDK errors mid-run. Per the rubric's cap for batch operations lacking verification steps, workflow clarity cannot exceed 3.

3 / 5

Progressive Disclosure

The References and Scripts sections point to seven bundle files, but six do not exist — there is no references/ directory, and only scripts/session_manager.py is present, so the promised navigation paths lead nowhere. Content that clearly belongs in the (nonexistent) references — the full Initializer and Continuation prompt templates — is inlined in SKILL.md instead. Structure and signaling are decent, but broken references and inline duplication place this at anchor 2 rather than 3.

2 / 5

Total

12

/

20

Passed

Description

71%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 solid description with an explicit 'Use when' clause and several natural trigger phrases. Its main weaknesses are an abstract 'what' statement ('Session lifecycle management') whose specificity is borrowed entirely from the 'when' clause, and meaningful overlap risk with the sibling ac-* skills it integrates with.

Suggestions

Replace the abstract lead with concrete capabilities, e.g. 'Detects session type (INIT/CONTINUE/COMPLETE), creates SDK sessions, auto-continues between sessions, and preserves state via handoffs.'

Add distinguishing trigger terms that separate it from sibling skills, such as 'feature_list.json', 'handoff', or 'session state' — these would sharpen both trigger quality and distinctiveness.

Mention 'session status' or 'check session state' as a trigger since that is a phrase users would naturally say and it appears in the frontmatter triggers list.

DimensionReasoningScore

Specificity

The description names several concrete actions — 'starting sessions, resuming work, detecting session type (init vs continue), or managing auto-continuation between sessions' — beyond the generic lead phrase 'Session lifecycle management'. It falls short of anchor 5 because the lead 'what' is an abstract category rather than a comprehensive list of concrete operations.

4 / 5

Completeness

Both parts are present: the 'what' ('Session lifecycle management for autonomous coding') and an explicit 'Use when...' clause with concrete trigger phrases. It sits below anchor 5 because the 'what' is a single abstract noun phrase rather than an explicit enumeration of capabilities — the concrete actions only appear in the 'when' clause.

4 / 5

Trigger Term Quality

Phrases like 'starting sessions', 'resuming work', 'detecting session type', and 'auto-continuation' are natural things a user would say when they need this skill. It is not anchor 5 because common variations and file-name triggers (e.g. 'session status', 'feature_list.json', 'handoff') are absent.

4 / 5

Distinctiveness Conflict Risk

'Session lifecycle management' and 'resuming work' occupy a real niche (autonomous coding sessions), but the skill's own Integration Points list closely related siblings (ac-state-tracker, ac-autonomous-loop 'orchestrates sessions', ac-handoff-coordinator) whose descriptions plausibly overlap these triggers. Not anchor 4 because the overlap with a session-orchestration sibling skill is more than minor.

3 / 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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/ac-session-manager/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.