Download for macOS
Skill

acquire-codebase-knowledge

@github Updated 2026-10-26

Use this skill when the user explicitly asks to map, document, or onboard into an existing codebase. Trigger for prompts like "map this codebase", "document this architecture", "onboard me to this repo", or "create codebase docs". Do not trigger for routine feature implementation, bug fixes, or narrow code edits unless the user asks for repository-level discovery.

agent-skillsagentsaiawesomecustom-agentsgithub-copilothacktoberfestprompt-engineering

Install

With your agent

Install OMGSkills skill "github/awesome-copilot:acquire-codebase-knowledge" into this agent's normal skills directory: use the OMGSkills MCP get_skill tool, install only the pinned_install commit and path, verify SKILL.md against pinned_install.skill_md_sha, and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.

Manual command

git clone https://github.com/github/awesome-copilot /tmp/awesome-copilot && ln -s /tmp/awesome-copilot/skills/acquire-codebase-knowledge ~/.claude/skills/acquire-codebase-knowledge

From README

Acquire Codebase Knowledge Produces seven populated documents in docs/codebase/ covering everything needed to work effectively on the project. Only document what is verifiable from files or terminal output — never infer or assume. Output Contract (Required) Before finishing, all of the following must be true: Exactly these files exist in docs/codebase/: STACK.md, STRUCTURE.md, ARCHITECTURE.md, CONVENTIONS.md, INTEGRATIONS.md, TESTING.md, CONCERNS.md. Every claim is traceable to source files, config, or terminal output. Unknowns are marked as [TODO]; intent-dependent decisions are marked [ASK USER]. Every document includes a short "evidence" list with concrete file paths. Final response includes numbered [ASK USER] questions and intent-vs-reality divergences. Workflow Copy and track this checklist: Focus Area Mode If the user supplies a focus area (for example: "architecture only" or "testing and concerns"): Always run Phase 1 in full. Fully complete focus-area documents first.