CtrlK
BlogDocsLog inGet started
Tessl Logo

retrospect-collab

Analyze collaboration patterns (HOW) and compute metrics from captured sessions. Use when reviewing collaboration quality, analyzing human-AI interaction, computing session metrics. Triggers include "retrospect collab", "collaboration analysis", "session patterns", "how am I collaborating".

64

Quality

76%

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/specialized/retrospect-collab/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 instruction skill: sequenced steps, concrete commands and slash-invocation examples, explicit error-recovery gotchas, and a genuinely useful one-level-deep reference file. The main gaps are the missing scripts/retrospect-load-sessions.sh in the bundle (referenced in both Steps and Gotchas), minor duplication between the body's Metrics Summary Format and the reference's report template, and the absence of an output-verification checkpoint.

Suggestions

Ship or locate `scripts/retrospect-load-sessions.sh` — it is invoked in step 1 and gotchas but does not exist in the skill bundle; if it lives at the plugin root, state that path explicitly so the invocation is verifiable.

Replace the in-body 'Metrics Summary Format' section with a pointer to the report template in references/reference.md, which already contains the identical format, to remove duplication.

Add a final verification step, e.g., 'Confirm the report file exists at .retro/insights/collab/{PERIOD}.md and that the Sessions count in the Metrics Summary equals the number of session paths from step 1'.

DimensionReasoningScore

Conciseness

The body is dense and operational (steps, commands, gotchas) with no explanations of concepts Claude already knows, but the "Metrics Summary Format" block duplicates the Metrics Summary already present in reference.md's report template, and the gotcha about testing the loader repeats step 1. This matches 'efficient; minor instances that could be trimmed' rather than score 5's 'every token earns its place', and is well above score 3's noticeable padding.

4 / 5

Actionability

Concrete copy-paste guidance throughout: `bash ${CLAUDE_PLUGIN_ROOT}/scripts/retrospect-load-sessions.sh $@`, exact slash-command examples for every argument mode, a concrete output path with example filename, and a filled-in metrics example. Not score 5 because the referenced loader script (`scripts/retrospect-load-sessions.sh`) does not exist in the skill's bundle (only `references/reference.md` is present), leaving a minor executability gap; far above score 3's pseudocode/incomplete level.

4 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced with concrete commands, and the Gotchas section supplies error-recovery loops (skip duration metrics when `duration_seconds` is absent, emit a partial report when session files are unreadable, parse the PERIOD header carefully, test the loader directly). Not score 5 because there is no explicit checkpoint verifying the report was written correctly or that the analyzed session count matches the loader output; this is not a destructive/batch-write operation, so the score-3 cap does not apply.

4 / 5

Progressive Disclosure

Good structure against the actual bundle: the body is an overview with well-labeled sections and a clearly signaled, real one-level-deep reference ([Reference](references/reference.md) — 'scoring rubrics, metric definitions, and report format'). Not score 5 because the body references a `scripts/` directory that is absent from the bundle, and it inlines the Metrics Summary format and analysis dimension lists that partially duplicate reference.md content rather than deferring them.

4 / 5

Total

16

/

20

Passed

Description

78%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 when' clause and natural quoted trigger phrases, clearly answering both what the skill does and when to use it. Its main weakness is that it surfaces only two of the skill's concrete capabilities (impact categorization, Start/Stop/Continue output, longitudinal progression are all missing) and does not distinguish itself from the sibling domain-retrospective skill.

Suggestions

Add the skill's other concrete capabilities to the 'what' clause, e.g., 'categorize sessions by impact (Automation / Low-impact / High-impact augmentation), generate Start/Stop/Continue recommendations, and track skill progression across sessions'.

Add natural trigger synonyms such as 'retrospective', 'how do I work with AI/Claude', or 'collab quality' to broaden keyword coverage.

Include a brief disambiguator in the description (e.g., 'for HOW collaboration worked, not WHAT was learned — use retrospect-domain for that') to reduce overlap risk with the sibling skill.

DimensionReasoningScore

Specificity

"Analyze collaboration patterns (HOW) and compute metrics from captured sessions" names the domain and exactly two concrete actions (analyze patterns, compute metrics). It is not score 4 because the skill's other real capabilities (impact categorization, Start/Stop/Continue, longitudinal progression) are absent, leaving coverage gaps; it is above score 2 because the actions named are more specific than generic domain-labeling.

3 / 5

Completeness

It explicitly answers both parts: "what" via "Analyze collaboration patterns (HOW) and compute metrics from captured sessions" and "when" via "Use when reviewing collaboration quality, analyzing human-AI interaction, computing session metrics" plus a concrete quoted trigger list. This matches the score-5 anchor (clear what AND when with concrete trigger phrases) and exceeds score 4, where the 'when' would be less explicit or specific.

5 / 5

Trigger Term Quality

Trigger phrases "retrospect collab", "collaboration analysis", "session patterns", "how am I collaborating" are natural user phrasings, with "how am I collaborating" an especially likely verbatim query. Not score 5 because common synonyms/variants are missing (e.g., "retrospective", "how do I work with AI/Claude", "collab quality", "teamwork"); not score 3 because coverage goes well beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

The niche (HOW-focused collaboration analysis of captured AI sessions) is mostly distinct with targeted triggers like "retrospect collab" and "session patterns". Not score 5 because the description does not disambiguate from the closely related `retrospect-domain` skill (the HOW/WAT distinction lives only in the body), leaving minor overlap risk with that sibling skill; well above score 3's broader overlap profile.

4 / 5

Total

16

/

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
pantheon-org/tekhne
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.