research

Delegates research questions to an isolated agent and produces cited Markdown reports.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Fatih0234/mattpocock-skills-pi --skill research-fatih0234
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research
Source: https://github.com/Fatih0234/mattpocock-skills-pi/tree/main/skills/engineering/research
Command: npx skills add https://github.com/Fatih0234/mattpocock-skills-pi --skill research-fatih0234

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the burden of doing deep documentation and API research inside your main working session, where long reading pollutes context and uncited claims slip through. It delegates the investigation to an isolated agent and delivers a verified, citation-backed Markdown report in your repository. ## Core Features & Use Cases - Isolated Research Delegation: Dispatches the question to a Pi researcher subagent in a fresh context so the reading legwork stays out of your main session. - Primary-Source Citations: Requires every material claim to cite official documentation, source code, specifications, or first-party APIs. - Write-Scope Enforcement: Captures git status before and after delegation to guarantee the agent only writes its assigned scratch artifact, then promotes the validated report to a final path. - Use Case: Ask whether a library version supports a specific API feature; the skill returns a Markdown file in your repo answering the question with links to the official docs and source code. ## Quick Start Ask the agent to research how a specific library or API feature works and save the cited findings as a Markdown file in the repository.

Frequently Asked Questions about research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I delegate research to an isolated agent?▼

Invoke the skill with a clear research question and the decision it informs. It creates a scratch directory, dispatches the Pi researcher subagent with a fresh context, and waits synchronously for the cited Markdown artifact to be written.

What sources does the research agent use?▼

The researcher investigates primary sources only: official documentation, source code, specifications, and first-party APIs. Every material factual claim in the final report must include a citation to the source that owns it.

What happens if the subagent tool is unavailable?▼

The skill falls back to performing the same research in the current session and writes the final artifact directly. It discloses that the research was not context-isolated so you know the caveat.

How does the skill prevent unwanted file changes?▼

It captures git status before delegation and compares it afterward. The only new path allowed is the assigned scratch artifact; any unexpected change stops the workflow and gets reported before anything is promoted.

Where does the final research report get saved?▼

The parent agent promotes the validated scratch artifact to a final path matching the repository's existing research-notes convention, or a sensible stated path if none exists. The parent performs this write so existing documents are never silently replaced.