jmagly/mention-lint
plugins/utils/skills/mention-lint/SKILL.md
Lint @-mentions for style consistency and correctness
$ install --global
skillsauthnpx skillsauth add jmagly/aiwg mention-lintInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 14, 2026, 6:35 AM195.0s1 file scanned
SKILL.md
- namespace:
- aiwg
- name:
- mention-lint
- platforms:
- [all]
- description:
- Lint @-mentions for style consistency and correctness
@-Mention Linting
Validate @-mention style and fix common issues.
Usage
/mention-lint # Lint current directory
/mention-lint --fix # Auto-fix fixable issues
/mention-lint --strict # Exit with error on any issue
/mention-lint --rules ML001,ML005 # Run specific rules only
Options
| Option | Default | Description | |--------|---------|-------------| | --target | . | Directory to lint | | --fix | false | Auto-fix fixable issues | | --strict | false | Exit with error on any issue | | --rules | all | Comma-separated rule IDs |
Lint Rules
| Rule | Description | Severity | Auto-fix | |------|-------------|----------|----------| | ML001 | @-mention path does not exist | error | no | | ML002 | @-mention uses wrong case | warning | yes | | ML003 | Missing required prefix (.aiwg/, src/, test/) | warning | yes | | ML004 | Uses deprecated path pattern | warning | yes | | ML005 | Invalid ID format (UC-NNN, ADR-NNN) | warning | yes | | ML006 | Duplicate @-mentions in same file | info | yes | | ML007 | @-mention in wrong section | info | no | | ML008 | Orphan @-mention (no back-reference) | info | no | | ML009 | Circular @-mention chain | warning | no | | ML010 | @-mention exceeds max depth (>3 hops) | warning | no |
Output Example
src/services/auth/login.ts
L3: ML005 @.aiwg/requirements/UC-3-auth.md should be UC-003 (auto-fixable)
L5: ML001 @.aiwg/architecture/adrs/ADR-999.md does not exist
test/integration/auth.test.ts
L2: ML003 @auth/login.ts should be @$AIWG_ROOT/src/auth/login.ts (auto-fixable)
.aiwg/architecture/software-architecture-doc.md
L45: ML008 References @.aiwg/requirements/UC-005.md but no back-reference
Summary: 4 issues (1 error, 2 warnings, 1 info)
3 auto-fixable (run with --fix)
Rule Details
ML001: Path Does Not Exist
Error: @.aiwg/requirements/UC-999.md → file not found
Not auto-fixable. Remove reference or create file.
ML002: Wrong Case
Warning: @.aiwg/Requirements/UC-001.md should be @.aiwg/requirements/UC-001.md
Fix: Correct case to match filesystem
ML003: Missing Prefix
Warning: @auth/login.ts should be @$AIWG_ROOT/src/auth/login.ts
Fix: Add appropriate prefix
ML004: Deprecated Pattern
Warning: @requirements/UC-001.md should be @.aiwg/requirements/UC-001.md
Fix: Update to current pattern
ML005: Invalid ID Format
Warning: UC-3 should be UC-003 (3-digit format)
Warning: ADR-5-auth should be ADR-005-auth
Fix: Zero-pad numeric IDs
ML006: Duplicate Mentions
Info: @.aiwg/requirements/UC-001.md appears 3 times
Fix: Remove duplicates, keep first occurrence
CLI Equivalent
aiwg mention-lint [--target <dir>] [--fix] [--strict]
Related Commands
/mention-wire- Add @-mentions/mention-validate- Validate @-mentions exist/mention-conventions- Display conventions
Lint @-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 mention-lint command
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Verify paths exist before referencing
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC artifacts that use @-mention conventions
Related Skills
jmagly/radar-status
data-ai
VerifiedTrustedCommunity
Report which research-corpus radar sidecars are overdue for refresh. Computes staleness (days since last refresh vs the cadence window) for every radar, sorted most-overdue-first. Runs via `aiwg corpus radar-status`.
140SKILL.mdUpdated May 28, 2026
jmagly/radar-report
data-ai
VerifiedTrustedCommunity
Aggregate research-corpus radar sidecars into a corpus or per-cluster freshness report — totals, overdue count, per-cluster / per-GRADE / per-trajectory breakdowns, an overdue table, and per-radar rationale snippets. Runs via `aiwg corpus radar-report`.
140SKILL.mdUpdated May 28, 2026
jmagly/radar-init
testing
VerifiedTrustedCommunity
Scaffold radar/freshness sidecars for research-corpus REFs. Pulls title/authors from the citation sidecar and GRADE from the analysis doc, defaults the refresh cadence from GRADE and the cluster from a corpus-local map, and stamps documentation/radar/REF-XXX-radar.md. Runs via `aiwg corpus radar-init`.
140SKILL.mdUpdated May 28, 2026
jmagly/profile-temporal
data-ai
VerifiedTrustedCommunity
Compute an entity's publication trajectory — per-year paper counts, topic drift, hot-streak detection (≥3 consecutive A-grade years), and career phase. Runs via `aiwg corpus profile-temporal`.
140SKILL.mdUpdated May 28, 2026