spec-check

Audit GWT acceptance specifications for implementation language leakage.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/eykd/vance-ts --skill spec-check-eykd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-check
Source: https://github.com/eykd/vance-ts/tree/main/.claude/skills/spec-check
Command: npx skills add https://github.com/eykd/vance-ts --skill spec-check-eykd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of auditing GWT acceptance specs for implementation language leakage, helping developers enforce clean domain language and maintain a robust, maintainable codebase.

Core Features & Use Cases

  • Spec Audit: Inspects GIVEN, WHEN, and THEN statements for implementation language.
  • Custom File Audit: Audits a specific file or all files in a specified directory.
  • Error Reporting: Provides a summary table of findings with suggested rewrites.
  • Clean Language Enforcement: Reports violations of clean domain language.

Quick Start

To audit the acceptance specs in 'specs/acceptance-specs', run the spec-check skill.

Frequently Asked Questions about spec-check

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

FAQPage Schema
How do I check GWT acceptance specs for implementation language leakage?

You can audit GWT acceptance specs for implementation language leakage by running a script that parses GIVEN, WHEN, and THEN statements to detect framework-specific code and enforce clean domain language.

What is implementation language leakage in acceptance specifications?

Implementation language leakage in acceptance specifications occurs when framework-specific code appears in GIVEN, WHEN, and THEN statements, violating clean domain language and reducing spec maintainability.

How do I audit a directory of acceptance spec files for clean domain language violations?

You audit a directory of acceptance spec files for clean domain language violations by running a Python parsing script that inspects all files, detects implementation leakage, and outputs a summary table with suggested rewrites.

Do I need Python to run a GWT spec audit for framework-specific code?

Yes, you need a Python environment with specific parsing and reporting modules to run a GWT spec audit, as the script relies on these dependencies to detect framework-specific code and generate violation reports.

How does an acceptance spec auditor report clean language violations?

An acceptance spec auditor reports clean language violations by generating a summary table of findings, detailing instances of implementation leakage and providing suggested rewrites to restore clean domain language.

When should I audit my acceptance specs for implementation leakage?

You should audit your acceptance specs for implementation leakage when enforcing clean domain language, ensuring GIVEN, WHEN, and THEN statements remain maintainable and free of framework-specific code.