CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

common-session-retrospective

Review session corrections, trigger misses and recurring agent mistakes to propose targeted skill-library changes. Use for retrospective, rework or routing-gap analysis before registry edits; load +common/common-learning-log for redacted evidence.

68

Quality

85%

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

85%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 protocol skill: a clear eight-step sequence with validation gates, safety guardrails, and clean deferral of detail to a single real reference file. The main improvements are trimming the empty Priority heading and the vague Canonical-response-anchors section, and adding one worked trigger-miss example.

Suggestions

Remove the empty "Priority: P1 (HIGH)" heading or fold priority information into the frontmatter — it adds tokens without guidance.

Clarify or remove the "Canonical response anchors" section; its instruction to "preserve domain terminology or equivalent concrete examples" is vague and duplicates nothing actionable.

Inline one small filled-in trigger-miss record example (or quote the JSON schema from methodology.md) so first-time execution needs no extra round trip.

DimensionReasoningScore

Conciseness

The body is lean and directive — no explanations of concepts Claude already knows, every line carries instructions (e.g. "do not patch a skill for a runtime permission failure", "Never persist credentials, customer identifiers, raw incident logs"). It misses a 5 because of tokens that earn no place: the empty "**Priority: P1 (HIGH)**" heading and the vague "Canonical response anchors" section add bulk without actionable value.

4 / 5

Actionability

The protocol gives concrete, executable guidance: exact fields to record ("skill ID, indirect phrase used, and fix (add keyword alias to triggers)"), concrete statuses ("status `proposed` until independently reviewed") and a defined output block with its schema deferred to references/methodology.md. Not a 5 because no worked example or filled-in trigger-miss record appears inline or is quoted in the body, leaving minor gaps for first-time execution.

4 / 5

Workflow Clarity

The eight-step Protocol is a clearly sequenced process with explicit validation checkpoints and feedback loops: "Evaluate — Compare candidate with current guidance and no-skill baseline on held-out cases", "Require independent maintainer approval", and the guideline "Stop on missing proof: Missing approval/evals leaves candidate unpromoted" with a canary/rollback path. This matches the top anchor of sequence plus explicit validation and recovery.

5 / 5

Progressive Disclosure

The body is a concise overview with a structure tree showing the single bundle file, and the detail (signal tables, taxonomy, report template, trigger-miss schema) is appropriately deferred to one-level-deep references at references/methodology.md, which exists and contains exactly that deferred content. Both mention sites use clear anchored links, matching the top anchor.

5 / 5

Total

18

/

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 with an explicit "Use for..." trigger clause and a clearly stated purpose tied to a niche domain. Its weaknesses are jargon-heavy phrasing ("routing-gap analysis") and missing common synonyms, which slightly limit natural trigger matching.

DimensionReasoningScore

Specificity

The description lists several specific actions — "Review session corrections, trigger misses and recurring agent mistakes to propose targeted skill-library changes" — naming concrete objects (corrections, trigger misses, recurring mistakes) and a concrete output (targeted skill-library changes). It falls short of a 5 because the action verbs are few (review, propose) and the phrasing is jargon-dense rather than plainly concrete.

4 / 5

Completeness

It explicitly answers both: what it does ("Review session corrections, trigger misses and recurring agent mistakes to propose targeted skill-library changes") and when to use it ("Use for retrospective, rework or routing-gap analysis before registry edits"), plus an explicit loading instruction. Both halves are concrete and clearly stated, matching the top anchor.

5 / 5

Trigger Term Quality

"Use for retrospective, rework or routing-gap analysis" includes natural user phrases like "retrospective" and "rework", giving good coverage. Not a 5 because common synonyms such as "post-mortem", "session review" or "skill feedback" are missing, and "routing-gap analysis" is jargon a user would rarely say.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (skill-library maintenance retrospectives before registry edits) with triggers unlikely to fire for unrelated skills. Minor overlap risk remains with generic code-review or learning/feedback skills, so it does not reach the fully distinct top anchor.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

.github/skills/common/common-session-retrospective/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.