analyze-repo-capabilities
Detect repo tooling and patterns, then record a dynamic manifest.
When & Why to Use This Skill
The analyze_repo_capabilities skill is designed to automate repository discovery and context building for AI agents. It scans codebases for specific patterns, frameworks, and tooling signatures (such as CI/CD, Docker, and IaC) to generate a dynamic manifest. By populating structured memory files like CAPABILITIES.md and COMMANDS.json, it ensures that the agent has a precise, up-to-date understanding of the project's environment and available operations, significantly reducing manual context-setting and improving task execution accuracy.
Use Cases
- Agent Onboarding: Automatically orienting an AI agent to a new or complex codebase by identifying the tech stack, build tools, and deployment patterns.
- Dynamic Documentation: Maintaining a 'living' manifest of project commands and capabilities within the .agent-docs directory to keep the agent's knowledge synchronized with code changes.
- Environment Awareness: Detecting infrastructure-as-code (IaC) and containerization signatures to help the agent determine the correct environment for running tests or deployments.
- Command Discovery: Extracting and verifying executable scripts and CLI tools from the repository to provide the agent with a reliable set of actions for automation tasks.
| name | analyze_repo_capabilities |
|---|---|
| description | Detect repo tooling and patterns, then record a dynamic manifest. |
| short-description | Detect repo capabilities |
Purpose
Scan the repository for tooling signals and record findings.
Steps
- Inspect common signatures (CI, Docker, IaC, agents, frameworks).
- Update
.agent-docs/memory/CAPABILITIES.md. - Populate
.agent-docs/memory/COMMANDS.mdandCOMMANDS.json. - Update
.agent-docs/memory/MANIFEST.yaml. - Update
.agent-docs/memory/INDEX.mdandINDEX.json.
Guardrails
- Do not overwrite existing files; merge append-only where possible.
- Prefer verified commands and record confidence.