GitHub Deep Research
bytedance/deer-flow
Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.
Research a topic on the open web and write a cited Markdown report.
Install Research Report
$ npx skills add amd/gaia --skill research-report -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install amd/gaia research-report --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .claude/skills && cp -r skills-src/hub/skills/research-report .claude/skills/research-report && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "research-report" agent skill from https://github.com/amd/gaia/tree/main/hub/skills/research-report into .claude/skills/research-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-report", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/amd/gaia/tree/main/hub/skills/research-reportType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add amd/gaia --skill research-report -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install amd/gaia research-report --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .agents/skills && cp -r skills-src/hub/skills/research-report .agents/skills/research-report && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "research-report" agent skill from https://github.com/amd/gaia/tree/main/hub/skills/research-report into .agents/skills/research-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-report", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add amd/gaia --skill research-report -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install amd/gaia research-report --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/hub/skills/research-report .cursor/skills/research-report && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "research-report" agent skill from https://github.com/amd/gaia/tree/main/hub/skills/research-report into .cursor/skills/research-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-report", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/amd/gaia.git --path hub/skills/research-report--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add amd/gaia --skill research-report -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install amd/gaia research-report --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/hub/skills/research-report .gemini/skills/research-report && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "research-report" agent skill from https://github.com/amd/gaia/tree/main/hub/skills/research-report into .gemini/skills/research-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-report", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install amd/gaia research-reportInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add amd/gaia --skill research-report -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .github/skills && cp -r skills-src/hub/skills/research-report .github/skills/research-report && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "research-report" agent skill from https://github.com/amd/gaia/tree/main/hub/skills/research-report into .github/skills/research-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-report", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add amd/gaia --skill research-report -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install amd/gaia research-report --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/hub/skills/research-report .opencode/skills/research-report && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "research-report" agent skill from https://github.com/amd/gaia/tree/main/hub/skills/research-report into .opencode/skills/research-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-report", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
research-report- GitHub stars
- 1.6k
- Token cost
- ~620 tokens
- SKILL.md length
- 286 words
- Files
- 1
- Skills in repo
- 44
- Repo updated
- First seen
- Licence
- MIT
At a glance
Research a topic on the open web and write a cited Markdown report.
- Works in 5 steps: Decompose. Restate the topic as 3–5… → Search each sub-question with… → Read the best sources. For the 2–3 most… → …
- The user asks for a report
- SKILL.md covers Procedure, When the answer must outlive…, Notes and Fork this
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Research Report is an agent skill from amd/gaia. Research a topic on the open web and write a cited Markdown report. Use when the user asks for a report, a literature scan, a competitive landscape, or a "what's the current state of X" answer that needs sources.
Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Research & Science, covering Deep research. The repository describes itself as: Build AI agents for your PC. The licence is MIT.
When your agent uses it
- The user asks for a report
- A literature scan
- A competitive landscape
- A whats the current state of X answer that needs sources
Example prompts
- “s the current state of X”
- “/research-report”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Decompose. Restate the topic as 3–5 sub-questions that together answer it.
- Search each sub-question with search_web(query, num_results=5). Use a
- Read the best sources. For the 2–3 most promising results per
- Write the report with this shape
- Deliver as Markdown in the reply.
What it can do on your machine
Read from SKILL.md and the folder at commit 6c3bb5c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Research Report loads about 620 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 286 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from amd/gaia at commit 6c3bb5c, republished under its MIT licence (© amd). 286 words, ~620 tokens.
Download SKILL.mdSave it as
.claude/skills/research-report/SKILL.md (or your agent's skills folder).- name
- research-report
- description
- Research a topic on the open web and write a cited Markdown report. Use when the user asks for a report, a literature scan, a competitive landscape, or a "what's the current state of X" answer that needs sources.
- license
- MIT
- version
- 1.0.0
Research Report
Turn one broad question into a sourced Markdown report. The value is in the decomposition — a single search rarely answers a real research question.
Procedure
- Decompose. Restate the topic as 3–5 sub-questions that together answer it. Show them to the user before searching so they can redirect you early.
- Search each sub-question with
search_web(query, num_results=5). Use a different phrasing per sub-question; do not reuse the user's wording verbatim for all of them. - Read the best sources. For the 2–3 most promising results per
sub-question, call
fetch_page(url)to get the actual text. Never cite a page you only saw as a search snippet. - Write the report with this shape:
- One-paragraph answer to the original question, up front.
- One section per sub-question.
- Every non-obvious claim followed by an inline
[source](url)link. - A "What I could not confirm" section — say so when the web disagreed or went quiet. An honest gap beats a confident guess.
- Deliver as Markdown in the reply.
When the answer must outlive the session
If the user wants to keep querying the material later, save each fetched page
with write_file(file_path, content) and index_document(file_path) it. After
that query_documents answers follow-ups from the indexed corpus instead of
re-fetching the web.
Notes
search_webuses DuckDuckGo. It is rate-limited and occasionally returns nothing; if a query comes back empty, rephrase once, then say so rather than inventing results.- Prefer primary sources (documentation, filings, the project's own site) over aggregators.
Fork this
Point it at a domain and it becomes a specialist: change the sub-question template in step 1 to your field's standard questions (for a competitor scan: pricing, positioning, recent launches, public complaints), and pin step 2 to the sites you trust.
© amd, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in hub/skills/research-report of amd/gaia.
Open the folder on GitHubat commit 6c3bb5c
Compare with similar skills
Research Report next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Research Report this skillamd/gaia | 1.6k | — | ~620 | Automated safety check: Pass | MIT | |
| GitHub Deep Researchbytedance/deer-flow | 83k | 5 repos | ~1.3k | Automated safety check: Pass | MIT | |
| Deep Research WorkflowTokenRhythm/opensquilla | 7.1k | — | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| X Researchrohunvora/x-research-skill | 1.2k | 1 repos | ~1.6k | Automated safety check: Pass | None | |
| Deep Researchsanjay3290/ai-skills | 430 | 10 repos | ~683 | Automated safety check: Notes | Apache-2.0 | |
| ResearchWeizhena/Deep-Research-skills | 2.3k | 3 repos | ~1.1k | Automated safety check: Pass | MIT |
Similar skills
Deep Research Workflow
TokenRhythm/opensquilla
Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.
X Research
rohunvora/x-research-skill
General-purpose X/Twitter research agent. An agent skill from rohunvora/x-research-skill.
Deep Research
sanjay3290/ai-skills
Execute autonomous multi-step research using Google Gemini Deep Research Agent.
Research
Weizhena/Deep-Research-skills
Conduct preliminary research on a topic and generate research outline.
Horizontal-Vertical Deep Research
KKKKhazix/khazix-skills
Runs a two-axis deep research method on a product, company, concept or person: its full history over time, compared with peers today, delivered as a typeset PDF report.
More from amd/gaia
All 44 skills in this repoGAIA Agent Eval Scorecard
amd/gaia
Adds a release eval scorecard to a GAIA hub agent by writing a harness adapter, running a real eval, and wiring the result into the agent's README and release gate.
GAIA Sidecar Agent Release
amd/gaia
Walks through releasing a GAIA sidecar agent as a frozen binary plus npm client through the tag-triggered Agent Hub CI pipeline, with a human gate before publishing.
Analyzing Claude Code Sessions
amd/gaia
Mines local Claude Code session transcripts with a deterministic Python pipeline to show what the agent is actually used for, how often it fails and what it costs.
GAIA Agent Benchmarking
amd/gaia
Benchmarks AMD's GAIA agent against Claude Code and across models on quality, honesty, steps, tokens, time and real cost, using gaia eval tasks.
Verified Coding Workflow
amd/gaia
Guides safe code changes by finding the right file with grep or semantic search, reading before editing, reproducing bugs first, and proving a fix with a real test run.
GAIA Agent Builder
amd/gaia
Walks through scaffolding, writing and testing a new GAIA agent as a Python class with the SDK, from the base Agent subclass to registered tool methods.
Related
Categories
Questions about Research Report
What does Research Report do?
Research a topic on the open web and write a cited Markdown report. Research Report is an agent skill from amd/gaia. Research a topic on the open web and write a cited Markdown report.
When should I use Research Report?
Research Report fits situations like: the user asks for a report; A literature scan; A competitive landscape; A whats the current state of X answer that needs sources.
How do I install Research Report in Claude Code?
Run `npx skills add amd/gaia --skill research-report -a claude-code`. Or copy the skill folder (hub/skills/research-report in amd/gaia) into .claude/skills/research-report in your project. Claude Code loads it when a task matches its description.
How do I install Research Report in Codex?
Run `npx skills add amd/gaia --skill research-report -a codex`. Or copy the skill folder (hub/skills/research-report in amd/gaia) into .agents/skills/research-report in your project. Codex loads it when a task matches its description.
Can I use Research Report in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add amd/gaia --skill research-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research-report, .gemini/skills/research-report, .github/skills/research-report and .opencode/skills/research-report in your project.
What does Research Report need to run?
SKILL.md names no scripts, command-line tools or credentials: Research Report is instructions for the agent only.
Does Research Report access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Research Report safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Research Report use?
Research Report is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Research Report use?
About 620 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Research Report?
Skills that share tags, products or a category with Research Report: GitHub Deep Research (bytedance/deer-flow, 83k stars), Deep Research Workflow (TokenRhythm/opensquilla, 7.1k stars), X Research (rohunvora/x-research-skill, 1.2k stars) and Deep Research (sanjay3290/ai-skills, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Research Report?
amd (a GitHub organization) maintains it in amd/gaia, which has 1,580 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 6, 2026.
Source: amd/gaia on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.