Agent skill
area-instructions
Generate a concise .instructions.md file for a specific area of a codebase, scoped to files matching certain patterns.
Install this agent skill to your Project
npx add-skill https://github.com/microsoft/agentrc/tree/main/plugin/skills/area-instructions
SKILL.md
You are an expert codebase analyst generating an area instruction file (.instructions.md).
This file will be used as an area instruction in VS Code, automatically applied when working on files matching certain patterns.
Exploration Strategy
Use tools to explore only the files and directories within this area:
- List the key files using glob patterns for the area
- Identify the tech stack, dependencies, and frameworks used in this area
- Look at key source files to understand patterns and conventions specific to this area
Output Guidelines
Generate concise instructions (~10-30 lines) covering:
- What this area does and its role in the overall project
- Area-specific tech stack, dependencies, and frameworks
- Coding conventions and patterns specific to this area
- Build/test commands relevant to this area (if different from root)
- Key files and directory structure within this area
Important Rules
- Focus only on this specific area, not the whole repo
- Do not repeat repo-wide information (that goes in the root copilot-instructions.md)
- Keep it complementary to root instructions
- Do not duplicate content already covered by existing instruction files
Output Contract
When you have the complete markdown content, call the emit_file_content tool with it. Do NOT output the file content directly in chat.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
nested-detail
Generate a deep-dive instruction file about a specific topic for a repository or area.
nested-hub
Generate a lean AGENTS.md hub file for a repository or area, including recommended topics for detail files.
root-instructions
Generate a concise .github/copilot-instructions.md file for a repository by analyzing its codebase structure, tech stack, and conventions.
auth
Activate when code touches token management, credential resolution, git auth flows, GITHUB_APM_PAT, ADO_APM_PAT, AuthResolver, HostInfo, AuthContext, or any remote host authentication — even if 'auth' isn't mentioned explicitly.
python-architecture
Activate when creating new modules, refactoring class hierarchies, introducing design patterns, or making changes spanning 3+ files in the APM CLI codebase.
cli-logging-ux
Use this skill when editing or creating CLI output, logging, warnings, error messages, progress indicators, or diagnostic summaries in the APM codebase. Activate whenever code touches console helpers (_rich_success, _rich_warning, _rich_error, _rich_info, _rich_echo), DiagnosticCollector, STATUS_SYMBOLS, CommandLogger, or any user-facing terminal output — even if the user doesn't mention "logging" or "UX" explicitly.
Didn't find tool you were looking for?