docs-architect

Generate README.md and structured /docs folders while normalizing cross-links.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mattmre/AGENT33 --skill docs-architect-mattmre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-architect
Source: https://github.com/mattmre/AGENT33/tree/main/engine/packs/workflow-ops/skills/docs/docs-architect
Command: npx skills add https://github.com/mattmre/AGENT33 --skill docs-architect-mattmre

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of inconsistent, unprofessional, and difficult-to-navigate documentation across code repositories, ensuring every project meets a high standard of clarity and usability.

Core Features & Use Cases

  • Comprehensive Documentation Overhaul: Generates professional README.md files and structured /docs folders for any repository.
  • Cross-Link Normalization: Standardizes and fixes all internal links within documentation suites.
  • Use Case: A development team has multiple microservices, each with sparse and outdated documentation. This Skill can be used to systematically bring all service documentation up to a consistent, high-quality standard, improving onboarding and maintainability.

Quick Start

Use the docs-architect skill to perform a documentation overhaul on the attached repository.

Frequently Asked Questions about docs-architect

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

FAQPage Schema
How do I standardize documentation across multiple code repositories?

Standardize repository documentation by generating a consistent suite of README.md files and structured /docs folders. This process normalizes cross-links and creates a documentation index map, ensuring every microservice meets a high standard of clarity and usability.

What sections should a professional technical documentation suite include?

A professional technical documentation suite should include sections for "The Hook & Vision", "The Tech Stack", "The Quickstart", "Information Flows", and "Use Cases". This structure ensures comprehensive coverage of project onboarding and architecture.

How do I fix and normalize broken cross-links in markdown documentation?

Normalize broken cross-links in markdown documentation by executing a comprehensive documentation overhaul. This standardizes all internal links across the repository suite and generates a unified documentation index map for reliable navigation.

Can I use this approach to overhaul documentation for a large microservices architecture?

Yes, you can systematically overhaul documentation for a large microservices architecture. It brings sparse, outdated service documentation up to a consistent, high-quality standard by generating uniform README.md files and structured /docs folders across all repositories.

What is the best way to generate a structured /docs folder for an existing repository?

The best way to generate a structured /docs folder is to perform a comprehensive documentation overhaul on the attached repository. This automatically creates the /docs structure with specific sections like "The Quickstart" and "Information Flows" while normalizing cross-links.

Do I need any specific dependencies to perform a repository documentation overhaul?

No specific dependencies are required to perform a repository documentation overhaul. The process operates directly on the attached repository to generate the Gold Standard documentation suite and normalize cross-links without external tools.