CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

github-commit-recovery

Recover deleted commits from GitHub using REST API, web interface, and git fetch. Use when you have commit SHAs and need to retrieve actual commit content, diffs, or patches. Includes techniques for accessing "deleted" commits that remain on GitHub servers.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

Highly actionable content with copy-paste-ready commands across all three access methods and solid troubleshooting feedback, but it is a monolithic single file: real-world case studies, secret-scanning lists, and API response details should live in one-level-deep reference files, and several explanatory passages (git flag explanations, the Istio narrative) could be trimmed.

Suggestions

Move 'Real-World Examples', 'High-Value Secret Categories', and the full API response structures into a references/ file (e.g., EXAMPLES.md), keeping SKILL.md as a lean overview with clearly signaled one-level-deep pointers.

Delete or compress the 'Why This Works' bullets re-explaining --filter=blob:none and --no-checkout — Claude already knows these flags.

Add exponential backoff / retry handling to the batch download script (e.g., on 403/429 read x-ratelimit-reset) so the batch workflow has an explicit validation-retry feedback loop.

DimensionReasoningScore

Conciseness

The bulk is commands and code, but there is trimmable explanatory content: 'Why This Works' bullets re-explaining git flags Claude already knows (--filter=blob:none, --no-checkout), the narrative Istio case study, and the 'High-Value Secret Categories' / 'Files Most Likely to Contain Secrets' lists. Matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not 4 because the real-world examples section and git-flag explanations are clearly unnecessary padding in the main file.

3 / 5

Actionability

Copy-paste ready guidance throughout: exact curl commands with headers, predictable URL patterns (.patch/.diff), a runnable Python batch script, concrete git clone --filter=blob:none / fetch / show commands, and jq pipelines. Matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'; not 4 because the common cases (web, API, git) each have complete executable examples.

5 / 5

Workflow Clarity

Quick Start gives an immediate sequence and each of the three methods is clearly ordered; the batch pattern validates responses (status_code == 200 check before writing) and the Troubleshooting section provides error-recovery feedback (403 -> check token/rate limit, 404 -> verify SHA, WAF -> reduce frequency). Matches 'clear sequence with most checkpoints present; minor validation gaps' — the batch loop lacks retry/backoff and there is no final verification step, so not 5; validation is present so not 3.

4 / 5

Progressive Disclosure

Sections are well-organized, but the ~295-line body has no bundle files at all — content that clearly belongs in separate reference files (Real-World Examples / Istio case study, secret-category lists, full API response structures, Troubleshooting) is inlined. Matches 'some structure but could be better organized; content that should be separate is inline'; not 4 because there is no reference layer whatsoever, not 2 because header-based navigation is genuinely good.

3 / 5

Total

15

/

20

Passed

Description

92%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: concrete, third-person, with an explicit 'Use when' trigger clause and specific named methods. The only gap is missing common synonyms like 'force push' or 'dangling commits' that users might naturally say.

Suggestions

Add natural trigger synonyms such as 'force-pushed commits' or 'dangling commits' to the description to broaden natural-language matching.

The final sentence ('Includes techniques for accessing "deleted" commits that remain on GitHub servers') largely restates the first — consider folding it in or replacing it with the SHA-source context (e.g., reflog, CI logs, GitHub Archive).

DimensionReasoningScore

Specificity

Multiple concrete actions with named methods: 'Recover deleted commits from GitHub using REST API, web interface, and git fetch' and 'retrieve actual commit content, diffs, or patches' give comprehensive coverage of the skill's niche. Not 4 because coverage of capabilities is essentially complete for this domain.

5 / 5

Completeness

Explicitly answers both: what ('Recover deleted commits from GitHub using REST API, web interface, and git fetch') and when ('Use when you have commit SHAs and need to retrieve actual commit content, diffs, or patches') with concrete trigger phrases. Not 4 because the 'when' clause is already explicit and specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage — 'deleted commits', 'commit SHAs', 'commit content, diffs, or patches' — but common variations users would actually say like 'force push', 'dangling commits', or 'git history' are missing. Not 5 because synonym coverage is incomplete; not 3 because the included terms are natural phrases a user would say.

4 / 5

Distinctiveness Conflict Risk

Clear niche (GitHub deleted-commit recovery) with distinct trigger terms ('deleted commits', 'commit SHAs'); minimal conflict risk with generic git or GitHub skills. Not 4 because the triggers are tightly scoped to this exact scenario.

5 / 5

Total

19

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

gadievron/raptor

Path

.claude/skills/oss-forensics/github-commit-recovery/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.