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.