@jcheesepkg/nanobot 0.8.99 → 0.9.1

package/dist/config/schema.d.mts

@@ -70,31 +70,31 @@ declare const ChannelsConfigSchema: z.ZodObject<{
     channelAccessToken?: string | undefined;
   }>>;
 }, "strip", z.ZodTypeAny, {
-  telegram: {
-    enabled: boolean;
-    token: string;
-    allowFrom: string[];
-    proxy?: string | null | undefined;
-  };
   line: {
     enabled: boolean;
     allowFrom: string[];
     channelSecret: string;
     channelAccessToken: string;
   };
-}, {
-  telegram?: {
-    enabled?: boolean | undefined;
-    token?: string | undefined;
-    allowFrom?: string[] | undefined;
+  telegram: {
+    enabled: boolean;
+    token: string;
+    allowFrom: string[];
     proxy?: string | null | undefined;
-  } | undefined;
+  };
+}, {
   line?: {
     enabled?: boolean | undefined;
     allowFrom?: string[] | undefined;
     channelSecret?: string | undefined;
     channelAccessToken?: string | undefined;
   } | undefined;
+  telegram?: {
+    enabled?: boolean | undefined;
+    token?: string | undefined;
+    allowFrom?: string[] | undefined;
+    proxy?: string | null | undefined;
+  } | undefined;
 }>;
 type ChannelsConfig = z.infer<typeof ChannelsConfigSchema>;
 declare const AgentDefaultsSchema: z.ZodObject<{
@@ -556,15 +556,15 @@ declare const ToolsConfigSchema: z.ZodObject<{
     export?: string | undefined;
   }>, "many">>;
 }, "strip", z.ZodTypeAny, {
+  exec: {
+    timeout: number;
+  };
   web: {
     search: {
       apiKey: string;
       maxResults: number;
     };
   };
-  exec: {
-    timeout: number;
-  };
   restrictToWorkspace: boolean;
   enabled?: string[] | undefined;
   disabled?: string[] | undefined;
@@ -574,6 +574,9 @@ declare const ToolsConfigSchema: z.ZodObject<{
     export?: string | undefined;
   }[] | undefined;
 }, {
+  exec?: {
+    timeout?: number | undefined;
+  } | undefined;
   enabled?: string[] | undefined;
   web?: {
     search?: {
@@ -581,9 +584,6 @@ declare const ToolsConfigSchema: z.ZodObject<{
       maxResults?: number | undefined;
     } | undefined;
   } | undefined;
-  exec?: {
-    timeout?: number | undefined;
-  } | undefined;
   restrictToWorkspace?: boolean | undefined;
   disabled?: string[] | undefined;
   custom?: {
@@ -675,31 +675,31 @@ declare const ConfigSchema: z.ZodObject<{
       channelAccessToken?: string | undefined;
     }>>;
   }, "strip", z.ZodTypeAny, {
-    telegram: {
-      enabled: boolean;
-      token: string;
-      allowFrom: string[];
-      proxy?: string | null | undefined;
-    };
     line: {
       enabled: boolean;
       allowFrom: string[];
       channelSecret: string;
       channelAccessToken: string;
     };
-  }, {
-    telegram?: {
-      enabled?: boolean | undefined;
-      token?: string | undefined;
-      allowFrom?: string[] | undefined;
+    telegram: {
+      enabled: boolean;
+      token: string;
+      allowFrom: string[];
       proxy?: string | null | undefined;
-    } | undefined;
+    };
+  }, {
     line?: {
       enabled?: boolean | undefined;
       allowFrom?: string[] | undefined;
       channelSecret?: string | undefined;
       channelAccessToken?: string | undefined;
     } | undefined;
+    telegram?: {
+      enabled?: boolean | undefined;
+      token?: string | undefined;
+      allowFrom?: string[] | undefined;
+      proxy?: string | null | undefined;
+    } | undefined;
   }>>;
   providers: z.ZodDefault<z.ZodObject<{
     anthropic: z.ZodDefault<z.ZodObject<{
@@ -1015,15 +1015,15 @@ declare const ConfigSchema: z.ZodObject<{
       export?: string | undefined;
     }>, "many">>;
   }, "strip", z.ZodTypeAny, {
+    exec: {
+      timeout: number;
+    };
     web: {
       search: {
         apiKey: string;
         maxResults: number;
       };
     };
-    exec: {
-      timeout: number;
-    };
     restrictToWorkspace: boolean;
     enabled?: string[] | undefined;
     disabled?: string[] | undefined;
@@ -1033,6 +1033,9 @@ declare const ConfigSchema: z.ZodObject<{
       export?: string | undefined;
     }[] | undefined;
   }, {
+    exec?: {
+      timeout?: number | undefined;
+    } | undefined;
     enabled?: string[] | undefined;
     web?: {
       search?: {
@@ -1040,9 +1043,6 @@ declare const ConfigSchema: z.ZodObject<{
         maxResults?: number | undefined;
       } | undefined;
     } | undefined;
-    exec?: {
-      timeout?: number | undefined;
-    } | undefined;
     restrictToWorkspace?: boolean | undefined;
     disabled?: string[] | undefined;
     custom?: {
@@ -1064,18 +1064,18 @@ declare const ConfigSchema: z.ZodObject<{
     };
   };
   channels: {
-    telegram: {
-      enabled: boolean;
-      token: string;
-      allowFrom: string[];
-      proxy?: string | null | undefined;
-    };
     line: {
       enabled: boolean;
       allowFrom: string[];
       channelSecret: string;
       channelAccessToken: string;
     };
+    telegram: {
+      enabled: boolean;
+      token: string;
+      allowFrom: string[];
+      proxy?: string | null | undefined;
+    };
   };
   providers: {
     anthropic: {
@@ -1139,15 +1139,15 @@ declare const ConfigSchema: z.ZodObject<{
     port: number;
   };
   tools: {
+    exec: {
+      timeout: number;
+    };
     web: {
       search: {
         apiKey: string;
         maxResults: number;
       };
     };
-    exec: {
-      timeout: number;
-    };
     restrictToWorkspace: boolean;
     enabled?: string[] | undefined;
     disabled?: string[] | undefined;
@@ -1170,18 +1170,18 @@ declare const ConfigSchema: z.ZodObject<{
     } | undefined;
   } | undefined;
   channels?: {
-    telegram?: {
-      enabled?: boolean | undefined;
-      token?: string | undefined;
-      allowFrom?: string[] | undefined;
-      proxy?: string | null | undefined;
-    } | undefined;
     line?: {
       enabled?: boolean | undefined;
       allowFrom?: string[] | undefined;
       channelSecret?: string | undefined;
       channelAccessToken?: string | undefined;
     } | undefined;
+    telegram?: {
+      enabled?: boolean | undefined;
+      token?: string | undefined;
+      allowFrom?: string[] | undefined;
+      proxy?: string | null | undefined;
+    } | undefined;
   } | undefined;
   providers?: {
     anthropic?: {
@@ -1245,6 +1245,9 @@ declare const ConfigSchema: z.ZodObject<{
     port?: number | undefined;
   } | undefined;
   tools?: {
+    exec?: {
+      timeout?: number | undefined;
+    } | undefined;
     enabled?: string[] | undefined;
     web?: {
       search?: {
@@ -1252,9 +1255,6 @@ declare const ConfigSchema: z.ZodObject<{
         maxResults?: number | undefined;
       } | undefined;
     } | undefined;
-    exec?: {
-      timeout?: number | undefined;
-    } | undefined;
     restrictToWorkspace?: boolean | undefined;
     disabled?: string[] | undefined;
     custom?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcheesepkg/nanobot",
-  "version": "0.8.99",
+  "version": "0.9.1",
   "description": "Lightweight AI assistant - TypeScript port",
   "type": "module",
   "main": "dist/index.mjs",

package/skills/daily-summary/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: daily-summary
-description: Morning briefing with weather and schedule.
+description: Automated morning briefing combining weather, schedule, and trash day. Use when user asks for 朝の要約 or wants a daily digest setup.
 ---
 
 # Daily Summary (朝の要約)
@@ -58,7 +58,7 @@ flex_message(template="morning_summary", data={
 })
 ```
 
-After the tool returns, output ONLY the raw JSON string returned by the tool. Do not wrap it in code blocks or add any other text. The JSON will be automatically rendered as a Flex Message card in LINE.
+The card is sent automatically — do NOT repeat the JSON. Just respond naturally after calling the tool.
 
 ## Personalization
 
@@ -73,4 +73,4 @@ Tomorrow's weather + clothing + morning events.
 
 ## Notes
 
-- ALWAYS use the `flex_message` tool — never output raw JSON directly
+- ALWAYS use the `flex_message` tool — the card is auto-sent

package/skills/english/SKILL.md

@@ -1,18 +1,25 @@
 ---
 name: english
-description: Casual English conversation practice with corrections.
+description: English conversation practice with level-based corrections, vocab tracking, and quizzes. Use when user says 英語, English mode, 英会話, 英語クイズ, or vocab test.
 ---
 
 # English Chat (英会話練習)
 
+## Data
+
+All data in `data/english/`:
+- `settings.json` — level preference
+- `vocab.json` — accumulated vocabulary list
+- `sessions.jsonl` — session logs (one JSON object per line)
+
 ## Difficulty Level
 
-Settings stored in `data/english.json`:
+Settings stored in `data/english/settings.json`:
 ```json
 { "level": "beginner" }
 ```
 
-On first activation, if `data/english.json` doesn't exist, ask the user to choose their level:
+On first activation, if `data/english/settings.json` doesn't exist, ask the user to choose their level:
 ```
 flex_message(template="action_buttons", data={
   prompt: "英語レベルを選んでね！\nChoose your English level:",
@@ -24,7 +31,7 @@ flex_message(template="action_buttons", data={
 })
 ```
 
-Save the choice to `data/english.json`. User can change anytime with "レベル変更".
+Save the choice to `data/english/settings.json`. User can change anytime with "レベル変更".
 
 ### Level behavior
 
@@ -39,7 +46,7 @@ Save the choice to `data/english.json`. User can change anytime with "レベル
 
 When user says "英語モード" / "English mode" / "英会話":
 
-1. Read `data/english.json` for level (default: beginner if missing)
+1. Read `data/english/settings.json` for level (default: beginner if missing)
 2. Reply in English, adapted to level
 3. Gently correct mistakes (strictness based on level)
 4. Offer Japanese translation based on level rules above
@@ -106,12 +113,26 @@ When user says "日本語に戻して" / "exit English" / "おわり":
    - Corrections you made (original → fixed)
    - New vocabulary or phrases you introduced
    - An encouraging comment about their performance
-2. Send a session summary using `flex_message`:
 
+2. **Save session log** — append one JSON line to `data/english/sessions.jsonl`:
+```bash
+echo '{"date":"2025-02-13","topics":["daily life","food"],"corrections":[{"wrong":"I go","right":"I went","rule":"past tense"}],"vocab":["commute","grab a bite"],"duration_msgs":12}' >> data/english/sessions.jsonl
+```
+
+3. **Update vocab list** — read `data/english/vocab.json`, merge new words, write back:
+```json
+[
+  { "word": "commute", "meaning": "通勤する", "date": "2025-02-13" },
+  { "word": "grab a bite", "meaning": "軽く食べる", "date": "2025-02-13" }
+]
+```
+If the file doesn't exist, create it with the new entries. Skip duplicates (same `word`).
+
+4. **Send session summary card**:
 ```
 flex_message(template="custom", data={
   title: "📝 English Session",
-  body: "Topics: ...\n\nCorrections:\n❌ I go → ✅ I went\n❌ more easy → ✅ easier\n\nNew vocab:\n• commute (通勤する)\n• grab a bite (軽く食べる)\n\n💪 Great job! Your past tense is improving!",
+  body: "Topics: daily life, food\n\nCorrections:\n❌ I go → ✅ I went\n❌ more easy → ✅ easier\n\nNew vocab:\n• commute (通勤する)\n• grab a bite (軽く食べる)\n\n💪 Great job! Your past tense is improving!",
   header_color: "#4CAF50"
 })
 ```
@@ -120,6 +141,29 @@ Keep it honest — if there were no corrections, say so. If there were many, pic
 
 After the card, respond: "英語練習お疲れ様！👍"
 
+## Vocab Review
+
+When user says "英語クイズ" / "vocab test" / "復習":
+
+1. Read `data/english/vocab.json`
+2. Pick 5 random words from past sessions
+3. Quiz the user — show the English word, ask for meaning or usage in a sentence
+4. Use `action_buttons` for multiple choice if beginner level
+
+Example:
+```
+flex_message(template="action_buttons", data={
+  prompt: "What does 'commute' mean?",
+  buttons: [
+    { label: "通勤する", text: "答え 通勤する", style: "primary" },
+    { label: "通信する", text: "答え 通信する", style: "secondary" },
+    { label: "通過する", text: "答え 通過する", style: "secondary" }
+  ]
+})
+```
+
+For intermediate/advanced: just ask in text, no multiple choice.
+
 ## Tips
 
 - Match user's level

package/skills/expense/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: expense
-description: Track daily expenses and show monthly summaries.
+description: Expense tracker with auto-categorization and monthly receipt summaries. Use when user mentions spending like 出費, 500円, or asks for expense reports.
 ---
 
 # Expense Tracker (出費記録)
@@ -11,7 +11,7 @@ User says: "コンビニで500円" / "出費 +380 カフェ" / "ランチ 1200"
 
 Log to CSV:
 ```bash
-echo "$(date +%Y-%m-%d),$(date +%H:%M),500,コンビニ,コンビニ" >> data/expenses.csv
+echo "$(date +%Y-%m-%d),$(date +%H:%M),500,コンビニ,コンビニ" >> data/expense/log.csv
 ```
 
 Format: `date,time,amount,note,category`
@@ -30,38 +30,37 @@ Default: 雑費
 
 ## Confirmation
 
-Simple text:
-```
-✅ 記録: カフェ ¥380
-今月: ¥12,340
-```
+After recording, confirm with a short text: "✅ 記録: カフェ ¥380"
 
 ## Summary
 
-Monthly:
+Monthly totals:
 ```bash
-awk -F, '$1 ~ /^2025-02/ {sum+=$3} END {print sum}' data/expenses.csv
+awk -F, '$1 ~ /^2025-02/ {sum+=$3} END {print sum}' data/expense/log.csv
 ```
 
 By category:
 ```bash
-awk -F, '$1 ~ /^2025-02/ {cat[$5]+=$3} END {for(c in cat) print c, cat[c]}' data/expenses.csv
+awk -F, '$1 ~ /^2025-02/ {cat[$5]+=$3} END {for(c in cat) print c, cat[c]}' data/expense/log.csv
 ```
 
-Text summary:
-```
-📊 2月の出費
+**ALWAYS use `flex_message`** for summaries. The card is auto-sent.
 
-合計: ¥45,230
-
-内訳:
-• 食事 ¥18,500
-• カフェ ¥6,200
-• 交通 ¥8,400
-• その他 ¥12,130
+Monthly summary as receipt card:
+```
+flex_message(template="receipt", data={
+  title: "2月の出費",
+  items: [
+    { name: "食事", value: "¥18,500" },
+    { name: "カフェ", value: "¥6,200" },
+    { name: "交通", value: "¥8,400" },
+    { name: "その他", value: "¥12,130" }
+  ],
+  total: "¥45,230"
+})
 ```
 
 ## Commands
 
-- "出費" / "今月の出費" → summary
+- "出費" / "今月の出費" → monthly receipt card
 - "出費 詳細" → recent entries

package/skills/fortune/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fortune
-description: Daily horoscope readings.
+description: Daily horoscope and zodiac readings. Use when user says 占い, 運勢, 星座, or asks about their fortune/horoscope.
 ---
 
 # Fortune (占い)
@@ -55,7 +55,7 @@ flex_message(template="fortune", data={
 })
 ```
 
-After the tool returns, output ONLY the raw JSON string returned by the tool. Do not wrap it in code blocks or add any other text. The JSON will be automatically rendered as a Flex Message card in LINE.
+The card is sent automatically — do NOT repeat the JSON. Just respond naturally after calling the tool.
 
 ## Commands
 
@@ -87,4 +87,4 @@ Match bot tone:
 
 - Same sign = same fortune all day (deterministic)
 - Keep it fun, not serious
-- ALWAYS use the `flex_message` tool — never output raw JSON directly
+- ALWAYS use the `flex_message` tool — the card is auto-sent

package/skills/habit/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: habit
-description: Track daily habits with streaks.
+description: Habit tracker with streak counting and weekly summaries. Use when user says 習慣, mentions completing a habit, or wants to add/check habits.
 ---
 
 # Habit Tracker (習慣トラッカー)
 
 ## Setup
 
-Store habits in `data/habits.json`:
+Store habits in `data/habit/config.json`:
 ```json
 {
   "habits": [
@@ -20,40 +20,56 @@ Store habits in `data/habits.json`:
 
 ## Daily Check-in
 
-Simple text with quick_replies:
-```
-📋 今日の習慣
-🧘 瞑想 ✓
-🏃 運動
-📖 読書 ✓
+**ALWAYS use `flex_message`** for daily check-in. Use carousel with one card per habit:
 
-[[quick_replies: 🧘 瞑想やった, 🏃 運動やった, 📖 読書やった]]
 ```
+flex_message(template="custom", data={
+  bubbles: [
+    {
+      type: "bubble",
+      header: { type: "box", layout: "vertical", backgroundColor: "#4CAF50", contents: [{ type: "text", text: "🧘 瞑想", color: "#FFFFFF", weight: "bold" }] },
+      body: { type: "box", layout: "vertical", contents: [{ type: "text", text: "🔥 7日連続！", wrap: true }] },
+      footer: { type: "box", layout: "vertical", contents: [{ type: "button", action: { type: "message", label: "✅ やった！", text: "瞑想やった" }, style: "primary", color: "#4CAF50" }] }
+    },
+    {
+      type: "bubble",
+      header: { type: "box", layout: "vertical", backgroundColor: "#FF9800", contents: [{ type: "text", text: "🏃 運動", color: "#FFFFFF", weight: "bold" }] },
+      body: { type: "box", layout: "vertical", contents: [{ type: "text", text: "まだやってないよ〜", wrap: true }] },
+      footer: { type: "box", layout: "vertical", contents: [{ type: "button", action: { type: "message", label: "✅ やった！", text: "運動やった" }, style: "primary", color: "#FF9800" }] }
+    }
+  ]
+})
+```
+
+The card is auto-sent — do NOT repeat the JSON.
+
+- Green header (#4CAF50) = already done today
+- Orange header (#FF9800) = not done yet
+- Read `data/habit/log.csv` to check today's status before building the carousel
 
 ## Logging
 
 ```bash
-echo "$(date +%Y-%m-%d)|meditate|1" >> data/habit-log.csv
+echo "$(date +%Y-%m-%d)|meditate|1" >> data/habit/log.csv
 ```
 
 ## Streaks
 
 ```bash
 # Count consecutive days
-awk -F"|" '$2=="meditate" && $3=="1" {print $1}' data/habit-log.csv | uniq | tail -7 | wc -l
+awk -F"|" '$2=="meditate" && $3=="1" {print $1}' data/habit/log.csv | uniq | tail -7 | wc -l
 ```
 
 ## Summary
 
-Text-based weekly:
-```
-📊 今週の習慣
-
-🧘 瞑想: 7/7 🔥7日連続！
-🏃 運動: 5/7
-📖 読書: 3/7
+**ALWAYS use `flex_message`** for weekly summaries. The card is auto-sent.
 
-すごい！瞑想毎日達成！✨
+```
+flex_message(template="custom", data={
+  title: "📊 今週の習慣",
+  body: "🧘 瞑想: 7/7 🔥7日連続！\n🏃 運動: 5/7\n📖 読書: 3/7\n\nすごい！瞑想毎日達成！✨",
+  header_color: "#4CAF50"
+})
 ```
 
 ## Commands

package/skills/hydration/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hydration
-description: Track daily water intake with reminders.
+description: Water intake tracker with reminders and progress display. Use when user says 水飲んだ, 一杯, or asks about hydration.
 ---
 
 # Hydration Tracker (水分摂取)
@@ -11,13 +11,13 @@ User says: "水飲んだ" / "一杯飲んだ" / "+1"
 
 Log:
 ```bash
-echo "$(date -Iseconds)|1" >> data/hydration.log
+echo "$(date -Iseconds)|1" >> data/hydration/log.csv
 ```
 
 ## Check Progress
 
 ```bash
-grep "$(date +%Y-%m-%d)" data/hydration.log | wc -l
+grep "$(date +%Y-%m-%d)" data/hydration/log.csv | wc -l
 ```
 
 ## Output
@@ -36,7 +36,7 @@ flex_message(template="hydration", data={
 })
 ```
 
-After the tool returns, output ONLY the raw JSON string returned by the tool. Do not wrap it in code blocks or add any other text. The JSON will be automatically rendered as a Flex Message card in LINE.
+The card is sent automatically — do NOT repeat the JSON. Just respond naturally after calling the tool.
 
 ## Setup Reminder
 
@@ -48,10 +48,10 @@ cron(action="add", message="水飲んだ？リマインド送って", every_seco
 
 Archive at midnight:
 ```bash
-[ -f data/hydration.log ] && mv data/hydration.log data/hydration-$(date +%Y-%m-%d).log
+[ -f data/hydration/log.csv ] && mv data/hydration/log.csv data/hydration/log-$(date +%Y-%m-%d).csv
 ```
 
 ## Notes
 
-- ALWAYS use the `flex_message` tool — never output raw JSON directly
-- Update `current` count by reading from `data/hydration.log` before calling the tool
+- ALWAYS use the `flex_message` tool — the card is auto-sent
+- Update `current` count by reading from `data/hydration/log.csv` before calling the tool

package/skills/mood/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mood
-description: Daily mood tracking with emoji and optional notes.
+description: Mood journal with emoji tracking and weekly reports. Use when user shares feelings like 気分, だるい, 疲れた, いい感じ, or asks for mood summary.
 ---
 
 # Mood Journal (気分日記)
@@ -20,39 +20,46 @@ Map to emoji + score:
 
 Log to CSV:
 ```bash
-echo "$(date +%Y-%m-%d),$(date +%H:%M),😊,5,今日はいい感じ" >> data/mood.csv
+echo "$(date +%Y-%m-%d),$(date +%H:%M),😊,5,今日はいい感じ" >> data/mood/log.csv
 ```
 
 Format: `date,time,emoji,score,note`
 
 ## Daily Check-in
 
-Use quick_replies directive for simple tap response:
+Use `action_buttons` flex for tap response:
 ```
-今日の気分は？
-
-[[quick_replies: 😊 いい, 😐 普通, 😔 だるい, 😢 辛い]]
+flex_message(template="action_buttons", data={
+  prompt: "今日の気分は？",
+  buttons: [
+    { label: "😊 いい", text: "気分 😊 いい", style: "primary" },
+    { label: "😐 普通", text: "気分 😐 普通", style: "secondary" },
+    { label: "😔 だるい", text: "気分 😔 だるい", style: "secondary" },
+    { label: "😢 辛い", text: "気分 😢 辛い", style: "secondary" }
+  ]
+})
 ```
 
-Set up cron:
+The card is auto-sent. Set up cron for nightly check-in:
 ```
-cron(action="add", message="今日の気分は？\n\n[[quick_replies: 😊 いい, 😐 普通, 😔 だるい]]", cron_expr="0 21 * * *", timezone="Asia/Tokyo")
+cron(action="add", message="気分チェックインのカードを送って", cron_expr="0 21 * * *", timezone="Asia/Tokyo", kind="task")
 ```
 
 ## Summary
 
 Calculate average:
 ```bash
-awk -F, 'NR>7 {sum+=$4; count++} END {print "avg:", sum/count}' data/mood.csv
+awk -F, 'NR>7 {sum+=$4; count++} END {print "avg:", sum/count}' data/mood/log.csv
 ```
 
-Weekly text summary:
-```
-📊 今週の気分
-平均: 3.8 / 5
-😊😊😐😊😔😊😊
+**ALWAYS use `flex_message`** for weekly summaries. The card is auto-sent.
 
-一番多かったのは 😊 です！
+```
+flex_message(template="custom", data={
+  title: "📊 今週の気分",
+  body: "😊😊😐😊😔😊😊\n\n平均: 3.8 / 5\n一番多かったのは 😊 です！\n\nいい調子！来週もこの感じで👍",
+  header_color: "#FF9800"
+})
 ```
 
 ## Notes

package/skills/skill-creator/SKILL.md

@@ -36,6 +36,7 @@ skill-name/
   scripts/      (optional) - Executable code
   references/   (optional) - Documentation for context
   assets/       (optional) - Files used in output
+  data/         (optional) - User data, settings, logs
 ```
 
 #### SKILL.md
@@ -72,6 +73,24 @@ Skills use three-level loading:
 - `description`: What the skill does AND when to use it. Include trigger contexts.
   All "when to use" info goes here since the body only loads after triggering.
 
+### Data Storage
+
+**Custom skills** live in the workspace `skills/` directory. Store user data in `data/` within the skill, using the **full path from workspace root** in SKILL.md:
+
+```
+skills/my-skill/
+  SKILL.md
+  data/
+    log.csv
+    settings.json
+```
+
+```bash
+echo "..." >> skills/my-skill/data/log.csv
+```
+
+NOT `data/log.csv` — that would write to the workspace root.
+
 ### Flex Message Integration
 
 If the skill produces output that would benefit from rich visual display (cards, progress trackers, summaries, confirmations), include `flex_message` tool usage in the SKILL.md.

package/skills/weather/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: weather
-description: Get current weather and forecasts (no API key required).
+description: Weather forecasts and clothing advice. Use when user asks about 天気, 気温, 服装, or weather in any city.
 ---
 
 # Weather
@@ -81,6 +81,23 @@ Additional:
 
 ---
 
+## Output
+
+**ALWAYS use `flex_message`** to display weather results. The card is auto-sent.
+
+Color the header based on conditions:
+- 晴れ: `#1DB446` (green)
+- 曇り: `#607D8B` (grey)
+- 雨/雪: `#2196F3` (blue)
+
+```
+flex_message(template="custom", data={
+  title: "🌤 東京の天気",
+  body: "現在: 12°C (体感10°C)\n曇り\n\n朝 6時: 8°C\n昼12時: 14°C\n晩18時: 11°C\n\n👔 ジャケット or カーディガン",
+  header_color: "#607D8B"
+})
+```
+
 ## Full Forecast (no jq)
 
 ```bash