Felo Skills for Claude Code
Ask anything. Get current answers powered by AI.
Real-time web search powered by Felo AI. Works in Chinese, English, Japanese, and Korean.

Felo CLI (Terminal)
Use Felo search from the terminal without opening Claude Code.
Install
npm install -g felo-search
Or run without installing (uses latest published version):
npx felo-search search "东京天气"
After install, the command is felo (from the package name felo-search).
Configure API key
Option 1: Persist with config (recommended)
felo config set FELO_API_KEY your-api-key-here
The key is stored in ~/.felo/config.json (Windows: %USERPROFILE%\.felo\config.json). You only need to set it once.
Option 2: Environment variable
export FELO_API_KEY="your-api-key-here"
$env:FELO_API_KEY="your-api-key-here"
Get your API key from felo.ai (Settings → API Keys). Environment variable overrides config if both are set.
Commands
felo search "<query>" | Search for current info (weather, news, prices, etc.) |
felo slides "<query>" | Generate PPT from a prompt (outputs live doc URL when done) |
felo config set FELO_API_KEY <key> | Save API key to config |
felo config get FELO_API_KEY | Print stored key |
felo config list | List config keys |
felo config path | Show config file path |
felo summarize / felo translate | Planned; use felo search for now |
Examples
felo search "东京天气"
felo search "MacBook Air M3 多少钱"
felo search "React 19 new features" --verbose
felo search "杭州明天天气" --json
npx felo-search search "Tokyo weather"
CLI FAQ
- Key not found? Run
felo config set FELO_API_KEY <key> or set the FELO_API_KEY environment variable.
- Request timeout? Use
felo search "query" --timeout 120 (default 60 seconds). 5xx errors are retried automatically with backoff.
- Where is config stored? Run
felo config path to see the file (e.g. ~/.felo/config.json).
- Streaming? Not yet; when the Felo API supports streaming, the CLI can be updated to stream output.
Quick Start (Claude Code Skill)
Install the skill:
npx @claude/skills add felo-search
Get your API key from felo.ai (Settings → API Keys), then configure:
Linux/macOS:
export FELO_API_KEY="your-api-key-here"
Windows (PowerShell):
$env:FELO_API_KEY="your-api-key-here"
# For persistence, add to system environment variables
Test it works:
Ask Claude: "What's the weather in Tokyo today?"
You're done! The skill triggers automatically for any question needing current information.
Usage Examples
Daily Life
Weather
You: What's the weather in Tokyo today?
Claude: [Current temperature, conditions, forecast]
You: 杭州明天天气怎么样?
Claude: [明天杭州天气预报,温度范围,降水概率]
Restaurants & Food
You: Best ramen in Osaka
Claude: [Top-rated ramen shops with addresses, ratings, reviews]
You: 上海哪里有好吃的小笼包?
Claude: [推荐餐厅列表,地址,特色菜品]
Shopping & Prices
You: iPhone 15 Pro price comparison
Claude: [Prices from different retailers with links]
You: MacBook Air M3 多少钱?
Claude: [各渠道价格对比,优惠信息]
Travel
You: Things to do in Kyoto this weekend
Claude: [Events, attractions, seasonal activities]
You: 台北有什么好玩的地方?
Claude: [景点推荐,开放时间,交通方式]
Developer Scenarios
Latest Documentation
You: React 19 new features
Claude: [Latest React 19 features with official docs links]
You: Next.js 15 有什么新功能?
Claude: [Next.js 15 新特性总结,文档链接]
Library Comparison
You: Vite vs Webpack 2024 comparison
Claude: [Performance, features, use cases comparison]
You: Vue 3 和 React 哪个更适合新项目?
Claude: [对比分析,适用场景,社区生态]
Tech Trends
You: Latest AI developments January 2026
Claude: [Recent AI breakthroughs, company announcements]
You: 最近有什么重要的技术新闻?
Claude: [近期科技动态,行业趋势]
Multi-language Queries
Works seamlessly in:
- Chinese (Simplified): "人工智能最新进展"
- Chinese (Traditional): "台北最近有什麼新鮮事?"
- Japanese: "東京で今人気のレストランは?"
- Korean: "서울 맛집 추천"
- Mixed: "React 在中国的使用情况"
Complex Queries
Research & Analysis
You: Impact of AI on software development 2024-2026
Claude: [Comprehensive analysis with statistics, trends, expert opinions]
You: 量子计算对密码学的影响
Claude: [深度分析,技术挑战,未来展望]
Comparisons
You: Cloud providers comparison: AWS vs Azure vs GCP
Claude: [Detailed comparison table, pricing, use cases]
You: 编程语言性能对比:Python vs Go vs Rust
Claude: [性能测试数据,适用场景,学习曲线]
See 40+ more examples →
Installation Details
Prerequisites
- Claude Code CLI installed
- Node.js (for npx command)
- Internet connection
Manual Installation
If quick install doesn't work, install manually:
-
Clone this repository:
git clone https://github.com/Felo-Inc/felo-skills.git
cd felo-skills
-
Copy to Claude Code skills directory:
- Linux/macOS:
~/.claude/skills/
- Windows:
C:\Users\<YourUsername>\.claude\skills\
cp -r felo-search ~/.claude/skills/
Copy-Item -Recurse felo-search "$env:USERPROFILE\.claude\skills\"
-
Get API key from felo.ai (Settings → API Keys)
-
Set environment variable (see Quick Start section)
-
Restart Claude Code:
claude restart
Verify Installation
Check the skill is loaded:
claude skills list
You should see felo-search in the output.
Test with a query:
Ask Claude: "Latest news about quantum computing"
If you see an AI-generated answer, it's working!
FAQ
Q: Skill not triggering automatically?
A: The skill triggers for questions needing current info (weather, news, prices, etc.). For manual trigger, use:
/felo-search your query here
Q: "FELO_API_KEY not set" error?
A: Set the environment variable:
export FELO_API_KEY="your-key"
$env:FELO_API_KEY="your-key"
Then restart Claude Code.
Q: Environment variable not persisting?
A: Add to your shell profile:
- bash: Add to
~/.bashrc
- zsh: Add to
~/.zshrc
- Windows: Add to system environment variables (System Properties → Environment Variables)
Q: "INVALID_API_KEY" error?
A: Your API key is incorrect or revoked. Generate a new one at felo.ai (Settings → API Keys).
Q: Does it work in Chinese/Japanese/Korean?
A: Yes! Fully supports multi-language queries. Ask in any language, get answers in that language.
Q: What's the response format?
A: Each response includes:
- AI-generated answer - Comprehensive, well-structured
- Query analysis - Optimized search queries used
Q: "curl: command not found" error?
A: Install curl:
sudo apt install curl
brew install curl
Q: Rate limits?
A: Check your Felo account tier at felo.ai. Free tier available.
Q: Can I use it offline?
A: No, requires internet connection to Felo API.
Q: How fast are responses?
A: Typically 2-5 seconds depending on query complexity.
See full FAQ →
Available Skills
felo-search
Real-time web search with AI-generated answers.
Triggers automatically for:
- Current events & news
- Weather, prices, reviews
- Location info (restaurants, attractions)
- Latest documentation & tech trends
- Product comparisons
- Any question with "latest", "recent", "best", "how to"
View skill documentation →
Contributing
We welcome contributions! Whether you want to:
- Report bugs or request features
- Improve documentation
- Add new skills
Run CLI tests: npm test
See contributing guide →
Links
Support
License
MIT License - see LICENSE for details.
Made with ❤️ by the Felo team