filter-semantic

Filter collection items using natural-language predicates with LLM evaluation.

10|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill filter-semantic
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: filter-semantic
Source: https://github.com/bdambrosio/Cognitive_workbench/tree/main/src/tools/filter-semantic
Command: npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill filter-semantic

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to semantically filter items within a collection using natural language predicates, going beyond simple keyword matching.

Core Features & Use Cases

  • Semantic Filtering: Evaluate collection items against a descriptive predicate using an LLM.
  • Flexible Modes: Supports both 'include' (return matches) and 'exclude' (return non-matches) filtering.
  • Use Case: Filter a collection of research papers to find only those that "discuss ethical implications" or exclude those that are "purely theoretical".

Quick Start

Use the filter-semantic skill to find items in $collection that mention safety.

Frequently Asked Questions about filter-semantic

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

FAQPage Schema
How do I filter a collection of data using natural language instead of exact keywords?β–Ό

You can semantically filter a collection by using an LLM evaluation callback to match items against a natural-language predicate. This goes beyond exact keyword matching to evaluate the descriptive meaning of each item.

Can I exclude specific items from my search results based on a descriptive predicate?β–Ό

Yes, you can exclude items by using the 'exclude' filtering mode, which returns non-matching items from the collection. This allows you to remove unwanted categories from your dataset based on a descriptive natural-language predicate.

What do I need to set up to perform semantic filtering on my datasets?β–Ό

Performing semantic filtering requires an LLM generation callback to evaluate items and a resource manager to handle collection operations. These prerequisites enable the system to process and refine your datasets based on natural-language predicates.

How does natural-language predicate filtering work for categorizing notes?β–Ό

Natural-language predicate filtering works by passing a descriptive condition, such as 'discuss ethical implications', to an LLM. The LLM evaluates each note in the collection to isolate specific information and categorize notes based on semantic meaning.

When should I use LLM-based semantic filtering instead of standard keyword matching?β–Ό

Use LLM-based semantic filtering when you need to refine search results or categorize items based on conceptual meaning, such as finding research papers that are 'purely theoretical'. Standard keyword matching is insufficient for evaluating these nuanced, descriptive predicates.