context-map
github/awesome-copilot
Generate a map of all files relevant to a task before making changes
What is context-map?
Context Map analyzes your codebase to identify all files, dependencies, tests, and patterns related to a task before implementation begins. Use this to understand scope and dependencies before writing code.
- Search the codebase for files related to the task
- Identify direct dependencies (imports/exports) between files
- Find and list related test files
- Locate similar patterns in existing code to follow
- Generate a structured map with files to modify, dependencies, tests, and reference patterns
- Assess risks including breaking changes, migrations, and configuration updates
How to install context-map
npx skills add https://github.com/github/awesome-copilot --skill context-mapHow to use context-map
- 1.Provide a task description or feature requirement
- 2.Run the skill to analyze the codebase
- 3.Review the generated context map showing files to modify, dependencies, tests, and reference patterns
- 4.Check the risk assessment checklist for breaking changes and migrations
- 5.Use the map to plan your implementation before making changes
Use cases
- Planning a feature implementation by mapping all affected files and dependencies
- Understanding the scope of a refactoring task across a large codebase
- Identifying test coverage gaps before making changes
- Finding existing patterns to follow for consistency
- Assessing breaking changes and migration needs before implementation
- Backend developers planning code changes
- Frontend developers refactoring components
- DevOps engineers modifying infrastructure code
- Team leads reviewing change scope before implementation
context-map FAQ
Review the map to understand scope and dependencies, then use it to plan your implementation. Do not proceed with code changes until the map is reviewed.
No, it only analyzes and maps the codebase. You review the map and then implement changes based on it.
The context map will show all related files, dependencies, and tests. This helps you understand the full scope before starting implementation.
It searches the codebase for test files that cover the functionality in files you need to modify.
It highlights potential breaking changes, database migrations, and configuration changes you should consider before implementing.
Full instructions (SKILL.md)
Source of truth, from github/awesome-copilot.
name: context-map description: 'Generate a map of all files relevant to a task before making changes'
Context Map
Before implementing any changes, analyze the codebase and create a context map.
Task
{{task_description}}
Instructions
- Search the codebase for files related to this task
- Identify direct dependencies (imports/exports)
- Find related tests
- Look for similar patterns in existing code
Output Format
## Context Map
### Files to Modify
| File | Purpose | Changes Needed |
|------|---------|----------------|
| path/to/file | description | what changes |
### Dependencies (may need updates)
| File | Relationship |
|------|--------------|
| path/to/dep | imports X from modified file |
### Test Files
| Test | Coverage |
|------|----------|
| path/to/test | tests affected functionality |
### Reference Patterns
| File | Pattern |
|------|---------|
| path/to/similar | example to follow |
### Risk Assessment
- [ ] Breaking changes to public API
- [ ] Database migrations needed
- [ ] Configuration changes required
Do not proceed with implementation until this map is reviewed.
Related skills
More from github/awesome-copilot and the wider catalog.
git-commit
Execute semantic git commits with conventional message analysis and intelligent staging.
excalidraw-diagram-generator
Generate Excalidraw diagrams from natural language descriptions.
documentation-writer
Create structured technical documentation using the Diátaxis framework for tutorials, how-to guides, references, and explanations.
gh-cli
GitHub CLI comprehensive reference for repositories, issues, PRs, Actions, projects, releases, and all GitHub operations from the command line.
prd
Generate comprehensive Product Requirements Documents with executive summaries, user stories, technical specs, and risk analysis.
refactor
Surgical code refactoring to improve maintainability without changing behavior.