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.

About

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

Enforces 'Single Source of Truth' and reciprocal linking patterns
Provides validation checklists for documentation content and formatting
Maintains a hub-and-spoke navigation architecture for complex repos
Standardizes README, CONTRIBUTING, and docs/ folder responsibilities
Implements vendor-specific isolation for multiple AI platforms
11 GitHub stars

Use Cases

Restructuring a cluttered repository into organized, searchable reference directories
Creating standardized documentation templates for new AI vendor integrations
Auditing existing links and metadata to ensure cross-reference consistency

About

Key Features

Enforces 'Single Source of Truth' and reciprocal linking patterns
Provides validation checklists for documentation content and formatting
Maintains a hub-and-spoke navigation architecture for complex repos
Standardizes README, CONTRIBUTING, and docs/ folder responsibilities
Implements vendor-specific isolation for multiple AI platforms
11 GitHub stars

Use Cases

Restructuring a cluttered repository into organized, searchable reference directories
Creating standardized documentation templates for new AI vendor integrations
Auditing existing links and metadata to ensure cross-reference consistency