path-reference-auditor

Audit file path references in plugins and skills with a SCAN, VERIFY, REPORT workflow.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill path-reference-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: path-reference-auditor
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/agent-scaffolders/skills/path-reference-auditor
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill path-reference-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audit file path references in plugins and skills to detect missing or external references.

Core Features & Use Cases

  • Phase-based audit: SCAN, VERIFY, and REPORT to inventory references.
  • Generates inventory.json for reuse across multiple checks.
  • Enforces skill-local and plugin-local boundaries for references.

Quick Start

Run the path-reference-auditor from the project root to perform a full scan.

Frequently Asked Questions about path-reference-auditor

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

FAQPage Schema
How do I audit file path references in plugins and skills to find missing links?

To audit file path references, run a three-phase workflow that scans directories, verifies internal boundaries, and reports missing or external links in an inventory.json file. This validates skill-local and plugin-local boundaries for your project.

What is the best way to validate internal boundaries for path references across multiple plugins?

Validating internal boundaries requires scanning path references to ensure files stay within skill-local or plugin-local limits. The audit generates a reusable inventory.json, supporting repeated checks and automation across your plugins and skills.

Can I automate repeated path reference checks using an inventory file?

Yes, you can automate repeated path reference checks by generating an inventory.json file during the audit report phase. This reusable inventory supports automation and allows you to verify missing or external references across multiple checks.

How does a symlink boundary check work for skills and plugins?

A symlink boundary check works by scanning file path references to detect external links that cross skill-local or plugin-local limits. The verification phase validates these boundaries and reports any missing references found during the audit.

Do I need any dependencies to run a path reference audit?

No dependencies are required to run the path reference audit. You can execute the three-phase workflow directly from the project root to scan, verify, and report on file path references without installing external packages.

Why does my skill audit report missing or external file references?

Your audit reports missing or external file references because the verification phase enforces skill-local and plugin-local boundaries. It detects any path references that point outside these limits or cannot be found within the scanned directory.