| name | file-system-inspector |
| description | Inspect and understand local files and directories before planning or making changes. Use when a task mentions files, folders, paths, Downloads, Documents, Desktop, reading text files, or checking current filesystem state. |
| metadata | {"author":"oneshotprompt","version":"1.0"} |
Use this skill whenever a job needs to understand local files or directories.
Workflow:
- Resolve well-known folders before guessing absolute paths.
- List the relevant directory before reading or changing anything inside it.
- For large files, inspect text length first and then read only the needed line ranges.
- Read only the text files or line ranges needed to decide on the next step.
- Summarize the current state briefly before proposing or applying changes.
Guidelines:
- Prefer the least invasive inspection that answers the task.
- If a path does not exist, report that clearly instead of inventing alternatives.
- For binary or unsupported files, report the limitation instead of pretending to inspect them.
- Prefer
GetTextFileLength and ReadTextFileLines over a full read when the file may be large.
- Never claim a filesystem change occurred from inspection alone.
