CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

collab-proof

Use when you want to understand what Claude contributed vs what you drove in a session. Triggers on: /collab-proof, session retrospective, ai contribution analysis, collaboration evidence, what did claude do.

63

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

The canonical home for this skill is collab-proof in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 a highly actionable, well-sequenced procedure with concrete commands, numeric scoring rubrics, complete scripts, and exact output templates. Its main weakness is that everything lives in SKILL.md: the HTML spec and token script would sit better in reference files loaded only when signal is HIGH. A few error-handling checkpoints would complete the workflow.

Suggestions

Move the fixed HTML structure spec and CSS tokens to references/proof-html-template.md and the token-collection script to scripts/token_usage.py, referencing them only in the HIGH-signal branch of Layer 03 — this would cut SKILL.md context cost roughly in half for MEDIUM/LOW sessions.

Add brief validation steps, e.g. a guard for non-git directories ('if git commands fail, treat as LOW — no code changes') and a check that ~/.claude/projects jsonl files exist before the token script runs.

Drop or explain the branding tagline 'Vela 3-layer pipeline × ADHD 4-frame reasoning', which reads as jargon and adds no operational value.

DimensionReasoningScore

Conciseness

The body is dense with operational specifics — scoring rubrics with numeric anchors, exact git commands, fill-in templates — and never explains concepts Claude already knows, fitting anchor 4 ('efficient; minor instances of over-explanation that could be trimmed'). It is not a 3 because there is no genuinely unnecessary explanation; the only trimmable fluff is the cryptic tagline 'Vela 3-layer pipeline × ADHD 4-frame reasoning — prompt-native, zero dependencies' and a few rationale sentences like 'zero uncertainty in a fast-moving session is a feature, not a reason to discard it'.

4 / 5

Actionability

Fully executable throughout: concrete commands ('git log --oneline -10', 'git diff --stat HEAD~3..HEAD'), a complete runnable Python script for token collection, exact output templates for DECISIONS.md/session-history/WORKLOG, fixed CSS tokens, and a fixed HTML class structure written via a bash heredoc — matching anchor 5 ('fully executable; copy-paste ready code or commands').

5 / 5

Workflow Clarity

The Layer 01 → 02 → 03 sequence is clear with branches per signal level and explicit user-visible checkpoints ('Show the user: Signal: HIGH / MEDIUM / LOW', 'resolve to this structure (show it to the user)'), plus a defined PreCompact merge flow — anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'). Not a 5: there are no error-recovery steps for foreseeable failures (git commands failing outside a repo, missing ~/.claude/projects, malformed jsonl) and no verification after file appends.

4 / 5

Progressive Disclosure

There are no bundle files at all — everything (~380 lines) is inlined in SKILL.md. The fixed HTML structure spec (~70 lines), CSS tokens, and the token-collection script are only needed for HIGH-signal sessions yet always occupy context, matching anchor 3 ('content that should be separate is inline'). Section organization itself is good, ruling out anchor 2's 'minimal structure', but at this size with zero external references it cannot reach anchor 4.

3 / 5

Total

16

/

20

Passed

Description

68%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 has strong trigger coverage and a distinctive, low-conflict niche, but the capability statement is purpose-level rather than concrete: it says what you'll understand, not what the skill does. The second-person phrasing further weakens it. Adding third-person, verb-level actions (classifies sessions, scores AI contribution, generates report files) would lift it substantially.

Suggestions

State concrete actions in third person, e.g. 'Classifies a session by signal level, scores four intent frames, and appends decision/session records (DECISIONS.md, session-history/, WORKLOG.md, HTML proof) — use when you want to know what Claude contributed vs what you drove.'

Remove the second-person construction ('when you want to understand') in favor of an impersonal 'Use when...' clause to match third-person voice requirements.

Add one or two natural trigger variations users might type, such as 'session summary' or 'what did we accomplish in this session'.

DimensionReasoningScore

Specificity

The description states a purpose — "understand what Claude contributed vs what you drove in a session" — but names no concrete actions the skill performs (no mention of session classification, frame scoring, or generating DECISIONS.md/session-history/WORKLOG/HTML reports), matching anchor 2 ('names the domain but actions are minimal or generic') rather than anchor 3's '1-2 concrete actions'. It also uses second person ('Use when you want to...'), which the judging guidelines penalize by reducing specificity by 1.

2 / 5

Completeness

Both what and when are present: an explicit trigger clause ('Use when you want to understand... Triggers on: ...') plus a purpose statement. The 'what' is a goal-level description rather than a concrete account of outputs, so it falls short of anchor 5's 'clearly and explicitly answers both what AND when with concrete trigger phrases' and lands on anchor 4.

4 / 5

Trigger Term Quality

Five explicit triggers are listed — "/collab-proof, session retrospective, ai contribution analysis, collaboration evidence, what did claude do" — several of which are natural user phrases; however, common variations like 'session summary' or 'what did we accomplish' are missing, so it fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche — session retrospection and AI-contribution evidence — is clearly distinct, with triggers like '/collab-proof' and 'what did claude do' unlikely to fire for any other skill, matching anchor 5 ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

15

/

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/collab-proof/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.