From example-skills
Maps a messy workspace directory, identifies structural issues, proposes a restructuring plan, and migrates files to a unified structure with governance templates.
How this skill is triggered — by the user, by Claude, or both
Slash command
/example-skills:workspace-autopsy-governanceThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill enables agents to systematically analyze (autopsy) an existing, potentially disorganized workspace, propose a logical new directory structure, and migrate the workspace to this new structure while enforcing new governance standards.
This skill enables agents to systematically analyze (autopsy) an existing, potentially disorganized workspace, propose a logical new directory structure, and migrate the workspace to this new structure while enforcing new governance standards.
To execute this skill, follow these sequential steps:
To begin, you must understand the current state of the workspace.
python /Users/4jp/.agents/skills/workspace-autopsy-governance/scripts/workspace_autopsy.py --dir .Before moving any files, you must "send out the signal" to the user proposing the new structure and governance.
assets/RESTRUCTURE_PROPOSAL-template.md.RESTRUCTURE_PROPOSAL.md based on your findings from the autopsy. Detail exactly which directories will be created and which files will move where.Once the user approves the proposal:
/src, /docs, /scripts, /assets, /tests) as agreed upon in the proposal.mv) to systematically migrate files from their old locations to the newly created, unified locations..gitignore, package.json).With the files in their new locations, establish the rules that will govern them going forward.
assets/GEMINI-template.md.GEMINI.md at the root of the project.GEMINI.md files for deeper governance (e.g., in /src/GEMINI.md).scripts/workspace_autopsy.pyA Python script that traverses the specified directory, ignores common build/dependency folders, and prints a tree map along with statistics about file types and counts.
assets/RESTRUCTURE_PROPOSAL-template.mdA template for the document you will generate to propose the new structure to the user.
assets/GEMINI-template.mdA template for the governance rules to establish in the repository after the restructure.
Provides a checklist for code reviews covering functionality, security, performance, maintainability, tests, and quality. Use for pull requests, audits, team standards, and developer training.
npx claudepluginhub a-organvm/a-i--skills --plugin document-skills