CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ac-insight-extractor

Extract insights from autonomous coding sessions. Use when learning from completions, extracting patterns, analyzing decisions, or improving future performance.

Quality

79%

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-insight-extractor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 model of restraint for a script-backed skill: short, well-sectioned, with a verified executable Quick Start and an accurate one-level pointer to the implementation. The only notable gaps are the duplicated purpose statement, the undefined 'project_dir' variable, and the unmentioned log-file prerequisite.

DimensionReasoningScore

Conciseness

The body is lean with no concept-teaching padding, but the opening line ("Extract insights and learnings from autonomous coding sessions") and the Purpose section ("Analyzes completed sessions to extract patterns, learnings, and improvements") state the same thing twice. This is a minor trimmable redundancy, matching anchor 4 rather than 5's every-token-earns-its-place.

4 / 5

Actionability

The Quick Start gives concrete, executable code ("extractor = InsightExtractor(project_dir); insights = await extractor.extract_session_insights(); await extractor.apply_learnings(insights)") that matches the verified script API. Minor gaps keep it at anchor 4: 'project_dir' is undefined and there is no note that the calls are async and need an event loop.

4 / 5

Workflow Clarity

The Quick Start conveys a clear instantiate -> extract -> apply sequence, and as a simple single-purpose skill no validation checkpoints are required. It stays at anchor 4 rather than 5 because the prerequisite data source (the session log file the extractor reads, '.claude/autonomous-log.jsonl') is never mentioned, so a reader cannot tell what must exist beforehand.

4 / 5

Progressive Disclosure

Per the simple-skill scoring note, a sub-50-line skill with no need for external references can score 5 with well-organized sections alone. The body has clean sections (Purpose, Quick Start, API Reference) and its single reference ("See scripts/insight_extractor.py for full implementation") is one level deep and points to a real bundle file.

5 / 5

Total

17

/

20

Passed

Description

70%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 follows the strong pattern: third-person what-statement plus an explicit 'Use when...' clause with natural trigger phrases. Its main weakness is that the capability statement rests on a single generic action ('extract insights') and the when-clause could name more concrete triggering situations.

Suggestions

Replace the generic 'Extract insights' with several concrete capabilities, e.g., 'Analyze completed autonomous coding sessions to identify failure patterns, extract learnings, and apply them to future sessions'.

Make the when-clause more concrete by naming triggering situations, e.g., 'Use when an autonomous coding session completes, when reviewing agent session logs, or when running a retrospective on agent performance'.

Add natural synonyms users would say (retrospective, session review, post-mortem) to broaden trigger coverage.

DimensionReasoningScore

Specificity

"Extract insights from autonomous coding sessions" names the domain and one core action, with related activities ("extracting patterns, analyzing decisions") relegated to the when-clause rather than stated as capabilities. This matches anchor 3 (domain + 1-2 concrete actions, not comprehensive); it is not 4 because the 'what' is a single generic action rather than several specific listed actions.

3 / 5

Completeness

Both parts are present: a clear what ("Extract insights from autonomous coding sessions") and an explicit when ("Use when learning from completions..."). It falls short of anchor 5 because the when-clause stays abstract rather than naming concrete trigger situations such as 'after a session completes' or 'when reviewing session logs'.

4 / 5

Trigger Term Quality

"learning from completions, extracting patterns, analyzing decisions, or improving future performance" provides good natural-phrase coverage. A few natural terms users might say are missing (e.g., retrospectives, session review, post-mortem), so it fits anchor 4 rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Autonomous coding sessions" carves out a clear niche with distinct triggers, giving minimal conflict risk. Minor overlap remains with general code-review or retrospective skills, matching anchor 4 (mostly distinct) rather than 5.

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

fernandezbaptiste/Skrillz

Path

skills/ac-insight-extractor/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.