# research

Has a background agent investigate a question against high-trust primary sources and save the cited findings as a Markdown file in your repo.

Skill by Matt Pocock. Category: Documents.

## Install

Project (for this project only):

```sh
npx skills add mattpocock/skills --skill research
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add mattpocock/skills --skill research -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 711055. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/mattpocock/skills/research)

## Source

[Open the source](https://github.com/mattpocock/skills/tree/HEAD/skills/engineering/research). Checked 2026-10-24. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: research
description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
---

Spin up a **background agent** to do the research, so you keep working while it reads.

Its job:

1. Investigate the question against **primary sources** (official docs, source code, specs, first-party APIs), not a secondary write-up of them. Follow every claim back to the source that owns it.
2. Write the findings to a single Markdown file, citing each claim's source.
3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.
````

- Previous: [to-tickets](https://syn4pse.dev/terminal/to-tickets.md)
- Next: [wizard](https://syn4pse.dev/terminal/wizard.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
