// Find missed token savings in Claude Code sessions and create filters for unfiltered commands
This skill should be used when the user asks to "create a filter", "write a tokf filter", "add a filter for <tool>", "how do I filter output", or needs guidance on tokf filter step types, templates, pipes, or placement conventions.
Find missed token savings by scanning AI coding session files for commands that ran without tokf filtering.
Compress verbose CLI output with tokf before returning results. Activates for git, cargo, npm, docker, go, gradle, kubectl, and other supported commands.
| name | tokf-discover |
| description | Find missed token savings in Claude Code sessions and create filters for unfiltered commands |
| user_invocable | true |
Use this skill to analyze Claude Code sessions and find commands that are running without tokf filtering, wasting tokens on verbose output.
Run tokf discover in the project directory to scan recent sessions:
tokf discover
--all — scan all projects, not just the current one--since 7d — only scan sessions from the last 7 days (also 24h, 30m)--limit 0 — show all results (default: top 20)--json — output as JSON for programmatic use--session <path> — scan a specific session file--project <path> — scan sessions for a specific project pathThe output shows:
tokf discover to identify top savings opportunitiestokf hook install to set up automatic filtering/tokf-filter skill to create a custom filtertokf discover after changes to verify improvementIf tokf discover shows commands with no matching filter, create one:
# See what a filter would look like
tokf which "the-command --args"
# Use the tokf-filter skill to create a proper filter
# /tokf-filter
Use --json for integration with other tools:
tokf discover --json | jq '.results[] | select(.estimated_savings > 1000)'
The JSON schema includes:
sessions_scanned — number of JSONL files processedtotal_commands — all Bash commands foundalready_filtered — commands already using tokffilterable_commands — commands with available filtersno_filter_commands — commands with no matching filterestimated_total_savings — total estimated token savingsresults[] — per-command breakdown sorted by savings