verify-module

Scan module directories to validate documentation presence and structural integrity.

5|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/Catsofsuffering/CCGS --skill verify-module-catsofsuffering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verify-module
Source: https://github.com/Catsofsuffering/CCGS/tree/main/templates/skills/tools/verify-module
Command: npx skills add https://github.com/Catsofsuffering/CCGS --skill verify-module-catsofsuffering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It detects missing or underspecified module documentation and structural issues so modules are not shipped with incomplete READMEs, DESIGN files, or missing tests and source layout.

Core Features & Use Cases

  • Scans a module directory tree to confirm required files (README.md, DESIGN.md) and discover source and test directories.
  • Produces both human-readable reports and machine-readable JSON, flags size/quality issues, and returns appropriate exit codes for CI integration.
  • Use case: run as a pre-commit or post-creation check to block delivery of modules that lack design reasoning or basic usage documentation.

Quick Start

Run the verify-module scanner on the target module path to generate a completeness report.

Frequently Asked Questions about verify-module

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

FAQPage Schema
How do I verify module documentation and structure before delivery?

To verify module documentation and structure, scan the module directory tree to confirm required files like README.md and DESIGN.md are present, discover source and test directories, and flag missing or underspecified files to prevent incomplete modules from shipping.

What is a module audit in a repository workflow?

A module audit is a repository scan that validates structural integrity by checking for required documentation and test directories. It ensures modules meet documentation expectations during new module creation, refactoring, pre-commit checks, or release preparation.

Can I use a module scanner for pre-commit checks in Node.js?

Yes, you can use a module scanner for pre-commit checks in Node.js. It generates human-readable reports or JSON output with appropriate exit codes, allowing CI integration to block commits that lack design reasoning or basic usage documentation.

How do I check if my repository has missing README or DESIGN files?

To check for missing README or DESIGN files, run a module directory scan that validates documentation presence and structural integrity. The scanner flags missing or underspecified files and produces a report detailing which modules lack design reasoning or basic usage docs.

Does the module audit tool support JSON output for CI integration?

Yes, the module audit tool supports JSON output for CI integration. It produces machine-readable JSON and human-readable reports with appropriate exit codes, allowing automated workflows to fail when modules lack required documentation or test directories.