conventions-docs

Define documentation conventions for CLAUDE.md, README.md, and diff formats.

1|Updated Jan 5, 2023
One-click install
npx skills add https://github.com/riez/dots --skill conventions-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conventions-docs
Source: https://github.com/riez/dots/tree/main/.config/agentic/skills/conventions-docs
Command: npx skills add https://github.com/riez/dots --skill conventions-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation conventions unify how CLAUDE.md, README.md, and diffs are created, providing a single source of truth to reduce ambiguity and increase reproducibility.

Core Features & Use Cases

  • Central YAML frontmatter schema for skill metadata (name, description)
  • Guidelines and references for writing CLAUDE.md, README.md, and implementation diffs
  • Quick-start guidance to locate current conventions and apply them to new content

Quick Start

Follow the conventions to locate the current guidelines for CLAUDE.md and README.md in the conventions repository.

Frequently Asked Questions about conventions-docs

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

FAQPage Schema
How do I enforce consistent documentation conventions across a project?

To enforce documentation conventions, you can apply centralized guidelines for README and CLAUDE files. This provides a single source of truth with a YAML frontmatter template and a Markdown guide to standardize content creation.

What is the best way to standardize frontmatter schema in Markdown files?

Standardizing frontmatter schema involves applying a centralized YAML template for skill metadata like name and description. This ensures consistent metadata fields across documentation files and reduces ambiguity.

How do I write implementation diffs that follow project guidelines?

Writing implementation diffs requires following centralized diff format guidelines found in the conventions repository. These references provide clear usage examples to ensure your diffs match project standards during content creation.

Do I need a specific tool to manage CLAUDE.md and README.md conventions?

No specific external tool is required to manage CLAUDE.md and README.md conventions. You can locate and apply current guidelines directly from the conventions repository to unify how your documentation is created.

Why does my team need centralized guidelines for README and CLAUDE files?

Centralized guidelines for README and CLAUDE files reduce ambiguity and increase reproducibility across your project. They provide a single source of truth to unify how documentation and implementation diffs are created.