Skip to content

README.md

Latest commit

 

History

History
92 lines (65 loc) · 3.21 KB

README.md

File metadata and controls

92 lines (65 loc) · 3.21 KB
Raw

research-stack: question → route → context7 / tavily / firecrawl → cited answer

research-stack

A general-purpose research skill for coding agents.
One routed path across context7, tavily, and firecrawl — pick the right tool, bound its cost, cite the source.

MIT Skill format Agents

Why

Agents with three research MCP servers tend to call the wrong one, call it unbounded, and forget to cite. This skill fixes the process, not the tools:

Step What the agent does
Load One ToolSearch for exactly the tools the route needs
Route Match the question to a tool via a single table, with a fallback per row
Bound Set the cost ceiling on every call before issuing it
Refund Claim the firecrawl search-feedback credit
Deliver A cited chat answer, or one Markdown research file from primary sources

Done means every claim traces to a source URL or library ID, and no call was made that the route did not pick.

Install

Claude Code (personal skill, available in every project):

git clone https://github.com/PyModel/research-stack-skill.git ~/.claude/skills/research-stack

Project-scoped instead: clone into <repo>/.claude/skills/research-stack.

Other agents (Codex, Cursor, pi, any SKILL.md-aware host): drop the folder wherever that host reads skills, or point the agent at SKILL.md.

Requirements

Three MCP servers connected to the agent, under these tool prefixes:

Server Prefix Get it
Context7 mcp__context7__* https://github.com/upstash/context7
Tavily mcp__tavily__* https://github.com/tavily-ai/tavily-mcp
Firecrawl mcp__firecrawl__* https://github.com/firecrawl/firecrawl-mcp-server

Any subset works; the route table's fallback column covers a missing server.

Layout

research-stack/
├── SKILL.md                      # the skill: load → route → bound → refund → deliver
├── references/
│   └── costs-and-limits.md       # credit tables, rate limits, deployment deltas, sources
└── assets/
    └── research-stack.svg

SKILL.md is what the agent runs. references/ is loaded only when the agent needs to justify a tool choice on cost or cite a claim.

Triggers

The skill fires when a question needs facts from outside the repo:

  • library / SDK docs, a version-specific behavior
  • current events, "latest", a comparison across sources
  • the contents of a known URL, or which pages of a site matter
  • a known bug, error message, or API contract
  • or when the agent is unsure which of the three servers fits

Contributing

Pricing and rate limits drift. If a figure in references/costs-and-limits.md is stale, open a PR with the vendor source that supersedes it.

License

MIT