terrylica Navigation: Plugin CLAUDE.md | Root CLAUDE.md
Global Ignore Patterns
Manage global ignore patterns for the lint-relative-paths linter.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Purpose
Some repositories intentionally use relative paths in markdown (e.g., ../docs/file.md)
instead of repo-root paths (e.g., /docs/file.md). This command manages a global ignore
file that skips path validation for matching workspaces.
Actions
| Action | Description | Example |
|---|---|---|
add |
Add a pattern to the global ignore file | /statusline-tools:ignore add my-repo |
list |
Show current patterns | /statusline-tools:ignore list |
remove |
Remove a pattern from the ignore file | /statusline-tools:ignore remove my-repo |
Pattern Matching
Patterns use substring matching. A pattern matches if the workspace path contains the pattern.
Example: Pattern alpha-forge matches:
/Users/user/projects/alpha-forge/Users/user/eon/alpha-forge.worktree-feature-x/home/user/code/alpha-forge-v2
Ignore File Location
~/.claude/lint-relative-paths-ignore
Lines starting with # are comments.
Execution
Skip Logic
- If action + pattern provided -> execute directly
- If only
listprovided -> show patterns immediately - If no arguments -> use AskUserQuestion flow
Workflow
- Check Current State: Run
listto show existing patterns - Action Selection: Use AskUserQuestion to select action:
- "Add a new pattern" -> prompt for pattern
- "Remove an existing pattern" -> show current patterns to select
- "Just view current patterns" -> display and exit
- Pattern Input: For add/remove, AskUserQuestion with examples
- Execute: Run the management script
- Verify: Confirm changes applied
AskUserQuestion Flow (No Arguments)
When invoked without arguments, guide the user interactively:
Question: "What would you like to do with lint-relative-paths ignore patterns?"
Options:
- "Add pattern" -> "Add a new repository pattern to skip path linting"
- "List patterns" -> "Show all current ignore patterns"
- "Remove pattern" -> "Remove an existing pattern from the ignore list"
For "Add pattern":
Question: "Enter the repository pattern to ignore"
Note: Patterns use substring matching. Example: 'alpha-forge' matches any path containing 'alpha-forge'.
Direct Execution (With Arguments)
Parse $ARGUMENTS and run the management script:
/usr/bin/env bash << 'IGNORE_SCRIPT_EOF'
PLUGIN_DIR="$(cc-plugin-root statusline-tools)"
bash "$PLUGIN_DIR/scripts/manage-ignore.sh" $ARGUMENTS
IGNORE_SCRIPT_EOF
Manual Editing
The ignore file can also be edited manually:
# View current patterns
cat ~/.claude/lint-relative-paths-ignore
# Add a pattern manually
echo "my-repo-pattern" >> ~/.claude/lint-relative-paths-ignore
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Pattern not matching | Substring match is strict | Use broader pattern (e.g., forge vs alpha-forge) |
| Ignore file not found | ~/.claude doesn't exist | Create with mkdir -p ~/.claude |
| Permission denied | File not writable | Check file permissions with ls -la |
| Script not found | Plugin not installed | Reinstall plugin from marketplace |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.