utils:tokf-filter

Generate and explain tokf filter files for command-line output transformation.

4|1|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/aaronbassett/agent-foundry --skill utils-tokf-filter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: utils:tokf-filter
Source: https://github.com/aaronbassett/agent-foundry/tree/main/plugins/utils/skills/tokf-filter
Command: npx skills add https://github.com/aaronbassett/agent-foundry --skill utils-tokf-filter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the creation and understanding of tokf filter files, enabling users to precisely control and transform command-line output for LLM consumption.

Core Features & Use Cases

  • Filter Authoring: Generate valid TOML filter files based on command output examples and desired transformations.
  • Step Explanation: Clarify the purpose and usage of each tokf processing step (e.g., skip, [[section]], [parse]).
  • Use Case: You need to process the output of cargo test to only show test failures and a summary. This Skill can help you write the tokf filter to achieve that.

Quick Start

Use the tokf-filter skill to create a filter for the 'git status' command that shows the branch name and counts of modified files.

Frequently Asked Questions about utils:tokf-filter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I filter command line output for LLM consumption?

To filter command line output for LLM consumption, you generate TOML filter files using tokf. These filters configure processing steps like matching, replacement, and sectioning to precisely control and transform command output.

How do I parse and extract specific sections from command output?

You can extract specific sections from command output by configuring tokf filter steps like `[[section]]` and `[parse]`. This allows you to chunk and isolate relevant data, such as extracting only test failures from a `cargo test` summary.

What is a tokf filter file and how does it transform CLI data?

A tokf filter file is a TOML configuration that defines data transformation steps for command-line output. It works by applying sequential rules for skipping, matching, replacing, and parsing text to format the final output.

Can I use tokf to process git status output?

Yes, you can use tokf to process git status output. You can configure a custom filter to extract specific information like the branch name and counts of modified files from the raw command output.

What are the limitations of using tokf filters for data transformation?

Tokf filters require you to understand TOML configuration and the specific processing steps available like skip, section, and parse. Complex or highly irregular command output may require intricate filter rules to achieve accurate transformations.