CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autonomous-session-manager

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

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

80%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 well-structured, highly actionable overview with executable Quick Start code and exemplary progressive disclosure — all referenced files exist and detail lives one level deep. The weak spot is workflow clarity: the lifecycle sequence is clear but lacks explicit validation and error-recovery checkpoints for the auto-continue loop, an operation that can run unlimited iterations.

Suggestions

Add explicit validation checkpoints to the workflow, e.g., 'verify session result and state file before triggering auto-continue' and a decision step for what happens when a session fails or errors.

Document the failure/feedback loop for the auto-continue operation: on session error, retry with backoff vs. stop; on max_iterations reached, shut down gracefully.

Consider replacing the 26-line ASCII box diagram with a compact numbered list — the same four phases are conveyed in the Key Features table and the lifecycle reference, saving ~20 lines of context.

DimensionReasoningScore

Conciseness

The body is lean overall — three compact Quick Start code blocks, a config dict, and pointer lists, with no explanation of concepts Claude already knows. Minor trimming is possible: the 26-line ASCII box diagram restates the four lifecycle phases that the Key Features table and references/SESSION-LIFECYCLE.md also cover, fitting anchor 4 ('efficient; minor instances... that could be trimmed') rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Quick Start provides fully executable, copy-paste-ready Python for all three core operations — 'from scripts.session_detector import detect_session_type, SessionType', 'async with SessionManager(project_dir, model=...) as session: result = await session.run(prompt)', and 'await auto_continue(delay_seconds=3)' — and all three referenced script files actually exist in the bundle. This matches anchor 5: executable examples covering the common cases.

5 / 5

Workflow Clarity

The Session Workflow diagram gives a clear 4-phase sequence (DETECT, CREATE, RUN, END) with sub-steps, but validation checkpoints are only implicit ('Check completion status'). Auto-continuation is a repeated/batch operation with 'max_iterations': None (unlimited), yet there is no explicit validation, error-recovery, or failure feedback loop (e.g., what happens when session.run fails), which per the judging guidelines caps workflow clarity at 3.

3 / 5

Progressive Disclosure

The body is a clear overview: Quick Start inline, detailed lifecycle and configuration pushed to well-signaled one-level-deep references ('references/SESSION-LIFECYCLE.md - Detailed lifecycle documentation', 'references/CONFIGURATION.md - Configuration options'), and a Scripts section listing all three script files, every one of which exists in the bundle. This matches anchor 5: clear overview, appropriately split content, easy navigation.

5 / 5

Total

17

/

20

Passed

Description

75%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: third-person, concise, with an explicit multi-trigger 'Use when' clause and a domain-scoped 'what'. Its main limitation is that the capability statement ('Session lifecycle management') is more abstract than the enumerated triggers, and a few natural trigger synonyms are absent.

Suggestions

Replace the abstract 'what' phrase with concrete verbs, e.g., 'Creates, resumes, detects, and auto-continues autonomous coding sessions' so the capability statement matches the specificity of the trigger clause.

Add one or two natural trigger variants users might say, such as 'restart' or 'loop coding sessions', to broaden keyword coverage.

Briefly state what distinguishes this from general loop/continuation skills (e.g., 'session type detection via feature_list.json') to reduce overlap risk with a related autonomous-loop skill.

DimensionReasoningScore

Specificity

The description names the domain ('Session lifecycle management for autonomous coding') and enumerates four concrete actions: 'starting new coding sessions, resuming work, detecting session type (init vs continue), or managing auto-continuation'. This matches the anchor 'lists several specific actions; minor gaps in coverage' — shutdown/state-saving operations are not mentioned, so it falls short of the comprehensive anchor 5, but it clearly exceeds the 1-2-action anchor 3.

4 / 5

Completeness

Both parts are present: the 'what' is 'Session lifecycle management for autonomous coding' and an explicit 'Use when' clause lists four concrete triggers. The 'when' is explicit and specific, but the 'what' is a somewhat abstract domain phrase rather than concrete verbs (compare anchor 5's 'Extract text and tables from PDF files, fill forms, merge documents'), so it fits anchor 4: both present, with room to be more explicit.

4 / 5

Trigger Term Quality

Natural phrases users would say are present: 'starting new coding sessions', 'resuming work', 'detecting session type (init vs continue)', 'auto-continuation'. Good keyword coverage matching anchor 4, though a few natural variants (e.g., 'restart session', 'spawn session', 'session loop') are missing, keeping it below the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — autonomous-coding session lifecycle with terms like 'init vs continue' and 'auto-continuation between sessions' that few other skills would claim. Minor overlap risk remains with closely related skills (e.g., an 'autonomous-loop' skill that also deals with continuous session operation), fitting anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/autonomous-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.