instruction-imports-valid

Import references (@path) in AGENTS.md, CLAUDE.md, and GEMINI.md must point to existing files

Severity	warning (auto)
Autofix	-
Since	v0.1.0
Category	Instruction Files

Why

@path import references in instruction files tell the agent to include additional context at load time. An import that points to a nonexistent file is silently skipped — the instructions it was supposed to provide are missing, and no error is surfaced.

Examples

Bad:

@docs/old-guidelines.md

Good:

@docs/guidelines.md

How to fix

Update the import path to point to the correct file. If the file was deleted or renamed, either update the reference or remove the import line. Imports must not escape the repository root.

Configuration

rules:
  instruction-imports-valid:
    enabled: auto  # true | false | auto
    severity: warning

Run skillsaw explain instruction-imports-valid to see this documentation and the rule's effective configuration in your terminal.