skills.rest
russosalv
russosalvCOMMUNITY
Explore all skills by this author →
GitHub

docs-md-generator

Generate CLAUDE.md and copilot-instructions.md from AGENTS.md.

5|Updated Apr 18, 2026
Search Tags:#automation#sync#docs#cross-tool#md-generator#meta-docs
One-click install
npx skills add https://github.com/russosalv/NONoise --skill docs-md-generator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: docs-md-generator
Source: https://github.com/russosalv/NONoise/tree/main/packages/skills/docs-md-generator
Command: npx skills add https://github.com/russosalv/NONoise --skill docs-md-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate and maintain the cross-tool trio of meta-docs for NONoise projects: AGENTS.md (root, cross-tool, source of truth), CLAUDE.md (Claude Code adapter), and .github/copilot-instructions.md (GitHub Copilot adapter), while preserving skill-owned managed blocks verbatim and keeping them aligned with AGENTS.md.

Core Features & Use Cases

  • Generates and reconciles AGENTS.md, CLAUDE.md, and copilot-instructions.md from a single source of truth.
  • Detects drift between the three files and applies Bootstrap/Import/Sync modes to restore coherence.
  • Maintains managed blocks (e.g., polly, graphify) verbatim and surfaces orphan blocks for manual resolution.

Quick Start

Bootstrap the docs triad by providing AGENTS.md as source and generating CLAUDE.md and copilot-instructions.md from it.

Frequently Asked Questions about docs-md-generator

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

FAQPage Schema
How do I keep AGENTS.md and copilot-instructions.md synced with CLAUDE.md?▼

To keep cross-tool meta-docs synced, this Skill propagates changes from AGENTS.md as the single source of truth to generate and reconcile CLAUDE.md and copilot-instructions.md. It detects drift between the files and applies sync or bootstrap modes to restore coherence.

What is the best way to generate GitHub Copilot instructions from a root AGENTS.md file?▼

Generating copilot-instructions.md from AGENTS.md is handled by the bootstrap mode, which uses the root source file to create tool-specific adapter files for GitHub Copilot and Claude Code while preserving managed blocks verbatim.

Does docs-md-generator overwrite managed blocks when syncing cross-tool documentation?▼

No, syncing cross-tool documentation preserves managed blocks verbatim to prevent destructive edits. The Skill identifies orphan blocks and surfaces them for manual resolution, ensuring non-destructive edits unless conflicts are explicitly resolved with user input.

When do I need to bootstrap meta-docs for a NONoise project?▼

You need to bootstrap meta-docs when setting up a new NONoise project or when drift occurs across your documentation triad. This process generates the required CLAUDE.md and copilot-instructions.md files from your existing AGENTS.md source.

Can I use this to fix documentation drift between multiple AI coding tools?▼

Yes, you can fix documentation drift by running the Skill's sync mode. It detects inconsistencies across AGENTS.md, CLAUDE.md, and copilot-instructions.md, then harmonizes the files to restore cross-tool consistency from the source of truth.

Why are my managed blocks showing as orphan blocks during documentation sync?▼

Managed blocks show as orphan blocks during documentation sync when they no longer match the source of truth in AGENTS.md. The Skill surfaces these conflicts for manual resolution instead of applying destructive edits automatically.

Related Skills

Explore More Content & Communication Skills→
avav25avav25
2

project-init

Generate root and scoped AGENTS.md, ARCHITECTURE.md, and TESTING.md files for Windsurf projects.

Community
Advanced
CowboyLogicCowboyLogic

copilot-instruction-creator

Configure Copilot behavior with structured instruction files across scopes.

Official
Intermediate
LbstrydomLbstrydom

ai-context-management

Detect and reconcile drift between AGENTS.md and CLAUDE.md files.

Community
Advanced
SquizAISquizAI
2

github-formatter

Format GitHub repository content with GitHub-flavored markdown and consistent styling.

Community
Intermediate