How does this skill handle existing configuration files?

It identifies clutter files like .eslintrc or .prettierrc and provides a relocation plan to move them to .config/, including the necessary glue code or script overrides to keep tools functional.

Does it help with open-source project health?

Absolutely. It ensures essential governance files like LICENSE, SECURITY.md, and CITATION.cff are correctly placed and formatted for GitHub's detection systems.

What is the 'Minimal Root' philosophy?

It is an organizational strategy that keeps the repository's root directory clean by moving implementation details and tool configurations into specific subdirectories like .config/ or docs/ to reduce cognitive load.

Is it compatible with all programming languages?

Yes, the structural principles, documentation standards, and configuration relocation strategies are language-agnostic and apply to any software repository.

Can this skill generate visual diagrams?

Yes, it uses Mermaid.js to create 'Diagrams as Code' for project architecture, workflows, and flowcharts directly within your GitHub documentation.

GitHub Repository Architect

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

byorganvm-iv-taxis

•

Learning & Documentation

Standardizes repository organization by enforcing a minimal root directory and high-conversion documentation patterns.

This skill transforms cluttered codebases into professional, architecturally sound repositories by implementing the 'Minimal Root' philosophy. It systematically migrates configuration files into a centralized .config/ directory, organizes community files into .github/, and generates world-class README files complete with automated navigation, architecture diagrams, and high-conversion visual elements. It is an essential tool for developers aiming to improve project maintainability, streamline onboarding, and enhance the public presentation of open-source or enterprise projects.

Key Features

01World-class README generation with Mermaid.js diagrams and visual funnels.

022 GitHub stars

03Accessibility-first documentation with dark-mode adaptive visual support.

04Automated migration of tool configurations to a centralized .config/ directory.

05Minimal Root enforcement to eliminate top-level file entropy and clutter.

06Community health file standardization including SECURITY.md and templates.

Use Cases

01Standardizing repository structures across an organization's internal GitHub presence.

02Refactoring a legacy codebase with dozens of root-level configuration files.

03Preparing an open-source project for public launch with professional documentation.

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