inspecting-changes-skill

Pre-execution static analysis skill for AI-generated code changes.

Purpose

Analyze code changes before running them:

• Self-reflection on generated code
• Risk assessment at multiple levels
• Catching issues before they become runtime problems

Analysis Modes

| Mode | Phases | Use Case | |------|--------|----------| | quick | 1, 2, 8 | Fast pre-commit check | | medium | 1, 2, 2b, 3, 5.1, 8 | Standard review | | deep | All 9 phases | Major features, pre-deploy |

Installation

Via skills.sh (recommended)

Install skills from GitHub repository using skills manager:

npx skills add viktar-silakou/inspecting-changes-skill

Via npx (installer CLI)

If package is published to npm:

npx inspecting-changes-skill install
npx inspecting-changes-skill install --target /path/to/project

Via local clone

git clone https://github.com/viktar-silakou/inspecting-changes-skill.git
cd inspecting-changes-skill
node bin/cli.js install --target /path/to/project

Manual installation

Copy skills/inspecting-changes/ folder to:

• Project: <project>/.claude/skills/inspecting-changes/
• Global: ~/.claude/skills/inspecting-changes/

Usage (in Claude Code)

After installation:

/inspecting-changes
/inspecting-changes quick
/inspecting-changes medium
/inspecting-changes deep
/inspecting-changes deep src/api/

CLI Commands

node bin/cli.js list                                    # List available skills
node bin/cli.js install [--target /path/to/project]     # Install skill
node bin/cli.js check [--target /path/to/project]       # Check if installed
node bin/cli.js update [--target /path/to/project]      # Update skill
node bin/cli.js remove [--target /path/to/project]      # Remove skill

Skill Structure

skills/inspecting-changes/
├── SKILL.md                    # Main skill definition
├── modules/
│   ├── workflow.md             # Execution workflow with checklists
│   ├── output.md               # Output format templates
│   ├── tool-rules.md           # Read-only analysis rules
│   ├── phase-1-assessment.md   # Scope analysis
│   ├── phase-2-flow.md         # Execution flow simulation
│   ├── phase-2b-contracts.md   # Contract alignment
│   ├── phase-3-architecture.md # SOLID, smells, legacy code
│   ├── phase-4-security.md     # Security checklist
│   ├── phase-5-performance.md  # Performance with scale context
│   ├── phase-6-errors.md       # Error handling
│   ├── phase-7-testing.md      # Testability
│   └── phase-8-report.md       # Report generation
├── reference/
│   └── severity-guide.md       # Issue classification
├── examples/
│   ├── quick-output.md         # Sample quick report
│   └── deep-output.md          # Sample deep report
└── scripts/
    └── validate-skill.mjs      # Validation script

Validation

npm run validate

Requirements

• Claude Code CLI
• Node.js >= 18 (for installer/validation)

License

MIT