Skip to content
Documentation
Command

/lint

Report drift between FILETREE.md and current repo, read-only. Prompts to run /filetree:update on drift.

BOOST
From plugin
filetree
1624 skills4 commands1 hook
Install
> /plugin marketplace add nekocode/filetree-skill
> /plugin install filetree@filetree

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/lint

Context preview

What this command does when you run it.

Report drift between FILETREE.md and current repo, read-only. Prompts to run /filetree:update on drift.

Command definition

lint.md
description: Report drift between FILETREE.md and current repo, read-only. Prompts to run /filetree:update on drift.
allowed-tools: Bash(python3:*)

Run the drift check and present results to the user:

python3 "${CLAUDE_PLUGIN_ROOT}/skills/filetree/scripts/filetree.py" lint

The script outputs JSON and exits 1 if there is any drift, 0 if clean.

Format the JSON for the user, grouped by category (added / changed / removed / renamed) with counts. If `stats.need_llm > 0` or there are any `removed` / `renamed` entries, remind the user to run `/filetree:update` to sync.

Do not call any LLM. Do not modify any files. Do not load the filetree SKILL.md — lint is pure script invocation, no shared rules apply here.

Do not echo the raw JSON back to the user verbatim. A summary of counts plus the drift paths (truncated if many) is enough; users can re-run the script if they want full output.

Ships withfiletree

A Claude Code plugin that maintains FILETREE.md — a one-line description per file with content hashes for staleness detection. Lets the LLM grasp repo layout in a few hundred tokens before touching code.

Get the whole plugin
Stats
162
Stars
13
Forks
Maintained
Maintenance
Python
Language
3mo ago
Last commit
4mo ago
Created
2h ago
Added

Repo: nekocode/filetree-skill

Other commands on filetree.