CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

github-evidence-kit

Generate, export, load, and verify forensic evidence from GitHub sources. Use when creating verifiable evidence objects from GitHub API, GH Archive, Wayback Machine, local git repositories, or security vendor reports. Handles evidence storage, querying, and re-verification against original sources.

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.

A highly actionable, executable reference with genuine verification feedback loops and no concept-explaining padding. Its main weaknesses are monolithic inline API documentation and a complete failure to surface the bundled scripts/, which keeps progressive disclosure at the middle anchor.

Suggestions

Document the bundled scripts (scripts/ingest_bq_events.py, scripts/init_investigation.py) in the body with a one-line 'Use when' and an invocation example so they are discoverable.

Move the per-collector method tables and BigQuery credential setup into references/ files (e.g. references/collectors.md, references/bigquery-setup.md) and keep the body as an overview with clearly signaled one-level-deep links.

Replace the truncated '678851b...' placeholder in Quick Start with a full example SHA so the snippet is fully copy-paste executable.

DimensionReasoningScore

Conciseness

The body is efficient — no padding explaining git, BigQuery, or pydantic; content is dominated by code and tables. Minor over-explanation exists (the long WorkflowRunEvent parenthetical caveat and the multi-step BigQuery credential walkthrough), which fits 'efficient; minor instances of over-explanation' rather than the lean 5 anchor.

4 / 5

Actionability

Code is copy-paste ready and covers the common cases (collect, store, filter, save/load, verify, IOC construction), but there are minor gaps: the truncated '678851b...' placeholder in Quick Start, and the bundled scripts/ingest_bq_events.py and scripts/init_investigation.py are never shown or run anywhere in the body. This fits 'mostly executable; concrete code with minor gaps', not the fully-executable 5 anchor.

4 / 5

Workflow Clarity

Quick Start shows a coherent collect → store → save → verify sequence with an explicit validation checkpoint (store.verify_all(), 'if not result.is_valid: print(f"Errors: {result.errors}")') — a real feedback loop for a batch operation. It falls short of 5 because the sequence is demonstrated only via example rather than as an explicit ordered workflow with per-source checkpoints, and exceeds 3 because validation is present and errors are surfaced.

4 / 5

Progressive Disclosure

Section structure is good, but scored against the actual bundle the disclosure is weak: the scripts/ directory (ingest_bq_events.py, init_investigation.py) is never referenced or discoverable from the body, no references/ files exist, and roughly 200 lines of collector API tables and BigQuery credential setup are inlined that clearly belong in separate files. This matches 'some structure; content that should be separate is inline; references present but not clearly signaled' rather than 4, since bundle files are entirely undocumented.

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: specific actions, explicit 'Use when' triggers, third-person voice, and a well-delineated niche. The only weakness is missing a few natural synonym terms (OSINT, deleted-content recovery, force-push forensics) that users would actually say.

Suggestions

Add natural synonym terms users would say, e.g. 'OSINT', 'recover deleted issues, PRs, or commits', and 'detect force-pushed commits', to improve trigger coverage.

Mention local-git forensic specifics (dangling commits, reflog) in the description since they are a headline capability of the skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('Generate, export, load, and verify forensic evidence', 'Handles evidence storage, querying, and re-verification') across named sources (GitHub API, GH Archive, Wayback Machine, local git, vendor reports), matching the comprehensive-coverage anchor. No minor coverage gaps are evident, so it does not fit the 4 anchor.

5 / 5

Completeness

Both 'what' (generate, export, load, verify, store, query evidence) and an explicit 'when' ('Use when creating verifiable evidence objects from GitHub API, GH Archive, Wayback Machine, local git repositories, or security vendor reports') are clearly stated with concrete trigger phrases, exactly matching the top anchor. Voice is third person throughout, so no penalty applies.

5 / 5

Trigger Term Quality

Good natural keyword coverage ('GitHub', 'local git repositories', 'security vendor reports', 'forensic evidence'), but common user phrasings like 'OSINT', 'recover deleted issues/PRs', and 'force push' are absent. This fits 'good keyword coverage; a few natural terms missing' better than 5 (no synonym sweep) or 3 (keywords are well beyond generic).

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — verifiable evidence objects from GitHub-related sources with re-verification against originals — with distinct triggers unlikely to fire for unrelated skills. No meaningful overlap with generic document or code skills is apparent.

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-evidence-kit/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.