learnings-researcher

Search docs/solutions by frontmatter metadata and rank learnings by relevance and severity.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mattjefferson/open-compound-engineering --skill learnings-researcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learnings-researcher
Source: https://github.com/mattjefferson/open-compound-engineering/tree/main/skills/learnings-researcher
Command: npx skills add https://github.com/mattjefferson/open-compound-engineering --skill learnings-researcher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to surface institutional learnings from the knowledge base (docs/solutions) before starting work, reducing repeated mistakes and rework.

Core Features & Use Cases

  • Grep and surface solutions by frontmatter metadata to surface relevant learnings.
  • Supports module, problem_type, component, symptoms, and severity matching to prioritize results.
  • Provides concise summaries with module, problem_type, symptoms, root_cause, and recommended actions.

Quick Start

Ask the learnings-researcher to surface past learnings for the current feature before coding.

Frequently Asked Questions about learnings-researcher

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

FAQPage Schema
How do I surface past institutional learnings before starting feature development?

You can surface past institutional learnings by searching docs/solutions using frontmatter metadata to match categories, modules, and symptoms to the current feature. The search ranks results by relevance and severity to prevent repeated mistakes and rework.

How does searching by frontmatter metadata help find documented solutions?

Searching by frontmatter metadata narrows results by matching specific fields like module, problem_type, component, and symptoms. This filtering ranks documented solutions by severity and returns concise summaries including root cause and recommended actions.

What's the best way to grep documented knowledge for specific symptoms and modules?

The best way to grep documented knowledge is to filter docs/solutions by matching frontmatter fields like module, problem_type, and symptoms. This approach ranks relevant solutions by severity and retrieves concise summaries of root causes and recommended actions.

Can I retrieve recommended actions and root cause summaries from past solutions?

Yes, you can retrieve recommended actions and root cause summaries. The search returns concise summaries from docs/solutions that include module, problem_type, symptoms, root_cause, and recommended actions matched by frontmatter metadata.

Does matching frontmatter severity and categories reduce repeated development mistakes?

Matching frontmatter severity and categories reduces repeated development mistakes by surfacing relevant institutional learnings before coding begins. Ranking results by severity ensures the most critical problems and solutions are reviewed first.

What fields are included in concise summaries of surfaced learnings?

Concise summaries of surfaced learnings include the module, problem_type, symptoms, root_cause, and recommended actions. These fields are extracted from the frontmatter metadata of matching documents in the docs/solutions directory.