research

Investigates questions against primary sources and writes cited findings to Markdown files.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/CYRUS-pinto/pi-bot --skill research-cyrus-pinto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research
Source: https://github.com/CYRUS-pinto/pi-bot/tree/main/.agents/skills/research
Command: npx skills add https://github.com/CYRUS-pinto/pi-bot --skill research-cyrus-pinto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Getting trustworthy answers about a topic, API, or library usually means interrupting your own work to dig through documentation and source code. This Skill delegates that reading legwork to a background agent so you keep working while the research happens in parallel. ## Core Features & Use Cases - Primary-source investigation: Follows every claim back to official docs, source code, specs, or first-party APIs rather than secondary write-ups. - Cited Markdown reports: Writes findings to a single Markdown file with a source citation for each claim. - Convention-aware storage: Saves the report where the repo already keeps such notes, matching existing conventions. - Use Case: Ask how a specific API endpoint handles rate limits; a background agent reads the official docs and source, then drops a cited Markdown summary into your repo while you continue coding. ## Quick Start Ask the agent to research how a specific library or API feature works and save the findings as a Markdown note in the repo.

Frequently Asked Questions about research

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

FAQPage Schema
How do I research a topic using a background agent?

Invoke the research skill with your question, and it spins up a background agent that investigates primary sources while you keep working. The agent writes its findings to a cited Markdown file in your repo when finished.

What sources does the research agent use for answers?

The agent relies on primary sources: official documentation, source code, specifications, and first-party APIs. It follows every claim back to the source that owns it rather than trusting secondary write-ups or blog posts.

Where does the research output get saved?

Findings are written to a single Markdown file saved where the repo already keeps such notes, matching existing conventions. If no convention exists, the agent picks a sensible location and tells you where it saved the file.

Can I keep working while the research runs?

Yes. The skill is explicitly designed to run as a background agent, so your main session stays free for other tasks. The research completes independently and the report appears in the repo when done.

When should I not use a background research agent?

Avoid it for quick factual lookups you can answer immediately or when you need interactive back-and-forth to refine the question. It works best for self-contained investigations requiring substantial reading across docs or source code.