πΉ Feature: GitHub Copilot Custom Instructions & Agent Skills
πΉ What It Does: Enhances GitHub Copilot by embedding your teamβs coding standards, architecture patterns, and reusable workflows so AI-driven suggestions, PR reviews, and agent tasks align to your organization instead of generic defaults.
Why It Matters
Out-of-the-box Copilot is smart, but it doesnβt know your naming conventions, security baselines, or that your IaC uses Bicep over Terraform. Custom Instructions make Copilot contextually aware of your standards, while Skills provide portable, reusable runbooks (scripts + templates + examples) it can invoke when needed. Together, they transform Copilot from a general assistant into a teammate who has read your onboarding docs.
What Itβs Giving You
β
Repository-Wide Instructions β .github/copilot-instructions.md defines always-on rules for architecture, coding style, build/test/deploy norms
β
Path-Specific Instructions β .github/instructions/*.instructions.md applies different rules for IaC, pipelines, or language-specific folders
β
Agent Skills β .github/skills/ with portable SKILL.md folders that bundle scripts and templates, invoked automatically or via /skill-name
β
Cross-Surface Consistency β Skills work across VS Code, Copilot CLI, and cloud coding agents (open standard, also compatible with Claude)
β
Progressive Context Loading β Skills inject their context only when triggered, keeping token usage efficient
β
Priority Model Support β Personal > Repository > Organization instructions, allowing layered customization
β
Smarter PR Reviews β Copilot reviews respect custom instructions out-of-the-box for consistent, policy-aligned feedback
π‘ Pro Tip: Keep instructions files under ~1,000 lines with short, imperative bullets. Start with 10β20 rules and refine based on actual PR performance.
Real-Life Examples
π https://github.com/MariuszFerdyn/microsoft-zero-trust-report
β PowerShell CIS Benchmark automation for Azure & M365. Includes .github/copilot-instructions.md and AGENTS.md ensuring all contributors (human or AI) track Manual CIS items and follow permission rules.
π https://github.com/MariuszFerdyn/LocalTemporaryTalkChat
β Single-file encrypted PHP chat app with WebRTC and AES-GCM. Copilot instructions enforce strict rules: keys never leave the browser, no DB, no WebSockets, encrypted payloads only.
More Info
π https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions
π https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/create-skills
π https://code.visualstudio.com/docs/copilot/customization/agent-skills
π https://github.com/github/awesome-copilot