Skip to content
Back to search

felo-ai

MarketplaceWorks with Claude CodeGitHub

Ask anything. Get current answers. Generate slides and mindmaps from a prompt.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/felo-inc-felo-skills/badge.svg)](/listings/felo-inc-felo-skills)

HTML

<a href="/listings/felo-inc-felo-skills"><img src="/api/listings/felo-inc-felo-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install -g felo-ai

Get your API key from [Felo AI](https://felo.ai) (Settings → API Keys), then:

felo config set FELO_API_KEY your-api-key-here

That's it. The key is persisted in `~/.felo/config.json`. You can also use environment variables as an alternative:

export FELO_API_KEY="..."           # Linux/macOS
$env:FELO_API_KEY="..."             # Windows (PowerShell)

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 94 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "felo-ai",
  3. "owner": {
  4. "name": "Felo-Inc",
  5. "url": "https://github.com/Felo-Inc"
  6. },
  7. "metadata": {
  8. "description": "Felo AI skills for Claude Code — real-time search, PPT generation, landing page creation, SuperAgent, LiveDoc knowledge base, web fetch, YouTube subtitles, and X (Twitter) search",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "felo-search",
  14. "description": "Real-time web search powered by Felo AI",
  15. "source": "./",
  16. "strict": false,
  17. "skills": [
  18. "./felo-search"
  19. ]
  20. },
  21. {
  22. "name": "felo-livedoc",
  23. "description": "Manage knowledge bases (LiveDocs) and semantic retrieval via Felo API",
  24. "source": "./",
  25. "strict": false,
  26. "skills": [
  27. "./felo-livedoc"
  28. ]
  29. },
  30. {
  31. "name": "felo-slides",
  32. "description": "Generate PPT presentations from a prompt using Felo AI",
  33. "source": "./",
  34. "strict": false,
  35. "skills": [
  36. "./felo-slides"
  37. ]
  38. },
  39. {
  40. "name": "felo-landingpage",
  41. "description": "Generate landing pages and hosted webpages from a prompt using Felo AI",
  42. "source": "./",
  43. "strict": false,
  44. "skills": [
  45. "./felo-landingpage"
  46. ]
  47. },
  48. {
  49. "name": "felo-superAgent",
  50. "description": "SuperAgent conversation with SSE streaming and LiveDoc integration",
  51. "source": "./",
  52. "strict": false,
  53. "skills": [
  54. "./felo-superAgent"
  55. ]
  56. },
  57. {
  58. "name": "felo-web-fetch",
  59. "description": "Fetch and extract webpage content in markdown, text, or HTML format",
  60. "source": "./",
  61. "strict": false,
  62. "skills": [
  63. "./felo-web-fetch"
  64. ]
  65. },
  66. {
  67. "name": "felo-youtube-subtitling",
  68. "description": "Fetch YouTube video subtitles and captions by URL or video ID",
  69. "source": "./",
  70. "strict": false,
  71. "skills": [
  72. "./felo-youtube-subtitling"
  73. ]
  74. },
  75. {
  76. "name": "felo-x-search",
  77. "description": "Search X (Twitter) tweets, users, and replies via Felo API",
  78. "source": "./",
  79. "strict": false,
  80. "skills": [
  81. "./felo-x-search"
  82. ]
  83. },
  84. {
  85. "name": "felo-content-to-slides",
  86. "description": "Fetch content from a webpage or YouTube video and generate a PPT",
  87. "source": "./",
  88. "strict": false,
  89. "skills": [
  90. "./felo-content-to-slides"
  91. ]
  92. }
  93. ]
  94. }
README.md · README · 439 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Felo AI CLI
  2. <p align="center">
  3. <img src="https://felo.ai/icon.svg" alt="Felo AI" width="120">
  4. </p>
  5. <p align="center">
  6. <strong>Ask anything. Get current answers. Generate slides and mindmaps from a prompt.</strong>
  7. </p>
  8. <p align="center">
  9. <a href="https://www.npmjs.com/package/felo-ai"><img src="https://img.shields.io/npm/v/felo-ai.svg?style=for-the-badge" alt="npm version"></a>
  10. <a href="https://discord.gg/9W8NubHA"><img src="https://img.shields.io/discord/1078608933607976980?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge" alt="Discord"></a>
  11. <a href="https://x.com/felo_ai"><img src="https://img.shields.io/badge/X-@felo__ai-black?logo=x&style=for-the-badge" alt="X (Twitter)"></a>
  12. <a href="./felo-search/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
  13. </p>
  14. **Felo AI CLI** — Real-time search, PPT generation, mindmap creation, web fetch, YouTube subtitles, and X (Twitter) search, SuperAgent conversation, and Twitter writing from the terminal. Also works as Claude Code skills, including landing page creation. Supports Chinese, English, Japanese, and Korean.
  15. <p align="center">
  16. <a href="https://felo.ai">Felo AI</a> · <a href="https://openapi.felo.ai/docs/">Docs</a> · <a href="https://openapi.felo.ai/docs/api-reference/v2/chat.html">API Reference</a> · <a href="./docs/EXAMPLES.md">Examples</a> · <a href="./docs/FAQ.md">FAQ</a> · <a href="https://clawhub.ai/u/wangzhiming1999">ClawHub</a> · <a href="https://discord.gg/9W8NubHA">Discord</a> · <a href="https://x.com/felo_ai">X (Twitter)</a>
  17. </p>
  18. ---
  19. ## Install
  20. ```bash
  21. npm install -g felo-ai
  22. ```
  23. Get your API key from [Felo AI](https://felo.ai) (Settings → API Keys), then:
  24. ```bash
  25. felo config set FELO_API_KEY your-api-key-here
  26. ```
  27. That's it. The key is persisted in `~/.felo/config.json`. You can also use environment variables as an alternative:
  28. ```bash
  29. export FELO_API_KEY="..." # Linux/macOS
  30. $env:FELO_API_KEY="..." # Windows (PowerShell)
  31. ```
  32. ---
  33. ## Commands
  34. | Command | Description |
  35. | ---------------------------------------- | ----------------------------------------------------- |
  36. | `felo search "<query>"` | Search for current info (weather, news, prices, etc.) |
  37. | `felo slides "<prompt>" [--file <path>]` | Generate PPT from a prompt or local file |
  38. | `felo mindmap "<query>"` | Generate mindmap; returns link immediately |
  39. | `felo web-fetch --url <url>` | Fetch webpage content (markdown/text/html) |
  40. | `felo youtube-subtitling -v <url-or-id>` | Fetch YouTube video subtitles |
  41. | `felo x "<query>"` | Search X (Twitter) tweets, users, and replies |
  42. | `felo livedoc <subcommand>` | Manage LiveDocs (knowledge bases) and resources |
  43. | `felo apple-buy-advisor "<query>"` | Research and compare Apple products before you buy |
  44. | `felo superagent "<query>"` | AI conversation with real-time streaming output |
  45. | `felo style-library <category>` | List brand styles from the style library |
  46. | `felo config <set\|get\|list\|path>` | Manage API key and config |
  47. ---
  48. ## Examples
  49. **Search**
  50. ```bash
  51. felo search "Tokyo weather"
  52. felo search "React 19 new features" --verbose
  53. felo search "MacBook Air M3 price" --json
  54. ```
  55. **Slides**
  56. ```bash
  57. felo slides "Felo product intro, 3 slides"
  58. felo slides "Q4 2024 business review, 10 pages" --poll-timeout 300
  59. felo slides "Create 2 slides and include the original image" --file "/absolute/path/to/source.jpg"
  60. ```
  61. **Mindmap**
  62. ```bash
  63. felo mindmap "AI trends in 2024"
  64. felo mindmap "Project timeline" --layout TIMELINE
  65. felo mindmap "Problem analysis" --layout FISHBONE --json
  66. felo mindmap-layouts # List available layouts
  67. ```
  68. **Web Fetch** — [full options →](./felo-web-fetch/README.md)
  69. ```bash
  70. felo web-fetch --url "https://example.com"
  71. felo web-fetch --url "https://example.com" --format markdown --readability
  72. ```
  73. **YouTube Subtitling** — [full options →](./felo-youtube-subtitling/README.md)
  74. ```bash
  75. felo youtube-subtitling -v "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  76. felo youtube-subtitling -v "dQw4w9WgXcQ" --language zh-CN --with-time
  77. ```
  78. **X (Twitter) Search** — [full options →](./felo-x-search/SKILL.md)
  79. ```bash
  80. felo x "AI news" # Search tweets
  81. felo x "OpenAI" --user # Search users
  82. felo x --id "elonmusk" --user # Get user info
  83. felo x --id "elonmusk" --user --tweets # Get user tweets
  84. felo x --id "1234567890" # Get tweet replies
  85. ```
  86. **LiveDoc (Knowledge Base)** — [full options →](./felo-livedoc/README.md)
  87. ```bash
  88. felo livedoc create --name "My KB" --description "Project docs"
  89. felo livedoc list
  90. felo livedoc add-doc SHORT_ID --content "Hello" --title "Test"
  91. felo livedoc add-urls SHORT_ID --urls "https://example.com"
  92. felo livedoc upload SHORT_ID --file ./doc.pdf
  93. felo livedoc retrieve SHORT_ID --query "search query"
  94. ```
  95. **Apple Buy Advisor** — [full options →](./apple-buy-advisor/SKILL.md)
  96. ```bash
  97. # Use as Felo CLI command
  98. felo apple-buy-advisor "Should I buy MacBook Pro M4?"
  99. felo apple-buy-advisor "Compare iPhone 17 vs iPhone 17e"
  100. felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
  101. ```
  102. ```bash
  103. # Use as Claude Code skill
  104. /apple-buy-advisor Should I buy MacBook Pro M4?
  105. /apple-buy-advisor Compare iPhone 17 vs iPhone 17e
  106. /apple-buy-advisor Is it worth upgrading to iPad Air 13?
  107. ```
  108. **Twitter Writer** — [full options →](./felo-twitter-writer/README.md)
  109. ```bash
  110. # Use as Claude Code skill — Claude automatically fetches your style library
  111. # and asks you to pick a writing style before generating
  112. /felo-twitter-writer Analyze @paulg's tweet style and extract a style DNA
  113. /felo-twitter-writer Write 3 tweets about AI trends
  114. /felo-twitter-writer Write a Twitter thread about why most startups fail
  115. /felo-twitter-writer Write a tweet about AI in the style of @darioamodei
  116. ```
  117. ```bash
  118. # Run scripts directly
  119. node felo-superAgent/scripts/run_style_library.mjs --category TWITTER --accept-language en
  120. node felo-superAgent/scripts/run_superagent.mjs \
  121. --query "/twitter-writer Write a tweet about AI trends" \
  122. --live-doc-id "LIVE_DOC_ID" \
  123. --skill-id twitter-writer \
  124. --ext '{"brand_style_requirement":"Style name: darioamodei\nStyle labels: Thoughtful long-form essays\nStyle DNA: ..."}' \
  125. --accept-language en
  126. ```
  127. **SuperAgent** — [full options →](./felo-superAgent/README.md)
  128. ```bash
  129. # Use as Claude Code skill
  130. /felo-superAgent What is the latest news about AI?
  131. /felo-superAgent Write a tweet about quantum computing
  132. /felo-superAgent Design a logo for my coffee shop
  133. ```
  134. ```bash
  135. # Run script directly
  136. node felo-superAgent/scripts/run_superagent.mjs --query "What is quantum computing?" --live-doc-id "LIVE_DOC_ID"
  137. node felo-superAgent/scripts/run_superagent.mjs --query "Tell me more" --thread-id <thread_short_id> --live-doc-id "LIVE_DOC_ID"
  138. ```
  139. ```bash
  140. # CLI commands
  141. felo superagent "What is the latest news about AI?"
  142. felo superagent "Tell me more" --thread-id <thread_short_id>
  143. felo style-library TWITTER --accept-language en
  144. felo style-library IMAGE --accept-language zh-Hans
  145. ```
  146. **Doc Snapshot Agent** — [full options →](./doc-snapshot-agent/SKILL.md)
  147. ```bash
  148. # Use as Claude Code skill — Claude parses image markers, captures screenshots,
  149. # generates AI images, and produces an illustrated Markdown document
  150. /doc-snapshot-agent Add images to my article cases/getting-started.md
  151. /doc-snapshot-agent Recapture screenshot A3 in cases/product-overview.md
  152. /doc-snapshot-agent Regenerate all images from scratch for cases/tutorial.md
  153. ```
  154. **[See 40+ more examples →](./docs/EXAMPLES.md)**
  155. ---
  156. ## Skills Overview
  157. 12 skills across search, content generation, web scraping, social media, knowledge base, shopping advice, and document illustration:
  158. | Skill | Description | Docs |
  159. | --------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------ |
  160. | **felo-search** | Real-time web search with AI answers. Triggers automatically. | [→](./felo-search/) |
  161. | **felo-slides** | Generate PPT from a prompt | [→](./felo-slides/) |
  162. | **felo-landingpage** | Generate a hosted landing page/webpage from a prompt | [→](./felo-landingpage/) |
  163. | **felo-web-fetch** | Fetch and extract webpage content | [→](./felo-web-fetch/) |
  164. | **felo-youtube-subtitling** | Fetch YouTube video subtitles | [→](./felo-youtube-subtitling/) |
  165. | **felo-x-search** | Search X (Twitter) tweets, users, replies | [→](./felo-x-search/SKILL.md) |
  166. | **felo-livedoc** | Manage knowledge bases and semantic retrieval | [→](./felo-livedoc/) |
  167. | **apple-buy-advisor** | Research and compare Apple products before you buy | [→](./apple-buy-advisor/) |
  168. | **felo-twitter-writer** | Analyze tweet style DNA; compose tweets, threads, X posts with brand style | [→](./felo-twitter-writer/README.md) |
  169. | **felo-superAgent** | AI conversation with real-time streaming, brand style support, continuous threads | [→](./felo-superAgent/README.md) |
  170. | **felo-mindmap** | Generate mindmaps with various layouts | [→](./felo-mindmap/) |
  171. | **doc-snapshot-agent** | Automatically illustrate Markdown documents with screenshots and AI-generated images | [→](./doc-snapshot-agent/) |
  172. ---
  173. ## Using felo-twitter-writer and felo-superAgent with Claude Code
  174. These two skills work together and share the style library. Here is how Claude uses them.
  175. ### Installation
  176. ```bash
  177. # Via ClawHub
  178. # felo-twitter-writer depends on felo-superAgent + felo-livedoc; felo-superAgent depends on felo-livedoc
  179. clawhub install felo-twitter-writer
  180. clawhub install felo-superAgent
  181. clawhub install felo-livedoc
  182. clawhub install felo-x-search
  183. # Manual
  184. cp -r felo-twitter-writer ~/.claude/skills/
  185. cp -r felo-superAgent ~/.claude/skills/
  186. cp -r felo-livedoc ~/.claude/skills/
  187. cp -r felo-x-search ~/.claude/skills/
  188. ```
  189. ### felo-twitter-writer
  190. Trigger keywords: `write a tweet`, `twitter thread`, `style DNA`, `imitate tweet style`, `tweet in the style of`, `X account analysis`, `ghostwrite tweets`
  191. ```
  192. /felo-twitter-writer Analyze @paulg's tweet style
  193. /felo-twitter-writer Write 3 tweets about AI trends
  194. /felo-twitter-writer Write a Twitter thread about why most startups fail
  195. ```
  196. **What Claude does automatically for tweet writing (Mode 2, new conversation):**
  197. 1. Calls `run_style_library.mjs --category TWITTER` to fetch your saved writing styles
  198. 2. Presents the list grouped as **[Your styles]** / **[Recommended styles]** with a "No preference" option
  199. 3. Waits for your selection, then calls SuperAgent with the full style block in `--ext`
  200. 4. Streams the result in real time — follow-ups reuse the thread without re-fetching styles
  201. ```
  202. You: Write a Twitter thread about why most startups fail
  203. Claude: Here are the available Twitter writing styles — choosing one will make
  204. the output more accurate:
  205. [Your styles]
  206. 1. My Bold Voice
  207. [Recommended styles]
  208. 2. darioamodei
  209. 0. No preference — use default style
  210. You: 1
  211. Claude: [streams the thread in "My Bold Voice" style]
  212. You: Make the hook tweet more provocative
  213. Claude: [follow-up — no style re-selection needed]
  214. ```
  215. If the style library is empty, Claude skips the selection step silently.
  216. ### felo-superAgent
  217. Trigger keywords: `superagent`, `super agent`, `stream chat`, `streaming conversation`, `write a tweet`, `create a logo`, `product image`
  218. ```
  219. /felo-superAgent What is the latest news about AI?
  220. /felo-superAgent Write a tweet about quantum computing
  221. /felo-superAgent Design a logo for my coffee shop
  222. /felo-superAgent Generate a product image for wireless headphones
  223. ```
  224. **What Claude does automatically for skill-based conversations:**
  225. | Skill intent | Style category fetched | `--skill-id` passed |
  226. | -------------------- | ---------------------- | ------------------------- |
  227. | Write tweets | `TWITTER` | `twitter-writer` |
  228. | Logo / branding | `IMAGE` | `logo-and-branding` |
  229. | Product images | `IMAGE` | `ecommerce-product-image` |
  230. | General conversation | — | — |
  231. For skill-based new conversations, Claude fetches the matching style library, presents options, and passes the chosen style via `--ext '{"brand_style_requirement":"..."}'`. The style block includes `Style name`, `Style labels`, `Style DNA`, and optionally `Cover file ID` — passed completely, never truncated.
  232. **Thread and LiveDoc management:**
  233. - Claude reuses the same LiveDoc across the entire session
  234. - Every message after the first is a follow-up (`--thread-id`) by default
  235. - A new thread is only started when you say "new topic", "start over", or when a different skill ID is needed
  236. - `--ext` is only passed for new conversations, never for follow-ups
  237. ---
  238. ## Skills Install
  239. ### Claude Code
  240. ```bash
  241. # Via ClawHub (recommended)
  242. clawhub install felo-search
  243. clawhub install felo-slides
  244. clawhub install felo-landingpage
  245. clawhub install felo-mindmap
  246. clawhub install felo-web-fetch
  247. clawhub install felo-youtube-subtitling
  248. clawhub install felo-x-search
  249. clawhub install felo-livedoc
  250. clawhub install apple-buy-advisor
  251. clawhub install doc-snapshot-agent
  252. # felo-superAgent depends on felo-livedoc — install both:
  253. clawhub install felo-superAgent
  254. clawhub install felo-livedoc
  255. # felo-twitter-writer depends on felo-superAgent and felo-livedoc — install all three:
  256. clawhub install felo-twitter-writer
  257. clawhub install felo-superAgent
  258. clawhub install felo-livedoc
  259. ```
  260. ```bash
  261. # Manual
  262. git clone https://github.com/Felo-Inc/felo-skills.git
  263. cd felo-skills
  264. cp -r felo-search ~/.claude/skills/
  265. cp -r felo-slides ~/.claude/skills/
  266. cp -r felo-landingpage ~/.claude/skills/
  267. cp -r felo-web-fetch ~/.claude/skills/
  268. cp -r felo-youtube-subtitling ~/.claude/skills/
  269. cp -r felo-x-search ~/.claude/skills/
  270. cp -r felo-livedoc ~/.claude/skills/
  271. cp -r apple-buy-advisor ~/.claude/skills/
  272. cp -r felo-twitter-writer ~/.claude/skills/
  273. cp -r felo-superAgent ~/.claude/skills/
  274. cp -r doc-snapshot-agent ~/.claude/skills/
  275. ```
  276. ### Gemini CLI
  277. ```bash
  278. git clone https://github.com/Felo-Inc/felo-skills.git
  279. cd felo-skills
  280. cp -r felo-search ~/.gemini/skills/
  281. cp -r felo-slides ~/.gemini/skills/
  282. cp -r felo-landingpage ~/.gemini/skills/
  283. cp -r felo-web-fetch ~/.gemini/skills/
  284. cp -r felo-youtube-subtitling ~/.gemini/skills/
  285. cp -r felo-x-search ~/.gemini/skills/
  286. cp -r felo-livedoc ~/.gemini/skills/
  287. cp -r apple-buy-advisor ~/.gemini/skills/
  288. cp -r felo-twitter-writer ~/.gemini/skills/
  289. cp -r felo-superAgent ~/.gemini/skills/
  290. cp -r doc-snapshot-agent ~/.gemini/skills/
  291. ```
  292. ### OpenAI Codex
  293. ```bash
  294. git clone https://github.com/Felo-Inc/felo-skills.git
  295. cd felo-skills
  296. cp -r felo-search ~/.codex/skills/
  297. cp -r felo-slides ~/.codex/skills/
  298. cp -r felo-landingpage ~/.codex/skills/
  299. cp -r felo-web-fetch ~/.codex/skills/
  300. cp -r felo-youtube-subtitling ~/.codex/skills/
  301. cp -r felo-x-search ~/.codex/skills/
  302. cp -r felo-livedoc ~/.codex/skills/
  303. cp -r apple-buy-advisor ~/.codex/skills/
  304. cp -r felo-twitter-writer ~/.codex/skills/
  305. cp -r felo-superAgent ~/.codex/skills/
  306. cp -r doc-snapshot-agent ~/.codex/skills/
  307. ```
  308. ### OpenClaw
  309. ```bash
  310. # Installs all skills that contain a SKILL.md (includes felo-twitter-writer and felo-superAgent)
  311. bash <(curl -s https://raw.githubusercontent.com/Felo-Inc/felo-skills/main/scripts/openclaw-install.sh)
  312. ```
  313. ### Hermes
  314. ```bash
  315. # Installs all skills that contain a SKILL.md (includes felo-twitter-writer and felo-superAgent)
  316. bash <(curl -s https://raw.githubusercontent.com/Felo-Inc/felo-skills/main/scripts/install-hermes.sh)
  317. ```
  318. ---
  319. ## FAQ
  320. - **Key not found?** Run `felo config set FELO_API_KEY <key>` or set the `FELO_API_KEY` environment variable.
  321. - **Request timeout?** Use `--timeout 120` (default 60s). 5xx errors are retried automatically.
  322. - **Slides taking long?** Use `--poll-timeout 300` (default 1200s) to limit wait.
  323. - **Skill not triggering?** Use `/felo-search your query` to trigger manually.
  324. - **Multi-language?** Yes — Chinese, English, Japanese, and Korean are supported.
  325. **[Full FAQ →](./docs/FAQ.md)**
  326. ---
  327. ## Contributing
  328. We welcome contributions — report bugs, improve docs, or add new skills. Run tests with `npm test`.
  329. **[Contributing guide →](./CONTRIBUTING.md)**
  330. ---
  331. ## License
  332. MIT — see [LICENSE](./felo-search/LICENSE) for details.
  333. ---
  334. <p align="center">Made with ❤️ by the <a href="https://felo.ai">Felo</a> team</p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.