verifying-agnosticism

Audit repository files for hardcoded paths and project-specific references.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/pelchers/MockTrialGame --skill verifying-agnosticism
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verifying-agnosticism
Source: https://github.com/pelchers/MockTrialGame/tree/main/.claude/skills/verifying-agnosticism
Command: npx skills add https://github.com/pelchers/MockTrialGame --skill verifying-agnosticism

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Scan and fix hardcoded paths, project-specific references, and environment-coupled values in agents, skills, hooks, and orchestration files to ensure portability across repos, aiding onboarding and template reuse.

Core Features & Use Cases

  • Detects absolute and relative path literals, BASE_DIR and PROJECT_ROOT constants, and JSON workdir fields across common directories (.claude, .codex, .adr).
  • Recommends and guides fixes to replace hardcoded references with repo-root-aware patterns, improving template portability and maintainability.
  • Use Case: Onboard a new project by auditing templates and scripts to remove environment-specific references, producing a portable baseline.

Quick Start

Run the scan-hardcoded-paths.js script against a target directory to identify and report hardcoded paths.

Frequently Asked Questions about verifying-agnosticism

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

FAQPage Schema
How do I scan a repository for hardcoded paths and project-specific references?▼

Detect hardcoded paths by running the repository audit script to scan files for Windows and Unix path literals, BASE_DIR and PROJECT_ROOT constants, and JSON workdir values. It targets .claude, .codex, and related directories to ensure portability by identifying environment-coupled values.

Why do my repository templates break when onboarded to a new project environment?▼

Templates break during onboarding due to hardcoded paths and project-specific references coupling them to specific environments. Scanning for absolute path literals, BASE_DIR constants, and JSON workdir values identifies these environment-coupled values for replacement with repo-root-aware patterns.

What's the best way to fix BASE_DIR and PROJECT_ROOT constants in orchestration files?▼

Fix BASE_DIR and PROJECT_ROOT constants by auditing orchestration files for hardcoded path literals and replacing them with repo-root-aware patterns. The scan detects these constants in code and JSON workdir fields, delivering a report with guidance for portable remediation.

Does this path audit tool detect both Windows and Unix absolute path literals?▼

Yes, the path audit detects Windows and Unix absolute path literals. It scans agents, skills, hooks, and orchestration files across .claude, .codex, and related directories to identify environment-coupled values and recommends fixes to replace hardcoded references with portable patterns.

Can I use this to audit JSON workdir fields in .claude and .codex directories?▼

Yes, you can audit JSON workdir fields in .claude and .codex directories. The scanner targets these directories to detect hardcoded paths, project-specific references, and environment-coupled values, producing a report with remediation guidance to ensure template portability across diverse repos.

When should I not use automated hardcoded path scanning for repository portability?▼

Automated hardcoded path scanning should not be the sole portability check when repositories rely intentionally on environment-specific absolute paths. The scanner identifies Windows and Unix literals, BASE_DIR constants, and JSON workdir values, but manual review ensures intended project-specific references remain untouched.