CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/retrospect-collab

Analyse human-AI collaboration patterns and compute quality metrics from captured session data.

72

Quality

90%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Content

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, lean, actionable skill body with a clear sequenced workflow and concrete output formats. The main defect is progressive disclosure: the body points to a reference file and a loader script that are not present in the bundle, leaving the core scoring logic and session loader unreachable.

Suggestions

Ship the referenced bundle files: references/reference.md (scoring rubrics, metric definitions, report format) and scripts/retrospect-load-sessions.sh are cited in the Steps and References but missing from the bundle.

Inline minimal Automation/Low-impact/High-impact categorization definitions in the body so the skill remains actionable even when reference.md is absent, or verify the reference path resolves at runtime.

Confirm the ${CLAUDE_PLUGIN_ROOT}/scripts/retrospect-load-sessions.sh path is correct; if the loader lives elsewhere, fix the path or document where to obtain it.

DimensionReasoningScore

Conciseness

The body is lean and list-driven with no concept-explanation padding; Principles (positive rules) and Anti-Patterns (negative rules with WHY rationale) are complementary rather than duplicative, and every command and example earns its place.

3 / 3

Actionability

Provides a concrete loader command, an exact Metrics Summary format with field names and sample numbers, and copy-paste usage examples; the analysis steps give specific categories and sub-dimensions rather than vague direction.

3 / 3

Workflow Clarity

A clear 7-step sequence is paired with error-recovery guidance in Gotchas (missing duration_seconds, unreadable session files -> partial report), giving feedback loops appropriate for this batch read operation.

3 / 3

Progressive Disclosure

Sections are well-organized and the reference is well-signaled and one level deep, but references/reference.md and scripts/retrospect-load-sessions.sh are cited in the body yet absent from the bundle, breaking navigation.

2 / 3

Total

11

/

12

Passed

Description

90%

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, third-person description that answers both what and when with natural trigger terms and a distinct niche. The only soft spot is specificity, where the named actions are somewhat abstract and overlapping rather than sharply concrete.

DimensionReasoningScore

Specificity

Names the collaboration-analysis domain and several actions ('Analyze collaboration patterns', 'compute metrics', 'reviewing collaboration quality', 'analyzing human-AI interaction'), but the verbs repeat at a high level rather than listing distinct concrete operations like the anchor-3 'extract, fill, merge'.

2 / 3

Completeness

Clearly states what it does ('Analyze collaboration patterns (HOW) and compute metrics from captured sessions') and when to use it ('Use when reviewing collaboration quality...') with explicit triggers, answering both what and when.

3 / 3

Trigger Term Quality

Explicit triggers 'retrospect collab', 'collaboration analysis', 'session patterns', and 'how am I collaborating' are natural phrases a user would actually say, giving good coverage.

3 / 3

Distinctiveness Conflict Risk

The HOW-focused collaboration-analysis niche with distinct triggers ('retrospect collab', 'how am I collaborating') carves a clear niche unlikely to trigger for the wrong skill.

3 / 3

Total

11

/

12

Passed

Validation

75%

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

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

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Reviewed

Table of Contents