skill-diagnostics

Audit Business Central AL workspaces against declared coding contracts.

1|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/javiarmesto/aldc-workshop-starters --skill skill-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-diagnostics
Source: https://github.com/javiarmesto/aldc-workshop-starters/tree/main/02-aldc-starter/.github/skills/skill-diagnostics
Command: npx skills add https://github.com/javiarmesto/aldc-workshop-starters --skill skill-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps Business Central developers detect contract violations and workspace drift without manually reviewing every AL object, reducing missed compliance issues before reviews or releases.

Core Features & Use Cases

  • Static Workspace Auditing: Checks AL projects against the declared copilot-instructions.md contract and reports traceable findings.
  • Structured Compliance Reports: Organizes issues by class and severity with file and line citations while avoiding unsupported assumptions.
  • Use Case: Review a Business Central extension before a pull request by identifying missing metadata, documentation, tests, permissions, and prohibited patterns.

Quick Start

Ask the skill-diagnostics skill to audit the Business Central workspace and generate the contract compliance report.

Frequently Asked Questions about skill-diagnostics

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

FAQPage Schema
How do I audit Business Central AL workspaces for coding contract violations?

To audit AL workspaces for coding contract violations, use a static analysis process that checks your AL objects against a declared copilot-instructions.md contract and reports traceable findings with file and line citations.

What is static analysis for AL extension projects and how does it detect contract drift?

Static analysis for AL extension projects detects contract drift by comparing AL objects against declared project rules, identifying missing metadata, documentation, tests, permissions, and prohibited patterns without manual code review.

Do I need a copilot-instructions.md file to run a compliance check on Business Central extensions?

Yes, you need a copilot-instructions.md file to run a compliance check. This file declares the coding contract that the AL workspace is audited against to identify missing metadata, tests, permissions, and prohibited patterns.

Can I use code audits to prepare Business Central extensions for a pull request review?

Yes, you can use code audits to prepare Business Central extensions for pull request reviews. The audit identifies missing metadata, documentation, tests, permissions, and prohibited patterns before the code is merged or released.

What's the best way to structure compliance reports for AL object analysis?

The best way to structure compliance reports for AL object analysis is to organize issues by class and severity with file and line citations, ensuring traceable findings while avoiding unsupported assumptions about the codebase.

Why does my Business Central workspace have contract drift and how do I diagnose it?

Contract drift occurs when AL workspace objects no longer align with the declared coding contract. Diagnose it by applying rule-based static analysis to classify violations by severity and generate file-level remediation reporting.