conformance-check

Evaluate shuck rule conformance against ShellCheck via corpus tests.

106|3|Updated Apr 4, 2026

Search Tags:#automation #linting #shellcheck #corpus #conformance #rule-analysis #bug-doc

Ready to run

npx skills add https://github.com/ewhauser/shuck --skill conformance-check

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: conformance-check
Source: https://github.com/ewhauser/shuck/tree/main/.claude/skills/conformance-check
Command: npx skills add https://github.com/ewhauser/shuck --skill conformance-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the evaluation of shuck rule conformance against ShellCheck by executing large corpus tests and producing a structured bug document.

Core Features & Use Cases

Resolve a rule's conformance against ShellCheck by validating rule definitions, running corpus tests, and generating a bug document in docs/bugs.
Support stepwise analysis: identify deltas, categorize patterns, and prepare an allowlist.
Use Case: A rule C001 developer wants parity with SC2086 deltas and document issues.

Quick Start

Trigger a conformance check for a rule, e.g., 'C001', to generate the docs/bugs/C001.md report.

Frequently Asked Questions about conformance-check

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

FAQPage Schema

How do I validate shell script linting rules against ShellCheck?▼

To validate shell script linting rules against ShellCheck, this automation executes large corpus tests to evaluate rule conformance, identify deltas, and generate a structured bug document for rule improvement.

What is the best way to find ShellCheck parity deltas for a custom rule?▼

Finding ShellCheck parity deltas for a custom rule involves running a large corpus test harness to compare rule behavior against ShellCheck, categorizing the resulting patterns into a structured report.

How do I generate a bug document for rule conformance issues?▼

To generate a bug document for rule conformance issues, trigger a conformance check for a specific rule like C001, which outputs categorized delta findings directly into a docs/bugs/CXXX.md file.

Do I need a large corpus test harness to check rule conformance?▼

Yes, checking rule conformance requires access to the repository's docs/rules definitions and a large corpus test harness to execute the tests and accurately produce the bug document.

Can I prepare an allowlist when analyzing ShellCheck conformance deltas?▼

Yes, you can prepare an allowlist when analyzing ShellCheck conformance deltas, as the evaluation supports stepwise analysis to identify deltas, categorize patterns, and prepare allowlists for rules.