CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

retro

Analyze sprint retrospectives for patterns and action item tracking. Usage: /retro analyze <retro_data.json>

62

Quality

78%

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 ./.gemini/skills/retro/SKILL.md
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.

The body is an exemplar of brevity — compact, well-sectioned, and concrete, with a complete input format and usage examples. Its weaknesses are almost entirely structural: the skill delegates all actual analysis work to a script path that does not exist in this bundle, and the dangling 'Skill Reference' link adds confusion rather than navigation value. Fixing or inlining the reference targets would resolve the main issues.

Suggestions

Fix the script reference to a bundle-relative path (e.g., scripts/retrospective_analyzer.py) and include the script in the bundle, or inline the analysis guidance so the skill works standalone.

Remove or clarify the 'Skill Reference' section pointing to another SKILL.md at an external path — as written it is a dangling link that adds no navigation value.

Add brief guidance on interpreting the output or handling malformed input files so the skill remains actionable even if the referenced script is unavailable.

DimensionReasoningScore

Conciseness

The body is lean and efficient — every section (Usage, Input Format, Examples, Scripts) carries concrete information, with no padding or explanations of concepts Claude already knows. It fully matches the anchor for a body where every token earns its place.

5 / 5

Actionability

Concrete commands with full syntax, a complete executable input JSON example, and specific example invocations make the guidance mostly executable. The gap keeping it below anchor 5 is that the analyzer script is referenced by an external path not present in this bundle, and there is no inline guidance for what the analysis should produce or how to handle malformed input.

4 / 5

Workflow Clarity

This is a simple, single-purpose skill: the single action — run the analyzer on a retro JSON file, with optional --format text|json — is unambiguous, with input shape and flags fully specified. Per the simple-skill exception, a single unambiguous action warrants a 5; it involves no destructive or batch operations that would cap the score.

5 / 5

Progressive Disclosure

Sections are well-organized for a short skill, but the two file references point outside the bundle to non-existent local paths ("project-management/skills/scrum-master/scripts/retrospective_analyzer.py" and "project-management/skills/scrum-master/SKILL.md") and are not clearly signaled as external. This matches the anchor for references present but not clearly signaled, rather than anchor 4's well-signaled, appropriately placed references.

3 / 5

Total

17

/

20

Passed

Description

61%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 states a clear, domain-specific capability but reads more like a command manual entry than a trigger-optimized skill description. Its main weaknesses are the missing 'Use when...' trigger guidance and limited keyword breadth. Adding explicit trigger conditions and a few natural synonyms would raise both completeness and trigger term quality.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user mentions sprint retrospectives, retros, or asks about recurring team issues or action item follow-up."

Include natural trigger variations and synonyms such as "retros", "sprint feedback", and "team retrospective" to broaden keyword coverage.

Expand the 'what' slightly with the concrete outputs it produces (e.g., sentiment trends, action item effectiveness) to move from 1-2 actions toward comprehensive coverage.

DimensionReasoningScore

Specificity

"Analyze sprint retrospectives for patterns and action item tracking" names the domain (sprint retrospectives) plus two concrete actions (pattern analysis, action item tracking), matching the anchor for 1-2 concrete actions that are not comprehensive. It is below anchor 4, which expects several specific actions with only minor coverage gaps.

3 / 5

Completeness

The 'what' is clear (analyze sprint retrospectives for patterns and action item tracking) but there is no 'when' — the "Usage: /retro analyze <retro_data.json>" clause documents command syntax, not a trigger condition. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3; this is not anchor 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

Natural domain terms are present — "sprint retrospectives", "retro", "action item" — which users in this domain would actually say, giving good keyword coverage. Common variations and synonyms (e.g., "retros", "sprint review", "team retrospective") are missing, keeping it below anchor 5 and just above anchor 3, which fits a description with only one relevant keyword.

4 / 5

Distinctiveness Conflict Risk

Sprint retrospective analysis is a fairly distinct niche with domain-specific triggers, so it is mostly distinguishable from unrelated skills. Minor overlap risk remains with closely related project-management or sentiment-analysis skills, keeping it below anchor 5's 'clear niche with distinct triggers'.

4 / 5

Total

14

/

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

alirezarezvani/claude-skills

Path

.gemini/skills/retro/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.