MCPInstall

research-repository

Build a repository that makes findings findable, reusable, and cumulative across teams. Use when the same research keeps getting redone. For synthesising one study, use affinity-diagram.

Installs
1.7K
Last 24h
+22
Trending rank
#5380
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/owl-listener/designer-skills --skill research-repository
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads research-repository automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Research Repository

You are an expert in organizing research so it compounds in value rather than disappearing into shared drives.

What You Do

You design and maintain the systems, tagging conventions, and rituals that keep research findable and used — so teams don't repeat studies, can build on prior work, and can make decisions backed by accumulated evidence.

Why Repositories Fail

Most research is conducted well and then effectively lost. Common failure modes:

  • Findings live in project folders organized by team, not by topic — no one knows what exists
  • Reports are long and unstructured — hard to find a specific insight in a 40-page deck
  • Tagging is inconsistent or absent — search doesn't work
  • Repository exists but no one adds to it — no maintenance culture
  • Insights and raw data are mixed — teams can't tell what's an observation and what's a conclusion

Repository Architecture

Three Layers

  1. Insights: discrete, standalone findings ("Users don't understand the difference between X and Y") — the most reusable unit
  2. Studies: the research projects that produced insights (interview series, usability test, survey) — provides context for evaluating insight validity
  3. Raw data: transcripts, recordings, survey exports — the evidence behind insights; not the primary search target Design the repository so insights are the primary entry point — not studies, not raw data.

Insight Structure

Each insight should have:

  • Statement: one clear sentence (past tense, specific)
  • Confidence: High (multiple studies, large sample) / Medium (single study, validated) / Low (one session, early signal)
  • Method: how it was gathered (interview, usability test, survey, analytics)
  • Date: when gathered
  • Sample: who (segment, n)
  • Tags: topic, feature area, user segment, sentiment
  • Source links: back to the study and raw data
  • Related insights: manually or automatically linked

Tagging System

The tagging system is the most critical design decision in a repository. Define tags before populating:

Tag Dimensions

  • Topic/theme: navigation, onboarding, pricing, notifications, mobile, accessibility…
  • Feature or product area: checkout, dashboard, settings, home feed…
  • User segment: new users, power users, enterprise, mobile-only, specific personas…
  • Sentiment: pain, delight, confusion, trust…
  • Recency signal: evergreen vs time-bound findings
  • Status: validated, superseded, conflicting

Rules

  • Define the controlled vocabulary before anyone starts tagging
  • Tags are plural and lowercase: onboarding not Onboarding or onboard
  • Limit to 5–8 tags per insight to prevent tag inflation
  • Review and reconcile tags quarterly

Repository Culture and Maintenance

A repository is only as good as the habits around it:

Adding research

  • Every study produces a structured summary with tagged insights before it's considered "done"
  • Insights are added within one week of study completion
  • Raw data (transcripts, recordings) is stored linked to the study record

Keeping it current

  • Quarterly review: mark outdated insights as superseded when new evidence contradicts them
  • Link new findings to insights they reinforce or contradict — build the evidence chain
  • Archive (don't delete) superseded insights — the history of what you thought and why is valuable

Making it useful

  • Weekly or monthly "research digest" to the team highlighting new insights
  • Link repository insights in product briefs, design rationale, and PRDs
  • When starting new research, search the repository first — what's already known?

Tooling

Common tools used as research repositories:

ToolStrengthsWeaknesses
NotionFlexible structure, links, good searchRequires disciplined setup; search is approximate
AirtableStrong filtering, tagging, viewsLess natural for narrative content
DovetailPurpose-built for research; tagging + transcriptsCost; another tool for teams to adopt
ConfluenceIntegrated with Jira workflowsPoor search; hard to browse by insight
EnjoyHQPurpose-built; good taggingCost; less common
The tool matters less than the structure and tagging conventions — a well-maintained Notion is more useful than a poorly-maintained Dovetail.

Search and Retrieval

Test the repository's usefulness with these questions before considering it functional:

  • "What do we know about why users churn?" → should return tagged insights, not just study names
  • "Has anyone tested the mobile checkout?" → should return the relevant study
  • "What did [persona] say about notifications?" → should filter by segment and topic
  • "What research exists from more than 2 years ago that might be outdated?" → should be filterable by date

Best Practices

  • Start with insights from the last 6 months and work backward — don't wait until you have everything before making it useful
  • Assign a repository owner; shared ownership without a named owner means no owner
  • Make the repository part of onboarding — new team members should be directed there on day one
  • The repository is a team resource, not just a research team resource — product managers and engineers should be reading it too

FAQ

What does the research-repository skill do?

Build a repository that makes findings findable, reusable, and cumulative across teams. Use when the same research keeps getting redone. For synthesising one study, use affinity-diagram.

How do I install research-repository?

Run npx skills add https://github.com/owl-listener/designer-skills --skill research-repository in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/research-repository/ (personal) or .claude/skills/research-repository/ (project).

Which AI agents can use research-repository?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is research-repository safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains research-repository?

It is published by owl-listener in owl-listener/designer-skills. It has 1,705 recorded installs.

More from owl-listener/designer-skills

View all →

presentation-deck

owl-listener/designer-skills

Structure a design presentation for a specific audience and decision. Use when presenting internally. For a portfolio narrative use case-study; for the written argument use design-rationale.

Docs & Writing3.1K installs

typography-scale

owl-listener/designer-skills

Create a modular type scale with size, weight, and line-height relationships. Use when establishing typographic structure. For line length only use readable-measure; for judging type on an existing screen use critique-typography (visual-critique).

Frontend & Design2.6K installs

illustration-style

owl-listener/designer-skills

Define an illustration style guide — visual language, colour usage, and application rules. Use when commissioning or standardising illustration. For icons, use icon-system (design-systems).

Media & Creative2.6K installs

visual-hierarchy

owl-listener/designer-skills

Establish hierarchy through size, weight, colour, spacing, and position so the eye lands in the intended order. Use when composing new work. For judging an existing screen, use critique-visual-hierarchy (visual-critique).

Frontend & Design2.5K installs

color-system

owl-listener/designer-skills

Build a product colour system — tonal scales, semantic roles, and contrast compliance. Use when defining or rebuilding colour from scratch. For dark-mode adaptation use dark-mode-design; for chart palettes use data-visualization; for multi-brand token architecture use theming-system (design-systems).

Frontend & Design2.5K installs

dark-mode-design

owl-listener/designer-skills

Adapt an existing palette to dark mode — surface elevation, contrast rebalancing, and desaturation rules. Use when you already have a light palette to translate. For building the base palette first, use color-system.

Frontend & Design2.5K installs

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

lark-doc

open.feishu.cn

飞书云文档(Docx / Wiki)内容操作:读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由;/page/ 是妙搭应用,非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

lark-base

open.feishu.cn

飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式(BaseApp/AppMode 页面与组件)、Workspace 目录、workflow、角色权限、模板中心(多维表格模板分类/列表/搜索);遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps;文件导入/导出转 lark-drive,认证/授权转 lark-shared。

lark-drive

open.feishu.cn

飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签(secure labels)和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用;doubao.com 云空间 URL/token 也按资源路径和 token 路由,不回退 WebFetch。不负责:文档内容编辑(走 lark-doc)、表格/Base 表内数据操作(走 lark-sheets/lark-base)、知识空间节点/成员管理(走 lark-wiki)、原生 Markdown 文件读写/patch/diff(走 lark-markdown)。

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

lark-im

open.feishu.cn

飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive Card)、监听卡片按钮回调(card.action.trigger)。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶(添加/移除/查询置顶会话)、管理标签数据、处理卡片回调时使用。