Skip to main content
skill CX Codex

source-command-verify-setup — Claude Code skill: setup guide

source-command-verify-setup executes infrastructure health checks and repairs broken configurations or hook dependencies.

MIT ★ 10,055 updated 2026-07-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add diet103/claude-code-infrastructure-showcase --skill source-command-verify-setup -a claude-code
Open on GitHub

What source-command-verify-setup does

The skill runs bash .Codex/scripts/verify-setup.sh from your project root to audit the setup. When it spots a [FAIL] line, it applies targeted remedies: runs npm install inside .Codex/hooks, assigns execution flags to shell scripts, and repairs broken JSON syntax in settings.json or skill-rules.json without altering actual parameters. If dead hooks remain registered in configuration files, it asks whether to copy them from the showcase repository or clear the entries.

Lines marked with [WARN] signal optional utilities, such as jq tracking or telemetry keys. The skill deliberately avoids installing system packages or injecting API keys autonomously. It describes the purpose of each warning and leaves the decision to you, looping the test script until failures drop to zero.

What it helps with

  • repair broken JSON syntax inside agent configuration files
  • install missing npm packages required by hooks
  • assign executable permissions to local shell scripts
  • verify agent hook infrastructure before starting tasks

Example prompts for the agent

  • Run verify-setup and fix all failing checks in the environment
  • Audit our agent infrastructure using source-command-verify-setup
  • Check the scripts in .Codex and resolve all execution errors

How to install source-command-verify-setup

1Skills CLI (Vercel)

npx skills add diet103/claude-code-infrastructure-showcase --skill source-command-verify-setup -a claude-code

2Manually: put the files in place

~/.claude/skills/source-command-verify-setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/source-command-verify-setup/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about source-command-verify-setup

How to install source-command-verify-setup in Claude Code?

Run npx skills add diet103/claude-code-infrastructure-showcase --skill source-command-verify-setup -a claude-code in your terminal.

What does source-command-verify-setup do?

It triggers verify-setup.sh and iteratively fixes script permissions, dependencies, and JSON errors until zero failures remain.

Does the skill install missing tools or API keys automatically?

No, it leaves system packages and credentials untouched. It summarizes each [WARN] item so you can choose whether to enable that feature.

Source text

SKILL.md · MIT
---
name: "source-command-verify-setup"
description: "Run the infrastructure health check and fix anything that fails"
---

# source-command-verify-setup

Use this skill when the user asks to run the migrated source command `verify-setup`.

## Command Template

Run the Codex infrastructure health check and get it fully green.

## Steps

1. Run the health check from the project root:
   ```bash
   bash .Codex/scripts/verify-setup.sh
   ```

2. For every `[FAIL]` line, apply the printed fix. Common fixes:
   - Dependencies missing: `cd .Codex/hooks && npm install`
   - Scripts not executable: `chmod +x .Codex/hooks/*.sh`
   - Invalid JSON in `.Codex/settings.json` or `.Codex/skills/skill-rules.json`: read the file, find the syntax error (usually a trailing comma), and repair it without changing any settings values
   - Missing hook scripts registered in settings.json: ask the user whether to copy them from the showcase repo (https://github.com/diet103/Codex-infrastructure-showcase) or remove the dead registrations

3. Re-run the script after each fix until it reports 0 failed.

4. `[WARN]` lines are optional features (session intelligence, jq-based file tracking, AI classification keys). Do NOT install API keys or system packages on the user's behalf - summarize what each warning means and let the user decide.

5. Report the final result to the user: what was broken, what you fixed, and what (if anything) remains as a warning.

© diet103 · MIT · diet103/claude-code-infrastructure-showcase

Similar skills

All skills for Agent setup: memory, context, orchestration →
cyrus-setup-prerequisites cyrusagents cyrus-setup-prerequisites — a Claude Code skill that checks system prerequisites before installing Cyrus and puts cyrus-ai in place. Runs on Node.js 18+ and keeps secrets in ~/.cyrus/.env out of the conversation. CX Codex +1 1,100installs vm-disk-cleanup MSApps-Mobile vm-disk-cleanup clears disk-eating caches and build artifacts in Claude environments to resolve ENOSPC errors. ★ 11repo stars cross-source-verify тандем, на основе Anthropic enterprise-search + counterparty-guard 15.06.2026 cross-source-verify is a Claude Code skill that cross-references company data across public registries, aggregators, and the web. It flags conflicting records and scores confidence for company verification. CX Codex +1 ★ 38repo stars gcp-setup Google The gcp-setup skill checks and aligns identities across gcloud, Application Default Credentials, and kubectl at the start of your session. Use it to ensure all three systems authenticate as the same user before you begin working with GCP. CX Codex +1 ★ 151repo stars setup-pm Affaan Mustafa setup-pm — a command to configure which package manager (npm, pnpm, yarn, or bun) Claude Code uses in your project or globally. Use it when you want to enforce a specific manager across your workflow. CX Codex +1 ★ 6,739repo stars attester-verify-packages official github attester-verify-packages is a GitHub Copilot rule that checks PyPI and npm package and symbol names through attester.dev before installation or import, helping prevent invented dependencies. CX Codex +1 ★ 41,430repo stars

From the same set16

The whole set →
route-research-for-testing route-research-for-testing is a Claude Code command that collects changed routes from the current session and tests them via cURL to check edited API endpoints. CX Codex +1 ★ 10,055repo stars verify-setup verify-setup — a command that diagnoses your project's infrastructure, identifies what's broken, and guides you through fixes. Use it when Claude Code hooks, dependencies or configs fail. CX Codex +1 ★ 10,055repo stars dev-docs-update The dev-docs-update command records active work before a context reset, covering task files, project memory, unfinished work, and handoff notes. CX Codex +1 ★ 10,055repo stars dev-docs dev-docs generates a detailed implementation plan for any task: analyzes your codebase, breaks work into phases, creates task checklists with dependencies and effort estimates, and persists across context switches. CX Codex +1 ★ 10,055repo stars auto-error-resolver auto-error-resolver is a subagent that fixes TypeScript compilation errors from hook reports and verifies the build with tsc. CX Codex ★ 10,055repo stars frontend-error-fixer The frontend-error-fixer subagent investigates frontend failures during builds and in the browser. Use it for TypeScript, React, network, and rendering problems. CX Codex ★ 10,055repo stars refactor-planner refactor-planner — a subagent that studies your code structure and writes a phased refactoring plan with risk assessment. Use it before reworking a legacy module or an oversized component. CX Codex ★ 10,055repo stars plan-reviewer plan-reviewer reviews technical plans, migrations, and system integrations before writing code. Catches architectural traps, missing dependencies, and edge cases early. CX Codex ★ 10,055repo stars

Project sponsors

Companies that keep this analytics open