vibe-research

Coordinate MD-first research tasks with Git-backed control files.

1|1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/jason-jj-li/skills --skill vibe-research-jason-jj-li
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vibe-research
Source: https://github.com/jason-jj-li/skills/tree/main/vibe-research
Command: npx skills add https://github.com/jason-jj-li/skills --skill vibe-research-jason-jj-li

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The vibe-research Skill provides a project-native operating system for AI-assisted research, enabling teams to run literature reviews, hypothesis generation, experiment planning, data analysis, evidence synthesis, and writing inside a single project folder while preserving human readability.

Core Features & Use Cases

  • Stable control layer via Markdown artifacts (AGENTS.md, STATE.md, TASKS.md, CHANGELOG.md) that act as the shared memory for humans and agents.
  • Git as the historical memory layer to track changes and milestones without conflating runtime state.
  • Optional resources directories (scripts/, references/, assets/) that scripts can leverage on demand.
  • Real-world use cases include literature triage, project planning, experiment design, data analysis, and drafting within a cohesive, auditable workspace.

Quick Start

Bootstrap a new MD-first research OS in your project directory using the provided bootstrap script.

Frequently Asked Questions about vibe-research

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

FAQPage Schema
How do I keep AI agent memory and human context aligned during a literature review?

To keep AI agent memory and human context aligned during a literature review, use a Markdown-first research OS with shared control files like STATE.md and TASKS.md to maintain a stable, human-readable memory layer for both humans and agents.

What is the best way to track AI-assisted research tasks and ensure reproducibility?

The best way to track AI-assisted research tasks and ensure reproducibility is to enforce gate-driven workflows with versioned artifacts, using Git as a historical memory layer to track changes and milestones without conflating runtime state.

How do I set up a project folder for AI-assisted experiment planning and data analysis?

To set up a project folder for AI-assisted experiment planning and data analysis, bootstrap a new MD-first research OS using a provided script, which creates shared control files and optional resources directories like scripts/ and references/ on demand.

Can I use Markdown files to manage the entire research lifecycle from hypothesis development to writing?

Yes, you can use Markdown files to manage the entire research lifecycle from hypothesis development to writing by utilizing artifacts like AGENTS.md and CHANGELOG.md as a shared control layer, ensuring clear handoffs and traceability across all research phases.

Does Git work as a memory layer for coordinating literature triage and evidence synthesis?

Git works effectively as a historical memory layer for coordinating literature triage and evidence synthesis, tracking changes and milestones independently from runtime state to keep human and agent memory aligned within a single project folder.

What are the limitations of using a Markdown-first research OS for project management?

A limitation of using a Markdown-first research OS for project management is that it relies on developers manually maintaining structured artifacts like AGENTS.md and STATE.md, requiring strict adherence to gate-driven workflows to prevent context drift between human and agent memory.