sysdoc-edit

Create and modify markdown files with sysdoc repository conventions.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/sysdoc-rs/claude-skill-sysdoc --skill sysdoc-edit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sysdoc-edit
Source: https://github.com/sysdoc-rs/claude-skill-sysdoc/tree/main
Command: npx skills add https://github.com/sysdoc-rs/claude-skill-sysdoc --skill sysdoc-edit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures your markdown files adhere to the strict conventions required by sysdoc repositories, preventing common errors and maintaining consistency.

Core Features & Use Cases

  • Enforces Naming Conventions: Guides correct file naming (XX.YY_title-slug.md).
  • Manages Headings: Ensures one H1 per file and proper use of H2s vs. separate files.
  • Validates Structure: Helps maintain proper section numbering and parent section usage.
  • Use Case: When creating a new section for your system design document, use this Skill to ensure the filename and heading structure are perfectly aligned with sysdoc standards.

Quick Start

Use the sysdoc-edit skill to initialize a new Software Design Description document.

Frequently Asked Questions about sysdoc-edit

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

FAQPage Schema
How do I format markdown files for a sysdoc repository?

Formatting markdown for sysdoc repositories requires following specific conventions for file naming, using a single H1 per file, and maintaining clear section organization. This ensures structural consistency across technical documentation.

What is the correct file naming convention for sysdoc markdown sections?

The correct file naming convention for sysdoc markdown sections uses a specific pattern like `XX.YY_title-slug.md`. Adhering to this naming structure ensures proper automated section numbering and hierarchical organization within the repository.

When should I use H2 headings instead of creating separate markdown files?

You should use H2 headings for subsections within the same file when content is tightly coupled, but create separate files when sections need distinct numbering or independent referencing. This distinction maintains document clarity and structural integrity.

How do I initialize a Software Design Description document with proper heading structure?

Initializing a Software Design Description document involves setting up a single H1 per file and configuring the initial heading structure. This establishes the foundational hierarchy required for automated section numbering and sysdoc compliance.

Does sysdoc markdown validation require automated section numbering?

Yes, sysdoc markdown validation requires automated section numbering to maintain structural consistency. Proper numbering relies on correct file naming conventions and appropriate parent section usage within the document hierarchy.

Why does my markdown heading structure fail sysdoc validation?

Markdown heading structure fails sysdoc validation when files contain multiple H1 tags or misuse H2 subsections instead of separate files. Correcting these structural violations enforces the required single H1 per file rule and restores formatting compliance.