conformance-check

Evaluate shuck rule conformance against ShellCheck via corpus tests.

106|3|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ewhauser/shuck --skill conformance-check
Or copy as Structured Prompt for Agent
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.