CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

retro

Weekly engineering retrospective. Analyzes commit history, work patterns, and code quality metrics with persistent history and trend tracking. Team-aware: breaks down per-person contributions with praise and growth areas. Use when asked to "weekly retro", "what did we ship", or "engineering retrospective". Proactively suggest at the end of a work week or sprint.

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/gstack/.agents/skills/gstack-retro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 retro workflow itself is exceptionally actionable — exact commands, schemas, output templates, and error paths throughout — with a well-sequenced multi-mode flow. However, the file is bloated with framework boilerplate unrelated to the retrospective task and is a single 56KB monolith with no progressive disclosure, which hurts token efficiency and navigability.

Suggestions

Move the generic framework sections (Voice, AskUserQuestion Format, Completeness Principle, Contributor Mode, Completion Status Protocol, Plan Status Footer, preamble/telemetry shell) out of SKILL.md into a shared reference file the skill points to, keeping only retro-specific instructions inline.

Split the ~330-line Global Retrospective Mode (discovery flow, personal card template, JSON schema) and the snapshot schemas into a separate reference file referenced from the main workflow, shrinking SKILL.md to an overview plus the core Steps 1-14.

Fix the internal inconsistencies: two commands in Step 1 are both numbered "# 12", and Step 14's narrative cites "Trends vs Last Retro (from Step 11)" when that data is loaded in Step 12.

DimensionReasoningScore

Conciseness

The ~1190-line body pads the retro task with large framework boilerplate — a 45-line preamble shell block, the multi-section "Voice" persona, the "Boil the Lake" essay promo, telemetry/AskUserQuestion/Contributor/Plan Status sections — plus duplicate numbering (two commands labeled "# 12") and a mislabeled cross-reference ("from Step 11" for data computed in Step 12). Several sections are unnecessary or unrelated to the task, matching the 2 anchor rather than 3's "some unnecessary explanation".

2 / 5

Actionability

Every step ships copy-paste-ready bash commands, argument validation with exact usage text, concrete JSON snapshot schemas, formatted output templates (leaderboard, personal card, trends tables), and binary fallback chains with explicit placeholder substitution (SKILL_NAME, OUTCOME, USED_BROWSE). Fully executable guidance covering the common cases — the 5 anchor; not 4 since gaps are negligible.

5 / 5

Workflow Clarity

Steps 0-14 are clearly sequenced with distinct Global and Compare flows, and validation checkpoints are explicit (invalid argument → show usage and stop; zero commits → suggest different window; no discovery binary or zero sessions → message and stop; compare only when prior window matches). Minor gaps — the duplicate "12" commands, the "from Step 11" mislabel, and absent feedback/retry loops — keep it at 4 rather than 5; the skill is read-only analysis so the destructive-operation cap does not apply.

4 / 5

Progressive Disclosure

This is a single monolithic file with no bundle files at all: the retro workflow, global mode, JSON schemas, and generic framework policy are all inlined. Header navigation is good and there are no nested or broken references (so above 2's "minimal structure"), but substantial content that clearly belongs in separate files is inline — the 3 anchor.

3 / 5

Total

14

/

20

Passed

Description

87%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: it states concrete capabilities in third person and gives explicit quoted trigger phrases with timing guidance for proactive suggestion. Its only weaknesses are minor — the compare and global cross-project modes go unmentioned, and a few natural synonym triggers are missing.

DimensionReasoningScore

Specificity

"Analyzes commit history, work patterns, and code quality metrics", "persistent history and trend tracking", and "breaks down per-person contributions with praise and growth areas" list several concrete actions, but coverage has minor gaps — the compare-mode and cross-project global capabilities are never mentioned. This fits the 4 anchor (several specific actions, minor gaps) better than 5's comprehensive coverage and better than 3's 1-2 actions.

4 / 5

Completeness

The 'what' is explicit ("Analyzes commit history, work patterns, and code quality metrics... per-person contributions") and the 'when' is explicit with concrete trigger phrases ("Use when asked to 'weekly retro', 'what did we ship', or 'engineering retrospective'"). Both are clearly and concretely answered, matching the 5 anchor exactly; it exceeds 4 because the 'when' clause is fully explicit rather than merely adequate.

5 / 5

Trigger Term Quality

Natural quoted phrases like "weekly retro", "what did we ship", and "engineering retrospective" are exactly what a user would say, plus timing guidance "at the end of a work week or sprint". Common variations ("sprint retro", "retrospective", "what did I ship", "weekly review") are missing, so it falls just short of the 5 anchor's synonym-level coverage but is clearly above 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

"Weekly engineering retrospective" carves a clear niche with retro-specific triggers unlikely to fire for unrelated skills; only "what did we ship" carries slight overlap with a changelog/release-notes skill, which is minimal. Matches the 5 anchor (clear niche, distinct triggers, minimal conflict risk) rather than 4's "minor overlap risk with closely related skills".

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1193 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/gstack/.agents/skills/gstack-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.