What is the Minimal Root philosophy?

It is an organizational strategy that keeps the repository root pristine by allowing only architectural pillars (like src/ and docs/) while moving configuration details into subdirectories.

How does the skill handle tool configurations?

It identifies clutter like .eslintrc or .prettierrc and provides a relocation plan to move them to a .config/ folder, including the necessary scripts for tools to find them.

What are governance files in this context?

The skill ensures your .github/ folder contains essential community health documents like CONTRIBUTING.md, CODEOWNERS, and issue templates.

Does it support visual architecture diagrams?

Yes, the skill generates Mermaid.js flowcharts to create 'Diagrams as Code' for visual representation of your project's architecture.

Can this skill help with project documentation?

Yes, it drafts high-conversion READMEs that include hero sections, automated table of contents, and copy-pasteable quick start blocks designed to convert users in under 30 seconds.

GitHub Repository Architect

Name: GitHub Repository Architect
Author: organvm-iv-taxis

byorganvm-iv-taxis

•

Learning & Documentation

Organizes repository structures using the Minimal Root philosophy and generates high-conversion README documentation.

The GitHub Repository Standards skill transforms messy codebases into professional, architecturally mature repositories by enforcing strict organizational patterns. It eliminates root directory clutter by relocating tool configurations to a dedicated .config/ folder, implements a 'Progressive Disclosure' hierarchy, and drafts high-conversion READMEs featuring hero sections, automated diagrams, and dark-mode visuals. This skill is essential for maintainers who want to signal project maturity, improve developer onboarding, and ensure long-term architectural health.

Key Features

01Root Hygiene Audit for identifying and relocating configuration clutter

022 GitHub stars

03Automated Mermaid.js architecture diagrams as code

04World-Class README generation with hero sections and badge dashboards

05Community health file enforcement including SECURITY.md and templates

06Minimal Root philosophy implementation using .config/ strategies

Use Cases

01Bootstrapping a new open-source project with professional, high-conversion documentation

02Refactoring a cluttered legacy repository to meet modern architectural standards

03Standardizing repository structures across a corporate engineering organization

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add organvm-iv-taxis/a-i--skills github-repository-standards

For use in Claude.ai and ChatGPT

Download Skill