felo-ai 0.2.0 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +2 -1
- package/README.md +48 -48
- package/docs/EXAMPLES.md +143 -192
- package/docs/FAQ.md +4 -4
- package/felo-search/README.md +92 -147
- package/felo-search/SKILL.md +17 -18
- package/felo-slides/LICENSE +21 -0
- package/felo-slides/README.md +87 -0
- package/felo-slides/SKILL.md +154 -0
- package/felo-slides/scripts/run_ppt_task.mjs +251 -0
- package/package.json +2 -2
- package/src/cli.js +7 -5
- package/src/slides.js +39 -19
- package/README.ja.md +0 -87
- package/README.ko.md +0 -87
- package/README.zh-CN.md +0 -87
- package/README.zh-TW.md +0 -87
package/README.en.md
CHANGED
|
@@ -84,4 +84,5 @@ After setting `FELO_API_KEY`, ask Claude things like “What’s the weather in
|
|
|
84
84
|
|
|
85
85
|
---
|
|
86
86
|
|
|
87
|
-
**Other languages
|
|
87
|
+
**Other languages:** [Chinese (Simplified)](README.zh-CN.md) | [Japanese](README.ja.md) | [Korean](README.ko.md) | [Chinese (Traditional)](README.zh-TW.md)
|
|
88
|
+
|
package/README.md
CHANGED
|
@@ -1,55 +1,30 @@
|
|
|
1
|
-
# Felo
|
|
1
|
+
# Felo Skills for Claude Code
|
|
2
2
|
|
|
3
3
|
**Ask anything. Get current answers powered by AI.**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Real-time web search powered by Felo AI. Works in Chinese, English, Japanese, and Korean.
|
|
6
6
|
|
|
7
7
|
[]() []()
|
|
8
8
|
|
|
9
|
-
**Other languages:** [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [繁體中文](README.zh-TW.md)
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## Two Core Capabilities
|
|
14
|
-
|
|
15
|
-
Felo AI offers two main features: **Real-time Search** and **PPT Generation**. Use them via the CLI in your terminal, or in Claude Code via the skill (search can trigger automatically).
|
|
16
|
-
|
|
17
|
-
### Capability 1: Real-time Search
|
|
18
|
-
|
|
19
|
-
Search the web for up-to-date information and get AI-synthesized answers. Ideal for weather, news, prices, documentation, tech updates, and any question that needs “right now” information.
|
|
20
|
-
|
|
21
|
-
- **Multi-language**: Ask in your preferred language.
|
|
22
|
-
- **Terminal**: `felo search "your question"`
|
|
23
|
-
- **Claude Code**: After installing the skill, it triggers automatically, or type `/felo-ai your question`
|
|
24
|
-
- **Examples**: `felo search "Tokyo weather"`, `felo search "React 19 new features" --verbose`
|
|
25
|
-
|
|
26
|
-
### Capability 2: Generate PPT
|
|
27
|
-
|
|
28
|
-
Describe a topic in one sentence and Felo generates a slideshow. The job runs in the cloud; when done, you get an **online document link** to open in your browser.
|
|
29
|
-
|
|
30
|
-
- **Terminal**: `felo slides "your topic or description"`
|
|
31
|
-
- **Options**: `--verbose` for polling status, `--json` for raw JSON (`task_id`, `live_doc_url`).
|
|
32
|
-
- **Examples**: `felo slides "Felo product intro, 3 slides"`, `felo slides "Introduction to React"`, `felo slides "Quarterly review" --poll-timeout 300`
|
|
33
|
-
|
|
34
9
|
---
|
|
35
10
|
|
|
36
11
|
## Felo CLI (Terminal)
|
|
37
12
|
|
|
38
|
-
Use Felo from the terminal without opening Claude Code.
|
|
13
|
+
Use Felo search from the terminal without opening Claude Code.
|
|
39
14
|
|
|
40
15
|
### Install
|
|
41
16
|
|
|
42
17
|
```bash
|
|
43
|
-
npm install -g felo-
|
|
18
|
+
npm install -g felo-search
|
|
44
19
|
```
|
|
45
20
|
|
|
46
|
-
|
|
21
|
+
Or run without installing (uses latest published version):
|
|
47
22
|
|
|
48
23
|
```bash
|
|
49
|
-
npx felo-
|
|
24
|
+
npx felo-search search "Tokyo weather"
|
|
50
25
|
```
|
|
51
26
|
|
|
52
|
-
After install, the command is `felo` (from package name `felo-
|
|
27
|
+
After install, the command is `felo` (from the package name `felo-search`).
|
|
53
28
|
|
|
54
29
|
### Configure API key
|
|
55
30
|
|
|
@@ -75,12 +50,14 @@ Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys). Enviro
|
|
|
75
50
|
|
|
76
51
|
### Commands
|
|
77
52
|
|
|
78
|
-
| Command
|
|
79
|
-
|
|
80
|
-
| `felo search "<query>"`
|
|
81
|
-
| `felo
|
|
82
|
-
| `felo config
|
|
83
|
-
| `felo config
|
|
53
|
+
| Command | Description |
|
|
54
|
+
| ------------------------------------ | ----------------------------------------------------- |
|
|
55
|
+
| `felo search "<query>"` | Search for current info (weather, news, prices, etc.) |
|
|
56
|
+
| `felo config set FELO_API_KEY <key>` | Save API key to config |
|
|
57
|
+
| `felo config get FELO_API_KEY` | Print stored key |
|
|
58
|
+
| `felo config list` | List config keys |
|
|
59
|
+
| `felo config path` | Show config file path |
|
|
60
|
+
| `felo summarize` / `felo translate` | Planned; use `felo search` for now |
|
|
84
61
|
|
|
85
62
|
### Examples
|
|
86
63
|
|
|
@@ -89,7 +66,7 @@ felo search "Tokyo weather"
|
|
|
89
66
|
felo search "MacBook Air M3 price"
|
|
90
67
|
felo search "React 19 new features" --verbose
|
|
91
68
|
felo search "Hangzhou tomorrow weather" --json
|
|
92
|
-
npx felo-
|
|
69
|
+
npx felo-search search "Tokyo weather"
|
|
93
70
|
```
|
|
94
71
|
|
|
95
72
|
### CLI FAQ
|
|
@@ -106,24 +83,27 @@ npx felo-ai search "Tokyo weather"
|
|
|
106
83
|
Install the skill:
|
|
107
84
|
|
|
108
85
|
```bash
|
|
109
|
-
npx @claude/skills add felo-
|
|
86
|
+
npx @claude/skills add felo-search
|
|
110
87
|
```
|
|
111
88
|
|
|
112
89
|
Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys), then configure:
|
|
113
90
|
|
|
114
91
|
**Linux/macOS:**
|
|
92
|
+
|
|
115
93
|
```bash
|
|
116
94
|
export FELO_API_KEY="your-api-key-here"
|
|
117
95
|
# Add to ~/.bashrc or ~/.zshrc for persistence
|
|
118
96
|
```
|
|
119
97
|
|
|
120
98
|
**Windows (PowerShell):**
|
|
99
|
+
|
|
121
100
|
```powershell
|
|
122
101
|
$env:FELO_API_KEY="your-api-key-here"
|
|
123
102
|
# For persistence, add to system environment variables
|
|
124
103
|
```
|
|
125
104
|
|
|
126
105
|
Test it:
|
|
106
|
+
|
|
127
107
|
```
|
|
128
108
|
Ask Claude: "What's the weather in Tokyo today?"
|
|
129
109
|
```
|
|
@@ -137,24 +117,28 @@ Ask Claude: "What's the weather in Tokyo today?"
|
|
|
137
117
|
### Daily life
|
|
138
118
|
|
|
139
119
|
**Weather**
|
|
120
|
+
|
|
140
121
|
```
|
|
141
122
|
You: What's the weather in Tokyo today?
|
|
142
123
|
Claude: [Current temperature, conditions, forecast]
|
|
143
124
|
```
|
|
144
125
|
|
|
145
126
|
**Restaurants & food**
|
|
127
|
+
|
|
146
128
|
```
|
|
147
129
|
You: Best ramen in Osaka
|
|
148
130
|
Claude: [Top-rated ramen shops with addresses, ratings, reviews]
|
|
149
131
|
```
|
|
150
132
|
|
|
151
133
|
**Shopping & prices**
|
|
134
|
+
|
|
152
135
|
```
|
|
153
136
|
You: iPhone 15 Pro price comparison
|
|
154
137
|
Claude: [Prices from different retailers with links]
|
|
155
138
|
```
|
|
156
139
|
|
|
157
140
|
**Travel**
|
|
141
|
+
|
|
158
142
|
```
|
|
159
143
|
You: Things to do in Kyoto this weekend
|
|
160
144
|
Claude: [Events, attractions, seasonal activities]
|
|
@@ -163,18 +147,21 @@ Claude: [Events, attractions, seasonal activities]
|
|
|
163
147
|
### Developer scenarios
|
|
164
148
|
|
|
165
149
|
**Latest documentation**
|
|
150
|
+
|
|
166
151
|
```
|
|
167
152
|
You: React 19 new features
|
|
168
153
|
Claude: [Latest React 19 features with official docs links]
|
|
169
154
|
```
|
|
170
155
|
|
|
171
156
|
**Library comparison**
|
|
157
|
+
|
|
172
158
|
```
|
|
173
159
|
You: Vite vs Webpack 2024 comparison
|
|
174
160
|
Claude: [Performance, features, use cases comparison]
|
|
175
161
|
```
|
|
176
162
|
|
|
177
163
|
**Tech trends**
|
|
164
|
+
|
|
178
165
|
```
|
|
179
166
|
You: Latest AI developments January 2026
|
|
180
167
|
Claude: [Recent AI breakthroughs, company announcements]
|
|
@@ -201,12 +188,14 @@ Works in Chinese (Simplified & Traditional), Japanese, Korean, and English. Ask
|
|
|
201
188
|
If quick install doesn’t work:
|
|
202
189
|
|
|
203
190
|
1. Clone this repository:
|
|
191
|
+
|
|
204
192
|
```bash
|
|
205
193
|
git clone https://github.com/Felo-Inc/felo-skills.git
|
|
206
194
|
cd felo-skills
|
|
207
195
|
```
|
|
208
196
|
|
|
209
197
|
2. Copy to Claude Code skills directory:
|
|
198
|
+
|
|
210
199
|
- **Linux/macOS:** `~/.claude/skills/`
|
|
211
200
|
- **Windows:** `C:\Users\<YourUsername>\.claude\skills\`
|
|
212
201
|
|
|
@@ -230,9 +219,9 @@ If quick install doesn’t work:
|
|
|
230
219
|
claude skills list
|
|
231
220
|
```
|
|
232
221
|
|
|
233
|
-
You should see `felo-
|
|
222
|
+
You should see `felo-search` in the output.
|
|
234
223
|
|
|
235
|
-
Test: ask Claude
|
|
224
|
+
Test: ask Claude _"Latest news about quantum computing"_. If you see an AI-generated answer, it’s working.
|
|
236
225
|
|
|
237
226
|
---
|
|
238
227
|
|
|
@@ -240,7 +229,11 @@ Test: ask Claude *"Latest news about quantum computing"*. If you see an AI-gener
|
|
|
240
229
|
|
|
241
230
|
### Q: Skill not triggering automatically?
|
|
242
231
|
|
|
243
|
-
**A:** The skill triggers for questions needing current info (weather, news, prices, etc.). For manual trigger, use
|
|
232
|
+
**A:** The skill triggers for questions needing current info (weather, news, prices, etc.). For manual trigger, use:
|
|
233
|
+
|
|
234
|
+
```
|
|
235
|
+
/felo-search your query here
|
|
236
|
+
```
|
|
244
237
|
|
|
245
238
|
### Q: "FELO_API_KEY not set" error?
|
|
246
239
|
|
|
@@ -274,15 +267,22 @@ Test: ask Claude *"Latest news about quantum computing"*. If you see an AI-gener
|
|
|
274
267
|
|
|
275
268
|
---
|
|
276
269
|
|
|
277
|
-
##
|
|
270
|
+
## Available Skills
|
|
271
|
+
|
|
272
|
+
### felo-search
|
|
278
273
|
|
|
279
|
-
|
|
274
|
+
Real-time web search with AI-generated answers.
|
|
280
275
|
|
|
281
|
-
**
|
|
276
|
+
**Triggers automatically for:**
|
|
282
277
|
|
|
283
|
-
|
|
278
|
+
- Current events & news
|
|
279
|
+
- Weather, prices, reviews
|
|
280
|
+
- Location info (restaurants, attractions)
|
|
281
|
+
- Latest documentation & tech trends
|
|
282
|
+
- Product comparisons
|
|
283
|
+
- Any question with "latest", "recent", "best", "how to"
|
|
284
284
|
|
|
285
|
-
**[
|
|
285
|
+
**[View skill documentation →](./felo-search/)**
|
|
286
286
|
|
|
287
287
|
---
|
|
288
288
|
|