write-research-doc

Generate structured research documents with frontmatter and organized sections.

10|2|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/eveld/claude --skill write-research-doc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-research-doc
Source: https://github.com/eveld/claude/tree/main/skills/write-research-doc
Command: npx skills add https://github.com/eveld/claude --skill write-research-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Researchers and teams often struggle to produce consistently formatted, frontmatter-driven research documents. This Skill standardizes structure, sections, and file references to reduce manual formatting and ensure reproducibility.

Core Features & Use Cases

  • Frontmatter-driven templates: Includes fields like date, researcher, git info, topic, tags, status, and feature_slug; supports optional shared_as and shared_date for collaboration.
  • Structured sections: Automatically organizes Research Question, Summary, Detailed Findings, Key Discoveries, Implementation Patterns, and References.
  • File references & compatibility: Enforces file:line references and maintains backward-compatible paths for legacy documents.
  • Collaboration-friendly workflow: Works with personal namespaces and the share-docs flow to promote documents to the shared space.

Quick Start

Provide the research question and confirm the target namespace to create a new research document at thoughts/{namespace}/NNNN-description/research.md.

Frequently Asked Questions about write-research-doc

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

FAQPage Schema
How do I generate structured research documents with consistent frontmatter?▼

To generate structured research documents with consistent frontmatter, provide a research question and target namespace. The system creates a standardized report including fields like date, researcher, topic, and status, saving it to thoughts/{namespace}/NNNN-description/research.md.

What sections are included in a frontmatter-driven research report?▼

A frontmatter-driven research report includes structured sections for Research Question, Summary, Detailed Findings, Key Discoveries, Implementation Patterns, and References to organize literature reviews and experimental results.

How do I format references in research notes for reproducibility?▼

To format references in research notes for reproducibility, the system enforces file:line references within the Detailed Findings and References sections, ensuring precise traceability across projects while maintaining backward-compatible paths for legacy documents.

Can I share research notes with other team members from my personal namespace?▼

Yes, you can share research notes with team members from your personal namespace. The system supports optional shared_as and shared_date frontmatter fields and integrates with a share-docs flow to promote documents to a shared space.

What's the best way to organize literature reviews and design decisions across multiple projects?▼

The best way to organize literature reviews and design decisions across multiple projects is using a fixed frontmatter schema with tags, feature_slug, and status fields, which standardizes structure and reduces manual formatting for consistent compilation.

Does this research documentation approach support legacy file paths?▼

Yes, this research documentation approach supports legacy file paths. It preserves backward-compatible paths for legacy documents while enforcing structured sections and file references for new research reports.