research-guide_skill

Overview

This skill produces focused research reports, best-practice guides, and library recommendations tailored to a project's tech stack and constraints. I analyze project files, formulate precise queries, run targeted web research, and synthesize findings into actionable reports you can use immediately. Reports include recommended libraries, implementation steps, compatibility notes, and references.

How this skill works

I start by inspecting the project context (package manifests, module files, folder structure) to identify language, frameworks, and constraints. Then I build a time-aware research query and run a depth-appropriate search to gather current guidance and source material. Finally I synthesize the results into a structured report with summary, recommended libraries, concrete best practices, step-by-step implementation guidance, and compatibility notes.

When to use it

• You need up-to-date best practices or implementation guidance for a specific technology.
• You want a short list of actively maintained libraries with trade-offs and integration notes.
• You are planning a migration or architectural change and need compatibility analysis.
• You need a testing, security, or performance strategy tailored to your stack.
• You want a ready-to-use report to include in project documentation or PRs.

Best practices

• Always analyze project files (package.json, go.mod, Cargo.toml, etc.) to match recommendations to existing dependencies.
• Include the current year in research queries to prioritize fresh guidance and recent breaking changes.
• Prioritize libraries updated within the last six months and note maintenance metrics (stars, recent commits).
• Assess bundle size, dependency count, and transitive risk when recommending client-side or runtime libs.
• Provide migration paths and concrete code snippets focused on the project’s framework and runtime.
• Cite sources and list compatibility notes for existing platform constraints (runtime, CI, deployment).

Example use cases

• Compare authentication approaches and libraries for a TypeScript backend using Hono and Bun.
• Choose a state management solution for a React 18 + TypeScript app with bundle size constraints.
• Design an API testing strategy for a Bun-based REST service with CI/CD integration.
• Evaluate ORM and database client options for a Rust or Go microservice and outline migration steps.
• Produce a security checklist and implementation guide for JWT, session handling, and token rotation.