← ClaudeAtlas

check-refslisted

Use when verifying cross-references between skills, rules, commands, guidelines, and context documents are not broken after edits, renames, or deletions.
event4u-app/agent-config · ★ 7 · AI & Automation · score 84
Install: claude install-skill event4u-app/agent-config
# check-refs ## When to use Use this skill when: - A skill, rule, command, guideline, or context has been renamed or deleted - Linking a newly added artifact from elsewhere in `.agent-src.uncondensed/` - Preparing a PR that touches cross-references between agent artifacts - CI's `check-refs` job failed and the broken reference needs to be located Do NOT use when: - Only the body of a single file changed and no names or paths were touched - Checking frontmatter shape or required sections — use `lint-skills` instead - Verifying condensed vs uncondensed pairs — use `bash scripts/condense.sh --check` instead ## Procedure ### 1. Inspect the scope of recent changes Identify whether any artifact was renamed, moved, or removed since the last clean run. Cross-reference checks are relevant only when names or paths shift; pure body edits cannot break references. ### 2. Dispatch via the runtime layer Invoke the skill through the runtime dispatcher so the `execution:` block in this skill's frontmatter governs the call: ```bash python3 scripts/runtime_dispatcher.py run --skill check-refs ``` The dispatcher resolves the request, the shell handler runs `python3 scripts/check_references.py`, captures stdout/stderr, and returns a typed `ExecutionResult`. ### 3. Verify the result Check the returned `ExecutionResult`: - `exit_code: 0` → all cross-references resolve - `exit_code: 1` → at least one broken reference — read `stdout` for file, line, and the offending ref, then fix th