felo-ai 0.2.43 → 0.2.46

package/README.md

@@ -127,23 +127,48 @@ felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
 /apple-buy-advisor Is it worth upgrading to iPad Air 13?
 ```
 
+**Twitter Writer** — [full options →](./felo-twitter-writer/SKILL.md)
+
+```bash
+# Use as Claude Code skill
+/felo-twitter-writer Analyze @paulg's tweet style and extract a style DNA
+/felo-twitter-writer Write 3 tweets about AI trends in @paulg's style
+/felo-twitter-writer Write a Twitter thread about why most startups fail
+```
+
+**SuperAgent** — [full options →](./felo-superAgent/README.md)
+
+```bash
+# Use as Claude Code skill
+/felo-superagent What is the latest news about AI?
+/felo-superagent Tell me more --thread-id <thread_short_id>
+```
+
+```bash
+# Run script directly
+node felo-superAgent/scripts/run_superagent.mjs --query "What is quantum computing?"
+node felo-superAgent/scripts/run_superagent.mjs --query "Tell me more" --thread-id <thread_short_id>
+```
+
 **[See 40+ more examples →](./docs/EXAMPLES.md)**
 
 ---
 
 ## Skills Overview
 
-7 skills across search, content generation, web scraping, social media, knowledge base, and shopping advice:
+9 skills across search, content generation, web scraping, social media, knowledge base, shopping advice, Twitter writing, and AI conversation:
 
-| Skill                       | Description                                                   | Docs                            |
-| --------------------------- | ------------------------------------------------------------- | ------------------------------- |
-| **felo-search**             | Real-time web search with AI answers. Triggers automatically. | [→](./felo-search/)             |
-| **felo-slides**             | Generate PPT from a prompt                                    | [→](./felo-slides/)             |
-| **felo-web-fetch**          | Fetch and extract webpage content                             | [→](./felo-web-fetch/)          |
-| **felo-youtube-subtitling** | Fetch YouTube video subtitles                                 | [→](./felo-youtube-subtitling/) |
-| **felo-x-search**           | Search X (Twitter) tweets, users, replies                     | [→](./felo-x-search/SKILL.md)   |
-| **felo-livedoc**            | Manage knowledge bases and semantic retrieval                 | [→](./felo-livedoc/)            |
-| **apple-buy-advisor**       | Research and compare Apple products before you buy            | [→](./apple-buy-advisor/)       |
+| Skill                       | Description                                                   | Docs                                      |
+| --------------------------- | ------------------------------------------------------------- | ----------------------------------------- |
+| **felo-search**             | Real-time web search with AI answers. Triggers automatically. | [→](./felo-search/)                       |
+| **felo-slides**             | Generate PPT from a prompt                                    | [→](./felo-slides/)                       |
+| **felo-web-fetch**          | Fetch and extract webpage content                             | [→](./felo-web-fetch/)                    |
+| **felo-youtube-subtitling** | Fetch YouTube video subtitles                                 | [→](./felo-youtube-subtitling/)           |
+| **felo-x-search**           | Search X (Twitter) tweets, users, replies                     | [→](./felo-x-search/SKILL.md)             |
+| **felo-livedoc**            | Manage knowledge bases and semantic retrieval                 | [→](./felo-livedoc/)                      |
+| **apple-buy-advisor**       | Research and compare Apple products before you buy            | [→](./apple-buy-advisor/)                 |
+| **felo-twitter-writer**     | Analyze tweet style DNA and compose tweets, threads, X posts  | [→](./felo-twitter-writer/SKILL.md)       |
+| **felo-superAgent**         | AI conversation with real-time streaming, continuous threads  | [→](./felo-superAgent/README.md)          |
 
 ---
 
@@ -163,6 +188,8 @@ felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
 /plugin install felo-x-search@felo-ai
 /plugin install felo-livedoc@felo-ai
 /plugin install apple-buy-advisor@felo-ai
+/plugin install felo-twitter-writer@felo-ai
+/plugin install felo-superAgent@felo-ai
 ```
 
 ### ClawHub
@@ -177,6 +204,8 @@ clawhub install felo-youtube-subtitling
 clawhub install felo-x-search
 clawhub install felo-livedoc
 clawhub install apple-buy-advisor
+clawhub install felo-twitter-writer
+clawhub install felo-superAgent
 ```
 
 ### Gemini CLI

package/felo-twitter-writer/README.md

@@ -53,8 +53,9 @@ node felo-livedoc/scripts/run_livedoc.mjs list --json
 # node felo-livedoc/scripts/run_livedoc.mjs create --name "Twitter Writer" --json
 
 # Step 3: Pass tweets to SuperAgent for style analysis
+# First call in session (no thread_short_id yet):
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "Analyze the following tweets from @elonmusk and extract a writing style DNA document covering tone, sentence structure, opening hooks, hashtag strategy, and emoji usage.\n\nBio: [BIO]\n\nTweets:\n[TWEETS]" \
+  --query "/twitter-writer Analyze the following tweets from @elonmusk and extract a writing style DNA document covering tone, sentence structure, opening hooks, hashtag strategy, and emoji usage.\n\nBio: [BIO]\n\nTweets:\n[TWEETS]" \
   --live-doc-id "LIVE_DOC_ID" \
   --skill-id twitter-writer \
   --accept-language en
@@ -63,16 +64,16 @@ node felo-superAgent/scripts/run_superagent.mjs \
 ### 3) Mode 2 — Create content
 
 ```bash
-# New conversation (no prior style DNA)
+# New conversation (no thread_short_id in session)
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "Write 3 versions of a tweet about AI trends in an engaging, punchy style." \
+  --query "/twitter-writer Write 3 versions of a tweet about AI trends in an engaging, punchy style." \
   --live-doc-id "LIVE_DOC_ID" \
   --skill-id twitter-writer \
   --accept-language en
 
-# Follow-up after Mode 1 (reuse thread — pass --thread-id from previous [state] output)
+# Follow-up after Mode 1 (thread_short_id already exists — pass --thread-id from previous [state] output)
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "Based on the style DNA above, write 3 tweets about startups. Keep each under 280 characters." \
+  --query "/twitter-writer Based on the style DNA above, write 3 tweets about startups. Keep each under 280 characters." \
   --thread-id "THREAD_SHORT_ID" \
   --live-doc-id "LIVE_DOC_ID" \
   --accept-language en

package/felo-twitter-writer/SKILL.md

@@ -78,16 +78,30 @@ Follow Constraint #4 above.
 
 #### Step 3: Call SuperAgent with tweet content
 
-Construct a query that includes the fetched tweets and asks for style analysis. Pass `--skill-id twitter-writer` since this is a new conversation.
+Determine conversation mode first:
+- If **no** `thread_short_id` exists in this session → new conversation (pass `--skill-id twitter-writer`)
+- If `thread_short_id` **already exists** in this session → follow-up (pass `--thread-id`)
+
+**New conversation (first call in session):**
 
 ```bash
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "ENRICHED_QUERY_WITH_TWEET_CONTENT" \
+  --query "/twitter-writer ENRICHED_QUERY_WITH_TWEET_CONTENT" \
   --live-doc-id "LIVE_DOC_ID" \
   --skill-id twitter-writer \
   --accept-language LANG
 ```
 
+**Follow-up (thread_short_id already exists):**
+
+```bash
+node felo-superAgent/scripts/run_superagent.mjs \
+  --query "/twitter-writer ENRICHED_QUERY_WITH_TWEET_CONTENT" \
+  --thread-id "THREAD_SHORT_ID" \
+  --live-doc-id "LIVE_DOC_ID" \
+  --accept-language LANG
+```
+
 **Query construction example:**
 
 > Please analyze the following tweets from @USERNAME and extract a writing style DNA document. Cover dimensions such as: tone, sentence structure, opening hooks, closing calls-to-action, frequently used words, hashtag strategy, emoji usage, and any other distinctive patterns.
@@ -128,27 +142,27 @@ Follow Constraint #4. If Mode 1 was already run, reuse the same `live_doc_id`.
 
 | Condition | Mode | What to pass |
 |-----------|------|--------------|
-| First call in session, or switching to twitter-writer skill | New conversation | `--live-doc-id` + `--skill-id twitter-writer` |
-| Continuing from Mode 1 or a previous Mode 2 call | Follow-up | `--thread-id` + `--live-doc-id` |
-| User says "new topic" / "start over" | New conversation | `--live-doc-id` + `--skill-id twitter-writer` |
+| No `thread_short_id` in this session (truly first call) | New conversation | `--live-doc-id` + `--skill-id twitter-writer` |
+| `thread_short_id` already exists in this session (all subsequent inputs, including after Mode 1) | Follow-up | `--thread-id` + `--live-doc-id` |
+| User says "new topic" / "start over" (clear `thread_short_id`) | New conversation | `--live-doc-id` + `--skill-id twitter-writer` |
 
 #### Step 4: Call SuperAgent
 
-**New conversation:**
+**New conversation (no `thread_short_id` in session):**
 
 ```bash
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "ENRICHED_QUERY" \
+  --query "/twitter-writer ENRICHED_QUERY" \
   --live-doc-id "LIVE_DOC_ID" \
   --skill-id twitter-writer \
   --accept-language LANG
 ```
 
-**Follow-up (iterating on previous output):**
+**Follow-up (`thread_short_id` already exists in session):**
 
 ```bash
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "USER_FOLLOW_UP" \
+  --query "/twitter-writer USER_FOLLOW_UP" \
   --thread-id "THREAD_SHORT_ID" \
   --live-doc-id "LIVE_DOC_ID" \
   --accept-language LANG
@@ -217,10 +231,10 @@ node felo-x-search/scripts/run_x_search.mjs --id "paulg" --user
 
 **Step 2:** Get `live_doc_id` (list or create)
 
-**Step 3:** Call SuperAgent:
+**Step 3:** Call SuperAgent (first call in session — no `thread_short_id` yet):
 ```bash
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "@paulg のツイートを分析し、文体のスタイルDNAドキュメントを作成してください。トーン、文章構造、冒頭フック、締めのアクション、頻出ワード、ハッシュタグ戦略、絵文字の使い方などを含めてください。\n\nアカウント概要：[BIO]\n\nツイート：\n[TWEETS]" \
+  --query "/twitter-writer @paulg のツイートを分析し、文体のスタイルDNAドキュメントを作成してください。トーン、文章構造、冒頭フック、締めのアクション、頻出ワード、ハッシュタグ戦略、絵文字の使い方などを含めてください。\n\nアカウント概要：[BIO]\n\nツイート：\n[TWEETS]" \
   --live-doc-id "LIVE_DOC_ID" \
   --skill-id twitter-writer \
   --accept-language ja
@@ -240,10 +254,10 @@ User: "@paulg のスタイルでスタートアップについてのツイート
 
 **Step 2:** Reuse `live_doc_id` from Mode 1
 
-**Step 3:** Follow-up call (continuing the same thread):
+**Step 3:** Follow-up call (continuing the same thread — `thread_short_id` from Example A):
 ```bash
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "上記で抽出した @paulg のスタイルDNAをもとに、「スタートアップ」をテーマにしたツイートを3パターン作成してください。それぞれ異なるトーンや切り口で、280文字以内に収めてください。" \
+  --query "/twitter-writer 上記で抽出した @paulg のスタイルDNAをもとに、「スタートアップ」をテーマにしたツイートを3パターン作成してください。それぞれ異なるトーンや切り口で、280文字以内に収めてください。" \
   --thread-id "THREAD_SHORT_ID" \
   --live-doc-id "LIVE_DOC_ID" \
   --accept-language ja
@@ -261,10 +275,10 @@ User: "Write a Twitter thread about why most startups fail"
 
 **Step 2:** Get `live_doc_id`
 
-**Step 3:** New conversation with `twitter-writer`:
+**Step 3:** New conversation with `twitter-writer` (first call in session — no `thread_short_id` yet):
 ```bash
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "Write a Twitter thread (6–8 tweets) about why most startups fail. Start with a strong hook tweet that grabs attention. Each tweet should stand alone but flow naturally into the next." \
+  --query "/twitter-writer Write a Twitter thread (6–8 tweets) about why most startups fail. Start with a strong hook tweet that grabs attention. Each tweet should stand alone but flow naturally into the next." \
   --live-doc-id "LIVE_DOC_ID" \
   --skill-id twitter-writer \
   --accept-language en
@@ -282,10 +296,10 @@ User: "2番目のツイートをもっとユーモラスにして、絵文字も
 
 **Step 2:** This is a follow-up — pass `--thread-id` with the saved `thread_short_id`.
 
-**Step 3:** Follow-up call:
+**Step 3:** Follow-up call (`thread_short_id` already exists in session):
 ```bash
 node felo-superAgent/scripts/run_superagent.mjs \
-  --query "上記で生成した2番目のツイートを修正してください。トーンをよりユーモラスで軽快にし、適切な絵文字を追加してください。内容の意図は変えないでください。" \
+  --query "/twitter-writer 上記で生成した2番目のツイートを修正してください。トーンをよりユーモラスで軽快にし、適切な絵文字を追加してください。内容の意図は変えないでください。" \
   --thread-id "THREAD_SHORT_ID" \
   --live-doc-id "LIVE_DOC_ID" \
   --accept-language ja

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "felo-ai",
-  "version": "0.2.43",
+  "version": "0.2.46",
   "description": "Felo AI CLI - real-time search, PPT generation, SuperAgent conversation, LiveDoc management, web fetch, YouTube subtitles, LiveDoc knowledge base, and X (Twitter) search from the terminal",
   "type": "module",
   "main": "src/cli.js",
@@ -32,7 +32,8 @@
     "url": "git+https://github.com/Felo-Inc/felo-skills.git"
   },
   "dependencies": {
-    "commander": "^12.0.0"
+    "commander": "^12.0.0",
+    "felo-ai": "^0.2.43"
   },
   "scripts": {
     "test": "node --test tests/",