CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

github-deep-research

Conduct multi-round deep research on any GitHub Repo. Use when users request comprehensive analysis, timeline reconstruction, competitive analysis, or in-depth investigation of GitHub. Produces structured markdown reports with executive summaries, chronological timelines, metrics analysis, and Mermaid diagrams. Triggers on Github repository URL or open source projects.

65

Quality

82%

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

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

Well-structured, actionable content: a clear four-round workflow, executable API commands, query templates, and enforced citation practices, with real one-level-deep bundle references. The main headroom is embedding verification checkpoints into the round sequence and moving the report-outline/Mermaid detail into the existing template asset.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanations of known concepts — but the three full Mermaid example blocks and the 'Bad - Without citations' block (which duplicates the 'Good' one minus citations) are tokens that could be trimmed. Mostly efficient with minor over-elaboration, matching anchor 4.

4 / 5

Actionability

Provides copy-paste-ready commands ('python /path/to/skill/scripts/github_api.py <owner> <repo> summary'), literal per-round query templates, an output filename convention, and a concrete citation format. Not 5 because the script path is a placeholder and Rounds 2-4 items ('Get overview and identify key terms') are directives rather than executable steps.

4 / 5

Workflow Clarity

Four research rounds are clearly sequenced with per-round scope and search counts ('3-5 web_search', '5-10 web_search + web_fetch'). Verification guidance exists ('Verify dates from commits/PRs', 'Triangulate claims - 2+ independent sources') but sits in Best Practices rather than as explicit checkpoints in the workflow, so it matches anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Both bundle references are real files, one level deep, and clearly signaled ('Follow template in assets/report_template.md'; the script invoked with concrete commands). Minor gaps: the 9-section report outline and Mermaid examples inline content that largely belongs in the template, and references are plain paths rather than links — anchor 4, not the fully split-and-signaled anchor 5.

4 / 5

Total

16

/

20

Passed

Description

83%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: third-person voice, explicit 'Use when' and 'Triggers on' clauses, and specific named deliverables. It would reliably fire on GitHub-research requests, with only minor gains available from adding natural trigger synonyms and tightening abstract phrases like 'deep research'.

DimensionReasoningScore

Specificity

Names concrete deliverables ('executive summaries, chronological timelines, metrics analysis, and Mermaid diagrams', 'timeline reconstruction', 'competitive analysis') alongside the core action. Not 5 because the central phrases 'multi-round deep research' and 'comprehensive analysis' remain abstract and the description omits how the research is conducted.

4 / 5

Completeness

Explicitly answers both questions: a clear multi-part 'what' ('Conduct multi-round deep research... Produces structured markdown reports with executive summaries...') and an explicit 'when' ('Use when users request... Triggers on Github repository URL or open source projects') with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Includes several natural trigger phrases ('comprehensive analysis', 'competitive analysis', 'in-depth investigation', 'Github repository URL', 'open source projects'). Not 5 because common variations users would say — e.g. 'analyze this repo', 'project history', 'compare X vs Y' — are missing.

4 / 5

Distinctiveness Conflict Risk

Clearly niched to GitHub repository research with distinct triggers, but 'open source projects' is broad and could overlap with general research or contribution-focused skills. Minor overlap risk, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

bytedance/deer-flow

Path

skills/public/github-deep-research/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.