repo-structure-conventions

Audit repository structures to enforce consistent layouts and naming conventions.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/chf3198/devenv-ops --skill repo-structure-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-structure-conventions
Source: https://github.com/chf3198/devenv-ops/tree/main/skills/repo-structure-conventions
Command: npx skills add https://github.com/chf3198/devenv-ops --skill repo-structure-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures every managed repository has a consistent, navigable, industry-standard file organization and defines root-level layout, directory naming, app-type-specific directory structures, and build-artifact isolation.

Core Features & Use Cases

  • Owns root-level file layout and ordering; enforces directory naming conventions and app-type-specific structures; isolates build artifacts via .gitignore patterns.
  • Onboarding and restructuring: audits new or reorganizing repos to align with universal conventions; proposes minimal moves or renames without breaking imports or CI.
  • Delegates governance tasks to specialized skills for community health files, documentation quality, and secret hygiene, ensuring clear ownership mappings and auditability.

Quick Start

Run an initial audit to identify gaps between the current structure and universal conventions, then scaffold or remediate as needed.

Frequently Asked Questions about repo-structure-conventions

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

FAQPage Schema
How do I audit repository structure for consistent layouts during onboarding?

You can audit repository structure during onboarding by running an initial audit to identify gaps between the current layout and universal conventions, covering root-level files, directory naming, and build-artifact isolation before proposing remediation.

What is the best way to enforce scalable file organization across multiple projects?

The best way to enforce scalable file organization is to audit repositories against universal conventions, ensuring consistent root-level layouts, app-type-specific directory structures, and proper build-artifact isolation across all managed projects.

How does scaffolding a repository layout differ from remediating an existing one?

Scaffolding generates a compliant root-level layout and directory structure for new repositories, while remediating proposes explicit file moves and renames to align existing projects with conventions without silently breaking imports or CI.

Can I restructure directory naming conventions without breaking CI pipelines?

Yes, you can safely restructure directory naming conventions by using remediate mode, which proposes explicit file moves and renames for review rather than executing silent changes, ensuring imports and CI pipelines remain intact.

Does repo structure governance handle build artifact isolation and CODEOWNERS patterns?

Yes, repo structure governance handles build artifact isolation by enforcing .gitignore patterns and defines CODEOWNERS patterns for clear ownership mappings, while delegating specialized governance tasks like secret hygiene to other skills.

When should I apply app-type-specific directory structures to my repository?

You should apply app-type-specific directory structures after app-type classification, during repository creation or restructuring, ensuring the root layout and directory naming conform to industry-standard conventions for scalable navigation.