Skip to main content
skill GitHub Copilot official · GitHub

context-map — GitHub Copilot skill: map files before you edit

This skill makes the agent map every file, test and dependency tied to a task before it touches code. Handy on a codebase you don't know yet.

Install into GitHub Copilot · Skills CLI (Vercel) All methods and platforms ↓
npx skills add github/awesome-copilot --skill context-map
Open on GitHub

What context-map does

The skill sets an order of work: search the codebase for files related to the task, trace direct dependencies through imports and exports, find the tests that cover the affected functionality, and collect similar patterns worth copying. Output is markdown tables — files to modify, dependencies, test files, reference patterns — plus a risk checklist covering public API breaks, database migrations and config changes.

There is one SKILL.md file with the instructions and the output template. No scripts, no external services, no API keys. It ships for GitHub Copilot and installs into Claude, Codex, Cursor, Gemini CLI and Windsurf through the skills installer.

The rule is explicit: don't start implementing until the map has been reviewed. That pays off in large repos where an agent happily edits the wrong module. For a one-line fix in a single file the map is just overhead — skip it.

What it helps with

  • find every file a change will touch
  • trace direct dependencies of the module you edit
  • pick the tests that cover the affected code
  • find an existing pattern to follow for new code
  • flag risk to public API and migrations

Example prompts for the agent

  • build a context map for this task: add pagination to the orders list
  • before changing anything, show me the files and tests this task touches
  • which dependencies and tests does the auth module refactor affect?

How to install context-map

1Skills CLI (Vercel)

npx skills add github/awesome-copilot --skill context-map

2GitHub CLI

gh skill install github/awesome-copilot context-map

3Manually: put the files in place

.github/skills/context-map/SKILL.md

From the same set554

The whole set →
git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

Similar

baoyu-wechat-summary JimLiu Extracts WeChat group chats via wx-cli to generate structured discussion digests, maintain member profiles, and track conversation history. Claude Code CX Codex Cursor +1 9,800installs task-observer Eoghan Henn and contributors Monitors agent execution, logs user corrections, and packages repeating workflows into skill updates during weekly reviews. Claude Code CX Codex Cursor +1 14,300installs search-strategy official anthropics This skill breaks a natural-language question into source-specific searches and combines the results. Use it for decisions, status checks, and document discovery. Claude Code CX Codex Cursor +1 5,300installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. Claude Code 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. Claude Code 979,543installs

Questions about context-map

How do I install context-map in GitHub Copilot?

Run npx skills add github/awesome-copilot --skill context-map or gh skill install github/awesome-copilot context-map. The file lands at .github/skills/context-map/SKILL.md.

What does context-map do?

Before any edits it searches for task-related files, dependencies, tests and similar patterns, then returns a markdown map with a risk assessment section.

Does it work with Claude or Cursor?

Yes. The installer targets several agents: npx skills add github/awesome-copilot --skill context-map -a claude-code. For Cursor the file goes to .cursor/skills/context-map/SKILL.md.

Source text

SKILL.md · MIT
---
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

1. Search the codebase for files related to this task
2. Identify direct dependencies (imports/exports)
3. Find related tests
4. Look for similar patterns in existing code

## Output Format

```markdown
## 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.

© github · MIT · github/awesome-copilot

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor