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.