How do I install the Mention Validate skill?

Run npx skillmds@latest add jmagly-ai-writing-guide/mention-validate in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Mention Validate skill do?

Validate all @-mentions resolve to existing files It is listed under Coding & Dev Tools on SkillMD.

Is Mention Validate safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mention Validate?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mention Validate free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mention Validate?

jmagly (@jmagly-ai-writing-guide) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mention Validate by jmagly-ai-writing-guide

Name: Mention Validate
Rating: 4.2 (5 reviews)
Author: jmagly

File contents

Skill access pattern (post-kernel-pivot, 2026.5+)

Skill names referenced in this document are AIWG skills, not slash commands. Most are not kernel-listed and cannot be invoked as /skill-name by the platform. Reach them via:
aiwg discover "<capability>"
aiwg show skill <name>
Only kernel-listed skills (aiwg-doctor, aiwg-refresh, aiwg-status, aiwg-help, use, steward) are directly invokable as slash commands. See skill-discovery rule.

@-Mention Validation

Validate that all @-mentions in codebase resolve to existing files.

Usage

/mention-validate                    # Validate current directory
/mention-validate --strict           # Fail on any broken mention
/mention-validate --output report.md # Write report to file

Options

Option	Default	Description
--target	.	Directory to validate
--strict	false	Exit with error on broken mentions
--output	stdout	Write report to file

Process

Scan all files for @-mention patterns
Extract @-mention paths
Resolve paths relative to repo root
Report broken/valid mentions

Output Format

@-Mention Validation Report
===========================

✓ Valid Mentions: 42
✗ Broken Mentions: 3

Broken Mentions:
  src/auth/login.ts:5
    @.aiwg/requirements/UC-999.md → NOT FOUND

  .aiwg/architecture/sad.md:23
    @.aiwg/requirements/NFR-PERF-005.md → NOT FOUND

  test/integration/api.test.ts:12
    @$AIWG_ROOT/src/services/api-old.ts → NOT FOUND (deleted?)

Summary: 3 broken mentions in 3 files

Exit Codes

Code	Meaning
0	All mentions valid
1	Broken mentions found (with --strict)

CLI Equivalent

aiwg validate-mentions [--target <dir>] [--strict]

Related Commands

mention-wire - Add @-mentions
mention-lint - Lint @-mention style
mention-report - Generate traceability report

Validate @-mentions for: $ARGUMENTS

References

@$AIWG_ROOT/agentic/code/addons/aiwg-utils/README.md — aiwg-utils addon overview
@$AIWG_ROOT/docs/cli-reference.md — CLI reference for validate-mentions command
@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Verify before reporting validity
@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC artifact paths validated by this skill

---namespace: aiwgname: mention-validateplatforms: [all]description: Validate all @-mentions resolve to existing files---> **Skill access pattern (post-kernel-pivot, 2026.5+)**>> Skill names referenced in this document are AIWG skills, **not slash commands**. Most are not kernel-listed and cannot be invoked as `/skill-name` by the platform. Reach them via:>> ```bash> aiwg discover "<capability>"> aiwg show skill <name>> ```>> Only kernel-listed skills (`aiwg-doctor`, `aiwg-refresh`, `aiwg-status`, `aiwg-help`, `use`, `steward`) are directly invokable as slash commands. See [skill-discovery rule](../../../addons/aiwg-utils/rules/skill-discovery.md).# @-Mention ValidationValidate that all @-mentions in codebase resolve to existing files.## Usage```bash/mention-validate # Validate current directory/mention-validate --strict # Fail on any broken mention/mention-validate --output report.md # Write report to file```## Options| Option | Default | Description ||--------|---------|-------------|| --target | . | Directory to validate || --strict | false | Exit with error on broken mentions || --output | stdout | Write report to file |## Process1. **Scan** all files for @-mention patterns2. **Extract** @-mention paths3. **Resolve** paths relative to repo root4. **Report** broken/valid mentions## Output Format```@-Mention Validation Report===========================✓ Valid Mentions: 42✗ Broken Mentions: 3Broken Mentions: src/auth/login.ts:5 @.aiwg/requirements/UC-999.md → NOT FOUND .aiwg/architecture/sad.md:23 @.aiwg/requirements/NFR-PERF-005.md → NOT FOUND test/integration/api.test.ts:12 @$AIWG_ROOT/src/services/api-old.ts → NOT FOUND (deleted?)Summary: 3 broken mentions in 3 files```## Exit Codes| Code | Meaning ||------|---------|| 0 | All mentions valid || 1 | Broken mentions found (with --strict) |## CLI Equivalent```bashaiwg validate-mentions [--target <dir>] [--strict]```## Related Commands- `mention-wire` - Add @-mentions- `mention-lint` - Lint @-mention style- `mention-report` - Generate traceability reportValidate @-mentions for: $ARGUMENTS## References- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/README.md — aiwg-utils addon overview- @$AIWG_ROOT/docs/cli-reference.md — CLI reference for validate-mentions command- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Verify before reporting validity- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC artifact paths validated by this skill

Frequently asked questions

Mention Validate