auldsyababua/repo-maintainer
skills/repo-maintainer/SKILL.md
Audits and reorganizes messy repositories into clean, LLM-friendly structures. It uses a non-destructive "Migration Manifest" process to safely consolidate scripts, establish documentation, and create AI context zones.
$ install --global
skillsauthnpx skillsauth add auldsyababua/instructor-workflow repo-maintainerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 3, 2026, 9:07 AM11.1s8 files scanned
SKILL.md
- name:
- repo-maintainer
- description:
- Audits and reorganizes messy repositories into clean, LLM-friendly structures. It uses a non-destructive "Migration Manifest" process to safely consolidate scripts, establish documentation, and create AI context zones.
Repository Maintainer
Overview
This skill turns disorganized codebases ("polluted roots," "orphan scripts") into structured, readable repositories. It prioritizes LLM-Readability (creating explicit context maps) and Safety (using a reversible migration manifest).
Use this skill when:
- A repository has too many files in the root directory.
- Documentation is missing, outdated, or scattered.
- An LLM struggles to find relevant context due to noise.
- You need to "refactor" the file structure without breaking git history.
Workflow
1. The Audit (Discovery)
First, analyze the repository to understand "Hot" (frequently changed) vs "Cold" (stale) zones.
- Run
scripts/scaffold_manifest.pyto generate a draft manifest. - Identify the "blood flow" (dependencies): Does
main.pyimport that messy script? - Output: A mental model of the current chaos.
2. The Manifest (Planning)
Do not move files immediately. Create a migration_manifest.yaml that defines the desired state.
- Run
scripts/scaffold_manifest.pyto generate a draft manifest if you haven't already. - Categorize files into:
- Core: Application logic (
src/) - Scaffolding: Configs (
.env,docker-compose) - Artifacts: One-off scripts (Move to
archive/) - Knowledge: Docs (Move to
docs/)
- Core: Application logic (
- Review the YAML file. It is the "Contract of Changes."
3. Execution (Safe Move)
Apply the changes using the manifest.
- Run
scripts/apply_migration.py. - Safety Rule: This script uses
git mvto preserve history. - Quarantine: Unknown scripts go to
archive/quarantine/rather than being deleted.
4. LLM Optimization (Contextualizing)
Once files are moved, establish the .ai/ directory.
- Copy
assets/CONTEXT_TEMPLATE.mdto.ai/CONTEXT.md. - Fill it with a high-level summary of the architecture.
- This ensures future agents understand why the code exists, not just what it does.
Directory Structure Standards
When planning the migration, aim for this specific structure (The "LLM-First" Architecture):
/ (Root)
├── .ai/ # Context specifically for LLMs
│ ├── CONTEXT.md # Architecture & Business Logic
│ └── GUIDELINES.md # Coding standards
├── src/ # Source code
├── scripts/ # DevOps/Maintenance scripts
├── docs/ # Human documentation
├── archive/ # Deprecated/Quarantine
└── README.md # The Map
Related Skills
auldsyababua/webapp-testing
tools
VerifiedTrustedCommunity
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
6SKILL.mdUpdated Apr 3, 2026
auldsyababua/Update Linear Post-Job
testing
VerifiedTrustedCommunity
Three-step Linear update protocol after job completion - update child issue, check parent completion, update parent if all children done
6SKILL.mdUpdated Apr 3, 2026
auldsyababua/travel-planner
testing
VerifiedTrustedCommunity
This skill should be used whenever users need help planning trips, creating travel itineraries, managing travel budgets, or seeking destination advice. On first use, collects comprehensive travel preferences including budget level, travel style, interests, and dietary restrictions. Generates detailed travel plans with day-by-day itineraries, budget breakdowns, packing checklists, cultural do's and don'ts, and region-specific schedules. Maintains database of preferences and past trips for personalized recommendations.
6SKILL.mdUpdated Apr 3, 2026
auldsyababua/token-budget-advisor
tools
VerifiedTrustedCommunity
Proactive token budget assessment and task chunking strategy. Use this skill when queries involve multiple large file uploads, requests for comprehensive multi-document analysis, complex multi-step workflows with heavy research (10+ tool calls), phrases like "complete analysis", "full audit", "thorough review", "deep dive", or tasks combining extensive research with large output artifacts. This skill helps assess token consumption risk early and recommend chunking strategies before beginning work.
6SKILL.mdUpdated Apr 3, 2026