ReddRadar
Agent skill
search-articles
Query articles using category filters and BM25 keyword search
Install this agent skill to your Project
npx add-skill https://github.com/GuillermoLB/fastpaip-app/tree/main/skills/search-articles.skill
SKILL.md
Search Articles
Query articles using structured category filters and BM25 full-text keyword search.
Usage
# List available categories
python search.py --list-categories
# Browse all articles
python search.py --limit 10
# Filter by categories
python search.py --categories NEWS SCIENTIFIC
# Keyword search (BM25 full-text search)
python search.py --keywords "machine learning"
# Combined filters
python search.py --categories SCIENTIFIC --keywords "biology"
# JSON output for piping
python search.py --keywords "API" --format json | jq '.results[].id'
Parameters
| Parameter | Type | Description |
|---|---|---|
--list-categories |
flag | List all available article categories |
--categories |
list | Filter by categories (NEWS, SCIENTIFIC, etc.) |
--keywords |
string | BM25 full-text search keywords |
--limit |
int | Maximum results (default: 10) |
--offset |
int | Pagination offset (default: 0) |
--format |
choice | Output: table, json, csv |
--output |
path | Output file for json/csv |
Output Formats
Table (default)
Search Results (3 found)
┏━━━━┳━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID ┃ Category ┃ Score ┃ Snippet ┃
┡━━━━╇━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 6 │ SCIENTIFIC │ 0.15 │ ...machine learning... │
└────┴────────────┴───────┴──────────────────────────┘
JSON
{
"results": [
{
"id": 6,
"raw_article": "...",
"category": "SCIENTIFIC",
"keyword_score": 0.15,
"snippet": "...machine learning..."
}
],
"metadata": {
"total_results": 3,
"query_time_ms": 42.5,
"strategies_used": ["bm25_keyword_search", "category_filter"]
}
}
CSV
id,raw_article,category,keyword_score,snippet
6,"...","SCIENTIFIC",0.15,"...machine learning..."
Examples
See references/examples.md for 30+ usage examples including:
- Category filtering
- Keyword search strategies
- Date range queries
- Pagination
- Composing with jq, grep, and other tools
- Batch processing workflows
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mattpocock/skills
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
mattpocock/skills
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
mattpocock/skills
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
mattpocock/skills
migrate-to-shoehorn
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
mattpocock/skills
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
mattpocock/skills
handoff
Compact the current conversation into a handoff document for another agent to pick up.
Didn't find tool you were looking for?