repo-adaptation

What problem does it solve?

Many repositories either lack a consistent agent-facing surface or use fragmented, tool-specific conventions (CLAUDE.md, .cursorrules, .opencode, etc.), which makes multi-tool workflows error-prone and hard to maintain. This skill helps teams discover what agent instructions exist, classify the repository state, and propose or apply a conservative migration path to a single AGENTS.md plus .agents/ layout.

Core Features & Use Cases

• Inventory & Inspection: Enumerates agent-facing files and directories with size and a content fingerprint to establish a clear baseline.
• Classification & Reporting: Classifies repos as greenfield, partial-modern, legacy, or mixed/conflicted and produces a migration report with proposed mappings and compatibility notes.
• Bootstrap & Conservative Migration: Optionally scaffolds AGENTS.md and the .agents/ tree or migrates legacy files into skills and handoffs while preserving compatibility shims and requiring human approval for destructive actions.
• Safety-first Rules: Enforces never overwriting AGENTS.md without approval, never deleting legacy files by default, and stopping for human review on conflicts.

Quick Start

Ask the agent to inspect the repository and produce an assessment-mode migration report that inventories agent files and recommends a non-destructive migration plan.