How do I install the Repo Structure Allowed At Repo Root skill?

Run npx skillmds@latest add vamseeachanta/repo-structure-allowed-at-repo-root-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Repo Structure Allowed At Repo Root skill do?

Sub-skill of repo-structure: Allowed at Repo Root (+2). It is listed under Coding & Dev Tools on SkillMD.

Is Repo Structure Allowed At Repo Root safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Repo Structure Allowed At Repo Root?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Repo Structure Allowed At Repo Root free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Repo Structure Allowed At Repo Root?

vamseeachanta (@vamseeachanta) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Repo Structure Allowed At Repo Root by vamseeachanta

Name: Repo Structure Allowed At Repo Root
Author: vamseeachanta

File contents

Allowed at Repo Root (+2)

Allowed at Repo Root

src/             tests/           docs/            config/
scripts/         data/            specs/           reports/
pyproject.toml   pytest.ini       README.md        CHANGELOG.md
CLAUDE.md        AGENTS.md        Makefile         LICENSE
.gitignore       .claude/         .codex/          .gemini/
.github/         .pre-commit-config.yaml

NOT Allowed at Repo Root

Item	Correct Location
Loose `.py` scripts	`scripts/` or `src/<pkg>/tools/`
`agents/` directory	`.claude/agents/` only
`.agent-os/`	DELETE — superseded by `.claude/skills/`
`.hive-mind/`, `.swarm/`	DELETE — gitignored
`business/` docs	`docs/business/`
`modules/`	Move into `src/<package>/modules/`
`bin/` (empty)	DELETE
`_coding_agents/`	DELETE
`examples/`	`docs/examples/` or leave at root only if README documents it
`setup.py` (when pyproject.toml exists)	DELETE — pyproject.toml supersedes it
`archive/`, `backups/`	`_archive/` (single, underscore-prefixed)
`.xlsx`, `.csv` output files	`results/<domain>/` and gitignored
`test_export*.json`	`tests/<domain>/fixtures/` or gitignored
`COVERAGE_ANALYSIS.txt`	gitignored (session artifact)
`verdict.txt`, `test_output_ss`	gitignored (session artifacts)
`coverage.wrk*.xml`	gitignored (session artifacts)
Windows path dirs (`D:\...`)	DELETE — filesystem artifact, never track

Root-Level `src/` Must Contain Only the Package

src/              ← OK
  package_name/   ← OK (the installed package)
  modules/        ← WRONG — orphaned, not installed
  validators/     ← WRONG — orphaned, not installed
  other_stuff/    ← WRONG

Frequently asked questions

Repo Structure Allowed At Repo Root