How does this skill handle different AI platforms?

It implements Vendor Isolation, which assigns each platform (like Claude Code, Kiro, or Gemini) its own directory within the docs/ folder to maintain clean, specialized documentation.

Does it help with link maintenance?

Yes, it defines specific cross-reference patterns and validation guidelines to ensure all internal links resolve and that reciprocal links exist between related documents.

What is the main goal of the documentation-structure skill?

It ensures repository documentation is organized logically using a hub-and-spoke model, clearly separating quick-start landing pages from developer workflows and deep technical references.

How does it differentiate between README and CONTRIBUTING files?

The README is treated as a high-level landing page for users, while the CONTRIBUTING file is strictly reserved for local development setup, testing, and PR processes.

Documentation Architecture & Structure

Name: Documentation Architecture & Structure
Author: miroapp

bymiroapp

•

Content Management

Standardizes repository documentation by enforcing clear separation between landing pages, reference guides, and contributor workflows.

This skill provides Claude with the architectural blueprints needed to organize complex project documentation according to high-standard technical writing principles. It enables Claude to intelligently audit, update, and create READMEs, CONTRIBUTING guides, and cross-referenced documentation folders while maintaining vendor isolation and a single source of truth. It is particularly valuable for developers managing multi-platform integrations who need to maintain consistency across various AI tools and protocol references without duplicating content.

Key Features

01Enforces 'Single Source of Truth' and reciprocal linking patterns

02Provides validation checklists for documentation content and formatting

03Maintains a hub-and-spoke navigation architecture for complex repos

04Standardizes README, CONTRIBUTING, and docs/ folder responsibilities

05Implements vendor-specific isolation for multiple AI platforms

0611 GitHub stars

Use Cases

01Restructuring a cluttered repository into organized, searchable reference directories

02Creating standardized documentation templates for new AI vendor integrations

03Auditing existing links and metadata to ensure cross-reference consistency

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add miroapp/miro-ai documentation-structure

For use in Claude.ai and ChatGPT

Download Skill