reference-research

Searches a curated references catalog and synthesizes external sources into actionable patterns.

Updated Aug 29, 2026
One-click install
npx skills add https://github.com/1arley/volibear --skill reference-research-1arley
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reference-research
Source: https://github.com/1arley/volibear/tree/main/.opencode/skills/reference-research
Command: npx skills add https://github.com/1arley/volibear --skill reference-research-1arley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting a non-trivial task, agents often reinvent solutions or produce shallow link lists instead of grounded research. This Skill teaches the agent to consult a centralized references catalog, select relevant external sources by type and authority, and synthesize findings into actionable patterns with explicit recommendations. ## Core Features & Use Cases - Catalog-driven discovery: Matches the problem against use_when and avoid_when fields in references/*.yaml files, prioritized by source authority (established > vendor > community > curated). - Knowledge-type classification: Distinguishes methodology, heuristic, inspiration, implementation, and discovery sources so each is used appropriately rather than copied blindly. - Structured synthesis output: Produces per-source blocks covering the relevant pattern, why it matters, adaptation guidance, trade-offs, and a recommendation, with confidence levels from CONFIRMED to SPECULATIVE. - Use Case: Before designing an authentication flow, the agent consults the security and UX reference catalogs, extracts principles from OWASP and Laws of UX, and delivers an adapted recommendation with trade-offs instead of a raw link list. ## Quick Start Ask the agent to research how others have solved this problem using the reference catalog and synthesize actionable patterns before starting implementation.

Frequently Asked Questions about reference-research

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

FAQPage Schema
How do I research existing solutions before starting a coding task?▼

Consult the references catalog first by matching your problem domain against each source's use_when field. Select sources by authority, extract patterns and trade-offs rather than copying code, and synthesize findings into a structured recommendation.

What types of reference sources should I use for design decisions?▼

The catalog classifies sources as methodology, heuristic, inspiration, implementation, or discovery. Use methodologies like Laws of UX or OWASP as foundations, inspiration sources only to calibrate taste, and implementation sources as code references to adapt.

How are reference sources ranked by credibility?▼

Sources carry an authority field ranked established, vendor, community, then curated. Established and vendor sources should back critical decisions, while community and curated sources are useful but insufficient alone for high-stakes choices.

When should I skip reference research entirely?▼

Skip research for trivial tasks like a simple button, following the proportionality principle. Research is warranted for non-trivial architecture, UX, animation, or security tasks where prior solutions meaningfully inform the approach.

What if the reference catalog has no relevant sources?▼

Dispatch to discovery-type sources such as LazyWeb, Shoogle, or Hacker News to find new material, then route to github-reference-research, market-research, or implementation-research skills for deeper investigation.