ci-hygiene

Official

Auto-fix CI failures from external code pushes

AuthorNorfolk-Group
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Prevents and repairs common continuous integration failures introduced by external code pushes or automated agents by removing unused imports/variables, surfacing TypeScript compilation errors, and reducing secret-scanner false positives so CI stays green and developer review is focused on meaningful changes.

Core Features & Use Cases

  • ESLint unused variables: Automatically removes unused imports, prefixes unused destructured bindings with an underscore, and prefixes unused const/let declarations to satisfy @typescript-eslint/no-unused-vars and keep warnings under CI thresholds.
  • Secret scanner false positives: Detects patterns in seed and module identifiers that trigger the repo's secret-scanner and documents or whitelists known false-positive patterns to avoid blocking CI.
  • TypeScript reporting: Runs tsc to capture compilation errors and produces clear reports for manual fixes when automated remediation is insufficient.
  • When to use: After git pulls/merges, when GitHub Actions fail, before pushing changes, or when collaborating with external agents that may introduce noisy changes.
  • Workflow integration: Supports a post-pull standard workflow that auto-fixes, stages changes for review, and documents CI-related adjustments for maintainers.

Quick Start

Run the repository CI hygiene script to auto-fix lint warnings, surface TypeScript errors, and flag secret-scanner false positives.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: ci-hygiene
Download link: https://github.com/Norfolk-Group/H-Analytics/archive/main.zip#ci-hygiene

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.