docs

Generate ikigai project documentation with structured frontmatter and cross-references.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/mgreenly/ikigai --skill docs-mgreenly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs
Source: https://github.com/mgreenly/ikigai/tree/main/.claude/library/docs
Command: npx skills add https://github.com/mgreenly/ikigai --skill docs-mgreenly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documenting the ikigai project can be inconsistent and hard to maintain. This skill provides a concise, opinionated set of guidelines to produce clear, user-facing documentation that is easy to navigate and reuse across topics.

Core Features & Use Cases

  • Structured topic per file: Encourage one file per major topic to improve findability and maintenance.
  • Clear guidance on style and structure: Prescribe sections like Overview → Quick Start → Details, and use of headings, code examples, and tables.
  • Cross-references and external resources: Promote linking to related docs and project references to reduce duplication.
  • Security and deployment considerations: Call out security considerations and deployment guidance when relevant.
  • Use Case: When documenting a new feature, start with goals, then usage, then examples.

Quick Start

Create a new documentation topic following the ikigai docs guidelines and structure.

Frequently Asked Questions about docs

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

FAQPage Schema
What's the best way to structure user documentation for a new feature?

Feature documentation should follow a structured progression of goals, usage, and examples. Organize files with one major topic per file, using prescribed sections like Overview, Quick Start, and Details to improve findability and maintenance.

How do I write developer docs that are easy to maintain and navigate?

Developer docs are easier to maintain when you use a one-topic-per-file organization with structured frontmatter. Include clear headings, code examples, and tables to prescribe style and structure across internal documentation.

How do cross-references help reduce duplication in project documentation?

Cross-references reduce duplication in project documentation by linking to related docs and project references instead of repeating content. This promotes reuse across topics and keeps architecture references consistent.

When should I include security considerations in user guides?

Security considerations should be included in user guides whenever deployment guidance is relevant. Calling out security needs during documentation authoring ensures users understand deployment constraints and safe usage.

Does this documentation approach work for architecture references?

Yes, this documentation approach applies to architecture references alongside internal developer docs and user guides. It supports structured frontmatter and cross-references across docs and project topics for consistent quality.

Limitations of unstructured documentation for cross-functional teams?

Unstructured documentation becomes inconsistent and hard to maintain for cross-functional teams. Without an opinionated set of writing guidelines, findability decreases and content duplication increases across related topics.