instructions-audit

Audit copilot instructions against repository structure and generate a remediation report.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/Paradiddle131/global-ai-customizations --skill instructions-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instructions-audit
Source: https://github.com/Paradiddle131/global-ai-customizations/tree/main/skills/instructions-audit
Command: npx skills add https://github.com/Paradiddle131/global-ai-customizations --skill instructions-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit copilot-instructions.md against the actual codebase structure, conventions, and recent changes to detect drift, stale references, and mismatches between guidance and implementation.

Core Features & Use Cases

  • Drift detection: Compare instructions to the current repository structure and files to surface inconsistencies.
  • Conformance checks: Validate referenced paths, stack versions, and project structure against the live codebase.
  • Remediation guidance: Generate actionable fixes and notes after each audit for hygiene during refactors.

Quick Start

Run a full audit against your repository's instructions to surface drift and generate a remediation report.

Frequently Asked Questions about instructions-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit copilot instructions for drift against my codebase?

To audit copilot instructions for drift, cross-reference the repository against documented guidance by reading .github/copilot-instructions.md and verifying paths, stack versions, and project structure to surface inconsistencies and generate a remediation report.

What is copilot instructions drift and how do I detect stale references?

Copilot instructions drift occurs when documented guidance in copilot-instructions.md becomes outdated after refactors or convention changes. Drift detection works by cross-referencing the live codebase against the instructions to surface stale references and mismatches.

How do I check if my copilot-instructions.md paths and stack versions match the actual project?

Conformance checks validate referenced paths, stack versions, and project structure against the live codebase. The audit reads .github/copilot-instructions.md and cross-references the repository to verify that documented guidance matches actual implementation.

What's the best way to generate a remediation report for copilot instructions?

The best way to generate a remediation report for copilot instructions is to run a full audit against your repository. This cross-references the codebase to detect drift and produces concise, actionable fixes for stale references and mismatches.

Do I need a specific repository structure to audit copilot instructions?

You need a .github/copilot-instructions.md file present in your repository to audit copilot instructions. The audit verifies your actual project structure, stack versions, and conventions against this documented guidance to detect drift.

Can I use a gap-analysis audit during codebase refactors?

Yes, you can use a gap-analysis audit during codebase refactors to maintain instruction hygiene. The audit detects drift and stale references caused by new files and changed conventions, providing remediation guidance to keep instructions aligned.