Official agent skill

Research Agent

by aws-samples in aws-samples/sample-strands-agent-with-agentcore

Deep research with structured reports and charts. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

OfficialMITAuto-check passedResearch & Science

Install Research Agent

skills CLI
$ npx skills add aws-samples/sample-strands-agent-with-agentcore --skill research-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aws-samples/sample-strands-agent-with-agentcore research-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aws-samples/sample-strands-agent-with-agentcore.git skills-src && mkdir -p .claude/skills && cp -r skills-src/chatbot-app/agentcore/skills/research-agent .claude/skills/research-agent && rm -rf skills-src

Use ~/.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/

Facts

Skill name
research-agent
GitHub stars
195
Token cost
~1.1k tokens
SKILL.md length
492 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Deep research with structured reports and charts. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

  • The user explicitly requests research/analysis
  • SKILL.md covers When to use — ALL of these…, When NOT to use — default to…, How to invoke and Output, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Needs data visualization with charts

What it does

Research Agent is an agent skill from aws-samples/sample-strands-agent-with-agentcore, published by the product's own GitHub organization. Deep research with structured reports and charts. ONLY use when the user explicitly requests research/analysis, or needs data visualization with charts, or quantitative/comparative analysis across multiple sources. Do NOT use for simple questions or quick lookups.

Its SKILL.md is about 1.1k 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 and Data visualization. The repository describes itself as: Reference architecture for agentic AI chatbots with Strands Agents and Amazon Bedrock AgentCore. The licence is MIT.

When your agent uses it

  • The user explicitly requests research/analysis
  • Needs data visualization with charts
  • Quantitative/comparative analysis across multiple sources
  • Simple questions

Example prompts

  • “/research-agent”

What it can do on your machine

Read from SKILL.md and the folder at commit 6dd9d13. 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 Agent loads about 1.1k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 492 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

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 aws-samples/sample-strands-agent-with-agentcore at commit 6dd9d13, republished under its MIT licence (© aws-samples). 492 words, ~1,068 tokens.

Download SKILL.mdSave it as .claude/skills/research-agent/SKILL.md (or your agent's skills folder).
name
research-agent
description
Deep research with structured reports and charts. ONLY use when the user explicitly requests research/analysis, or needs data visualization with charts, or quantitative/comparative analysis across multiple sources. Do NOT use for simple questions or quick lookups.

Research Agent

Autonomous research agent that plans, searches across the web, synthesizes findings, and returns a structured markdown report with citations and charts.

When to use — ALL of these require explicit user intent or clear analytical need

  • The user explicitly asks for "research", "report", "analysis", "deep dive", or "investigate"
  • The user needs data visualization — charts, graphs, trend plots
  • Quantitative or comparative analysis across multiple data points (market sizing, benchmarking, statistical comparisons)
  • Multi-section structured reports (literature reviews, competitive analyses, technology surveys)

When NOT to use — default to simpler tools first

  • General conversation, Q&A, or factual questions — answer directly
  • A single lookup that wikipedia_search or google_web_search can resolve
  • Summarizing a single article or URL — use fetch_url_content instead
  • Code-related tasks — use the code-agent skill
  • Browser automation — use the browser-automation skill
  • Email, calendar, or other tool-based tasks — use the appropriate skill directly

Important: When in doubt, do NOT delegate to research-agent. Use google_web_search or other tools directly. Only escalate to research-agent when the task clearly requires multi-source synthesis, structured reporting, or chart generation.

How to invoke

Call the research_agent tool with a single plan argument. The plan is free-form prose; include:

  • Objectives — what the user is trying to learn or decide
  • Topics — the specific angles / subtopics to cover
  • Structure — the section layout you want in the final report

Example:

research_agent(plan="""
Research Plan: AI Code Assistant Market 2026

Objectives:
- Current market size and growth trends
- Leading products and differentiators
- Enterprise adoption barriers

Topics:
1. Global market statistics and forecasts
2. Top products (Copilot, Cursor, Claude Code, etc.) and positioning
3. Pricing models and enterprise SKUs
4. Security/compliance concerns raised by buyers

Structure:
- Executive Summary (3-5 bullets)
- Market Overview
- Product Landscape
- Enterprise Adoption
- Outlook
""")

The tool returns immediately with a started receipt containing job_id and artifact_id. Research continues in the background and emits research_step progress events. When it finishes, the report is saved as a research artifact and delivered back into the conversation automatically.

Output

  • Markdown report with #/## headings, bullet lists, and inline citations
  • Any charts the agent generated are embedded in the markdown
  • The full report is also persisted as an artifacts entry so the user can open it from the canvas
Show full SKILL.md (198 more words)Show less

Guidelines for the orchestrator

  • Don't fabricate the plan — use the user's own words and just structure them into objectives/topics/structure. If the user only gave a one-line request, expand it into 2-3 objectives but stay true to intent.
  • Split a broad request into parallel jobs only when the objectives are independent and each report is useful on its own (for example, separate market, technical, and regulatory analyses). Prefer 2-3 well-scoped jobs over many narrow searches.
  • Keep one job when the sections must share evidence, build on each other, or form one coherent report. Use one call per distinct objective and do not create duplicate jobs for the same objective.
  • If the user asks a follow-up ("add a section on X", "dig deeper into Y"), call research_agent again with an updated plan — the agent itself does not have persistent memory across calls.
  • Treat a started receipt as accepted background work, not a completed report. Tell the user it has started and continue with any other useful work.
  • When the completion is delivered, do NOT restate the whole report in chat. The report is already rendered as an artifact; a 1-2 sentence summary pointing the user to the canvas is enough.

© aws-samples, 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 chatbot-app/agentcore/skills/research-agent of aws-samples/sample-strands-agent-with-agentcore.

Open the folder on GitHubat commit 6dd9d13

Compare with similar skills

Research Agent 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.

Research Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Agent this skillaws-samples/sample-strands-agent-with-agentcore195—~1.1kAutomated safety check: PassMIT
Nature-Style Scientific FiguresYuan1z0825/nature-skills46k—~2.9kAutomated safety check: PassApache-2.0
Engineering Figure Agentheyu-233/engineering-figure-agent305—~1.1kAutomated safety check: PassMIT
Scientific Figure GeneratorDeepshare-Official/CCF-Figure225—~1.8kAutomated safety check: PassMIT
Scanpy Single-Cell Analysisdavila7/claude-code-templates32k16 repos~2.8kAutomated safety check: PassMIT
deepTools NGS Toolkitdavila7/claude-code-templates32k13 repos~4.5kAutomated safety check: PassMIT

Similar skills

  • Nature-Style Scientific Figures

    Yuan1z0825/nature-skills

    Creates, revises, audits and exports manuscript-ready scientific figures in Python or R, and routes AI-generated graphical abstracts to a separate workflow.

    46k GitHub stars~2.9k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Engineering Figure Agent

    heyu-233/engineering-figure-agent

    A skill your agent uses when the user needs engineering or research-paper figures: system architecture diagrams, algorithm workflows, hardware schematics, benchmark charts, ablation plots, figure…

    305 GitHub stars~1.1k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed
  • Scientific Figure Generator

    Deepshare-Official/CCF-Figure

    Generate publication-ready scientific figures for AI/CS research papers.

    225 GitHub stars~1.8k tokensUpdated 3 mo ago
    Research & ScienceAuto-check passed
  • Scanpy Single-Cell Analysis

    davila7/claude-code-templates

    Walks through single-cell RNA-seq analysis with Scanpy: loading .h5ad and 10X data, QC, normalization, PCA and UMAP, Leiden clustering, marker genes and cell type annotation.

    32k GitHub starsUsed in 16 repos~2.8k tokens
    Research & ScienceAuto-check passed
  • deepTools NGS Toolkit

    davila7/claude-code-templates

    Guides use of deepTools on sequencing data: BAM to bigWig conversion, QC, sample correlation, and heatmaps or profiles around TSS and peaks for ChIP-seq, RNA-seq and ATAC-seq.

    32k GitHub starsUsed in 13 repos~4.5k tokens
    Research & ScienceAuto-check passed
  • FBA Flux Analyzer

    aiming-lab/AutoResearchClaw

    Turns raw flux balance analysis output and a COBRApy model into gene essentiality maps, phenotypic phase planes, flux sampling results, pathway summaries and secretion predictions.

    15k GitHub stars~2.3k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed

More from aws-samples/sample-strands-agent-with-agentcore

All 24 skills in this repo
  • Doc Coauthoring

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Guide users through a structured workflow for co-authoring documentation.

    195 GitHub starsUsed in 40 repos~3.2k tokens
    Auto-check passed
  • Code Interpreter

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Test and prototype code in a sandboxed environment. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

    195 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Workspace

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Read and write files in the shared session workspace. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

    195 GitHub stars~721 tokensUpdated 2 days ago
    Auto-check passed
  • Code Agent

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Autonomous coding agent. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

    195 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Delegate Work

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Delegate one independent, context-heavy task to an isolated asynchronous analyst or reviewer.

    195 GitHub stars~610 tokensUpdated 2 days ago
    Auto-check passed
  • Excalidraw

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Create hand-drawn style diagrams and flowcharts using Excalidraw

    195 GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed

Questions about Research Agent

What does Research Agent do?

Deep research with structured reports and charts. An agent skill from aws-samples/sample-strands-agent-with-agentcore. Research Agent is an agent skill from aws-samples/sample-strands-agent-with-agentcore, published by the product's own GitHub organization. Deep research with structured reports and charts.

When should I use Research Agent?

Research Agent fits situations like: the user explicitly requests research/analysis; needs data visualization with charts; quantitative/comparative analysis across multiple sources; simple questions.

How do I install Research Agent in Claude Code?

Run `npx skills add aws-samples/sample-strands-agent-with-agentcore --skill research-agent -a claude-code`. Or copy the skill folder (chatbot-app/agentcore/skills/research-agent in aws-samples/sample-strands-agent-with-agentcore) into .claude/skills/research-agent in your project. Claude Code loads it when a task matches its description.

How do I install Research Agent in Codex?

Run `npx skills add aws-samples/sample-strands-agent-with-agentcore --skill research-agent -a codex`. Or copy the skill folder (chatbot-app/agentcore/skills/research-agent in aws-samples/sample-strands-agent-with-agentcore) into .agents/skills/research-agent in your project. Codex loads it when a task matches its description.

Can I use Research Agent 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 aws-samples/sample-strands-agent-with-agentcore --skill research-agent -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-agent, .gemini/skills/research-agent, .github/skills/research-agent and .opencode/skills/research-agent in your project.

What does Research Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: Research Agent is instructions for the agent only.

Does Research Agent 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 Agent 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 Agent use?

Research Agent is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Research Agent use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Agent?

Skills that share tags, products or a category with Research Agent: Nature-Style Scientific Figures (Yuan1z0825/nature-skills, 46k stars), Engineering Figure Agent (heyu-233/engineering-figure-agent, 305 stars), Scientific Figure Generator (Deepshare-Official/CCF-Figure, 225 stars) and Scanpy Single-Cell Analysis (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Agent?

aws-samples (a GitHub organization, an official publisher) maintains it in aws-samples/sample-strands-agent-with-agentcore, which has 195 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 6, 2026.

Source: aws-samples/sample-strands-agent-with-agentcore on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.