researching-best-practices

Researches industry best practices across multiple sources and produces a verified synthesis with codebase gap analysis.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/hpark0011/mirror --skill researching-best-practices-hpark0011
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: researching-best-practices
Source: https://github.com/hpark0011/mirror/tree/main/.agents/skills/researching-best-practices
Command: npx skills add https://github.com/hpark0011/mirror --skill researching-best-practices-hpark0011

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Before speccing or implementing a feature, teams often guess at best practices or rely on a single blog post. This Skill runs structured, multi-source research and compares findings against your actual codebase, so decisions rest on verified evidence rather than assumptions. ## Core Features & Use Cases - Parallel multi-source research: Spawns four research sub-agents (open source projects, official documentation, social/practitioner content, academic papers) plus a codebase analyst in a single parallel batch. - Verification and synthesis: A dedicated verification agent critiques each researcher's output, requests at most one round of fixes, and merges findings into a ranked, fully cited synthesis. - Gap analysis report: Compares best practices against the current codebase and writes a structured markdown report to workspace/research/, covering alignment, divergences, and absences. - Use Case: Before building streaming chat responses with backpressure, run this Skill to see how popular OSS projects, official docs, practitioners, and research papers handle it, then get a gap analysis of what your current chat implementation is missing. ## Quick Start Ask the agent to research best practices for a specific feature, for example: research best practices for streaming LLM responses with backpressure and compare against our current chat implementation.

Frequently Asked Questions about researching-best-practices

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

FAQPage Schema
How do I research best practices for a feature before implementing it?▼

Invoke the Skill with a clear feature topic, context, and scope. It spawns four research sub-agents covering open source, official docs, social sources, and academic papers, plus a codebase analyst, then a verification agent synthesizes everything into a cited report.

What sources does best-practices research cover?▼

Four parallel lanes: open source project implementations, official framework and library documentation, practitioner content from blogs and social platforms, and peer-reviewed or preprint academic papers. A fifth agent analyzes your own codebase for comparison.

Does this Skill generate a product spec or implementation plan?▼

No. It stops at the research synthesis and gap analysis report written to workspace/research/. For FR/NFR tables, test plans, and orchestration, hand the report off to the create-spec Skill afterward.

When should I not use multi-agent best-practices research?▼

Skip it for trivial one-file questions like how a single API works, since five sub-agents are overkill. Also avoid vague briefs like research our auth; narrow the topic first or the report will be unfocused and rejected.

How are research findings verified before the final report?▼

A verification agent critiques each researcher's output for unsupported claims, stale sources, and missing trade-offs. Each researcher gets at most one revision round-trip; claims that still lack citations are dropped from the final synthesis.