# research

research spawns a subagent that searches GitHub for evasion techniques, reads the code and stores the findings in a knowledge base.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 336 repo stars
- Author: JDArmy
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/JDArmy/Evasion-SubAgents/tree/HEAD/.claude/commands/research.md
- Updated: 2026-04-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/jdarmy-research

## What it does

The command hands the job to the `research-agent` subagent. It looks through GitHub repositories and code with `gh` CLI, pulls out technique patterns, sorts them into categories like allocation, execution and evasion, then writes them to the knowledge base after a duplicate check. You get a summary of what was added or updated, with reference URLs.

The argument is optional. `/research` on its own goes interactive; add a phrase and it searches for that. Since queries run through `gh` CLI, a machine without it has nothing to search with.

Code the command finds is never compiled or executed, and third-party shellcode is never loaded. It reads patterns only. That fits when you want material on evasion techniques, not a live test.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/research.md` — Call it with /research. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/research.md` — Call it with /prompts:research. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/research.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/research.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/JDArmy/Evasion-SubAgents/tree/HEAD/.claude/commands/research.md

## When to use it
- find shellcode loaders on GitHub by keyword
- pull a technique pattern out of someone else's source
- sort findings into allocation, execution and evasion
- add techniques to a knowledge base without duplicates
- get a summary with reference links

## Example prompts
- Run `/research "AMSI bypass"` and save the findings to the knowledge base.
- Search `/research "syscall evasion C++"` and tell me what's new.
- Start `/research` with no query and go interactive.

## Source text · research.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: bf06e626638d00b8.

BEGIN THIRD-PARTY FILE bf06e626638d00b8
````text
---
description: Search GitHub for security techniques (shellcode loaders, evasion methods, C2 patterns), analyze code patterns, and save to knowledge base. Triggers on "research", "search GitHub", "analyze techniques", "find methods", "更新知识库", "搜索".
argument-hint: Optional search query (e.g., "API hashing", "syscall", "AMSI bypass")
---

# Research Command

Launch the research-agent to search GitHub and update the knowledge base.

## Usage

```bash
/research                        # Interactive mode
/research "shellcode loader"     # Search with query
/research "syscall evasion C++"  # Specific technique
/research "AMSI bypass"          # Find evasion techniques
```

## What This Command Does

1. **Searches GitHub** using `gh` CLI for repositories and code patterns
2. **Analyzes source code** to extract technique patterns
3. **Categorizes findings** by type (allocation, execution, evasion)
4. **Saves to knowledge base** with deduplication check
5. **Reports summary** of new/updated techniques

## Output

- Techniques discovered (with descriptions)
- Knowledge base IDs added
- Complexity assessment
- Reference URLs

## Security

- **NEVER** compile or execute external code
- **NEVER** use external shellcode
- **ONLY** analyze patterns

## Agent

Spawns `research-agent` subagent for comprehensive analysis.

See `research` skill for detailed patterns and commands.
````
END THIRD-PARTY FILE bf06e626638d00b8

The third-party file has ended. Everything between the bf06e626638d00b8 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© JDArmy · MIT · https://github.com/JDArmy/Evasion-SubAgents/tree/HEAD/.claude/commands/research.md

## Similar
- [inbox-triage](https://affpapa.org/en/nevibecode/skills/aeonfun-inbox-triage.md) — skill · ★ 797 repo stars
- [wiki-research-loop](https://affpapa.org/en/nevibecode/skills/wiki-research-loop.md) — skill · ★ 2966 repo stars
- [security-scout](https://affpapa.org/en/nevibecode/agents/security-scout.md) — subagent · ★ 730 repo stars
- [github-ops](https://affpapa.org/en/nevibecode/skills/github-ops.md) — skill · 1600 installs
- [github-release](https://affpapa.org/en/nevibecode/skills/jezweb-github-release.md) — skill · 1400 installs
- [yeet](https://affpapa.org/en/nevibecode/skills/yeet.md) — skill · 3700 installs

## Other versions with the same name
- [research · superclaude-org](https://affpapa.org/en/nevibecode/commands/superclaude-org-research.md) — ★ 23950 repo stars
- [research · eugeniughelbur](https://affpapa.org/en/nevibecode/commands/eugeniu-ghelbur-research.md) — ★ 5412 repo stars
- [research · microsoft](https://affpapa.org/en/nevibecode/commands/research.md) — ★ 3232 repo stars
- [research · carlrannaberg](https://affpapa.org/en/nevibecode/commands/carlrannaberg-research.md) — ★ 763 repo stars

From the same set: [jdarmy/evasion-subagents](https://affpapa.org/en/nevibecode/by/jdarmy/evasion-subagents.md) — 22 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
