felo-x-search — Claude Code skill: what it does, how to install
A skill for Claude Code and Codex that searches X (Twitter) data through the Felo X Search API. It triggers on queries about user profiles, tweets, trending topics, and replies.
no license 106 installs ★ 251 updated 2026-07-22
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a claude-codeWhat felo-x-search does
This skill queries X data to retrieve profiles, search tweets, track discussions, and pull replies. Output comes formatted as Markdown with engagement statistics or as raw JSON when using the --json option. Tweet searches support pagination cursors and time range parameters like --since-time and --until-time.
Execution runs through the felo x CLI command, the bundled Node script, or direct HTTP calls to Felo OpenAPI endpoints. It does not handle broad web searches or page scraping, which rely on separate companion skills.
Requests fail with INVALID_API_KEY unless the FELO_API_KEY environment variable holds a valid token created on felo.ai.
What it helps with
- search X posts by keyword and time boundaries
- inspect user profile statistics and follower counts
- fetch discussion replies for a specific post ID
- retrieve recent posts published by an account
Example prompts for the agent
- Search X for recent discussions about the latest Claude release
- Look up the X profile for @elonmusk and show recent posts
- /felo-x-search get replies for tweet ID 1234567890
How to install felo-x-search
1Skills CLI (Vercel)
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a claude-code2Manually: put the files in place
~/.claude/skills/felo-x-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/felo-x-search/
1Skills CLI (Vercel)
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a codex2Manually: put the files in place
.agents/skills/felo-x-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a cursor2Manually: put the files in place
.cursor/skills/felo-x-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Felo-Inc/felo-skills felo-x-search2Manually: put the files in place
.github/skills/felo-x-search/SKILL.md1Skills CLI (Vercel)
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/Felo-Inc/felo-skills --path felo-x-searchManually: put the files in place
.devin/skills/felo-x-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about felo-x-search
How to install felo-x-search in Claude Code?
Run npx skills add Felo-Inc/felo-skills --skill felo-x-search -a claude-code.
What does felo-x-search do?
It queries the Felo X Search API to look up accounts, search posts by keyword, fetch replies, and output Markdown or raw JSON.
What is required to run felo-x-search?
You need an API key generated in settings on felo.ai, exported as FELO_API_KEY. CLI execution also requires Node.js or the globally installed felo-ai package.