How should I name the topic file?

Use kebab-case for the filename (e.g., my-topic.md) and include a date field in the frontmatter as defined by the frontmatter schema.

Where are findings stored?

Saved in .lore/research/[topic].md, formatted with the documented frontmatter and a structured document layout.

How are sources cited?

List sources in the Sources section with links to the original docs or resources.

Research

npx machina-cli add skill rjroy/vibe-garden/research --openclaw

Files (1)

SKILL.md

1.7 KB

Research

Gather context from outside the project scope.

When to Use

Exploring external documentation or APIs
Finding prior art or existing solutions
Understanding libraries, frameworks, or tools
Gathering reference material

Process

Clarify what the user wants to research if unclear
Use web search, fetch docs, or read external resources
Synthesize findings into a research document
Save to .lore/research/

Output

Save findings to .lore/research/[topic].md

Use kebab-case for filenames. Use the date: frontmatter field for time-sensitive research.

Document Structure

Before writing: Load ${CLAUDE_PLUGIN_ROOT}/shared/frontmatter-schema.md to get frontmatter field definitions and status values for research.

---
[frontmatter per schema]
---

# Research: [Topic]

## Summary
Brief overview of what was found.

## Key Findings
- Finding 1
- Finding 2

## Sources
- [Source name](url)

## Notes
Any additional context or observations.

Context

Check .lore/brainstorm/ for related ideas that prompted this research.

Specialized Agents

If .lore/lore-agents.md exists, consult it for specialized agents that can help focus research. Domain experts can identify what's worth investigating and what to prioritize. Invoke relevant agents via Task tool and incorporate their insights.

Source

git clone https://github.com/rjroy/vibe-garden/blob/main/lore-development/skills/research/SKILL.mdView on GitHub

Overview

The Research skill pulls context from sources outside the current project to fill knowledge gaps. It helps you explore external documentation, APIs, libraries, or prior art, and then organizes findings into a reusable research document saved under .lore/research/. The process respects a frontmatter-based schema to keep outputs time-aware and well-structured.

How This Skill Works

When invoked, the skill clarifies the research objective, searches and fetches relevant external resources, then synthesizes the findings into a markdown document saved at .lore/research/[topic].md using kebab-case filenames. It also uses a date frontmatter field and loads the frontmatter schema to ensure proper metadata and status values are included.

When to Use It

Exploring external documentation or APIs
Finding prior art or existing solutions
Understanding libraries, frameworks, or tools
Gathering reference material
When you need authoritative sources for a topic

Quick Start

Step 1: Clarify what you need to research and the desired outputs
Step 2: Search docs, API references, and trusted external sources
Step 3: Synthesize findings and save to .lore/research/[topic].md with frontmatter

Best Practices

Clarify the exact research objective before starting the search
Cite sources with accurate URLs in the Sources section
Use kebab-case filenames and include a date: frontmatter for time-sensitive topics
Summarize findings clearly with bullets and link to original docs
Save the document to .lore/research and reference it in related lore or notes

Example Use Cases

Research the API docs for a new cloud provider before integration
Find prior art for a user interface interaction pattern
Look up how a popular library handles authentication
Gather reference material for a framework upgrade
Document edge-case considerations from official docs

Frequently Asked Questions

Add this skill to your agents