{"_id":"@8-interactive/insightark-skills","_rev":"5-5f66589d01532ee5d20717f47eff0ad7","name":"@8-interactive/insightark-skills","dist-tags":{"latest":"0.6.0"},"versions":{"0.5.0":{"name":"@8-interactive/insightark-skills","version":"0.5.0","license":"UNLICENSED","_id":"@8-interactive/insightark-skills@0.5.0","maintainers":[{"name":"mosluce","email":"mosluce@gmail.com"},{"name":"awesomejerry","email":"jerry82422@gmail.com"}],"homepage":"https://github.com/8-interactive/insightark-skills#readme","bugs":{"url":"https://github.com/8-interactive/insightark-skills/issues"},"bin":{"super8-studio-api-skills":"scripts/super8-skills-cli.js"},"dist":{"shasum":"c8d294e3994d36533afb21886466ccfc20247810","tarball":"https://registry.npmjs.org/@8-interactive/insightark-skills/-/insightark-skills-0.5.0.tgz","fileCount":78,"integrity":"sha512-AA/8i2VKcMa2lfSfrV9mqlMi8sc9UtoOTByAMPTgxb9UzyD5qZeEecB5SdTy4m7NpaLtava+TsDsroeaCQopbQ==","signatures":[{"sig":"MEUCIG05rZZbYE0+AlcnhXy+AXgHmV0tBh+EDliPuwsKA2HGAiEAhMfzSUDjdva/D/VlmExerPOEAY96NdWEDB5qi+brmNk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":232543},"engines":{"node":">=18"},"gitHead":"999ae89bbfd379df14bb269659d6ea32970d8433","scripts":{"test":"node test/env-precedence.test.js","smoke":"node test/smoke.js","version":"node scripts/sync-versions.js","validate":"node scripts/validate-skills.js"},"_npmUser":{"name":"mosluce","email":"mosluce@gmail.com"},"repository":{"url":"git+https://github.com/8-interactive/insightark-skills.git","type":"git"},"_npmVersion":"10.8.2","description":"Super 8 Studio Developer API skills bundle and installer metadata.","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/insightark-skills_0.5.0_1782726311271_0.8889322317811033","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@8-interactive/insightark-skills","version":"0.5.1","license":"UNLICENSED","_id":"@8-interactive/insightark-skills@0.5.1","maintainers":[{"name":"mosluce","email":"mosluce@gmail.com"},{"name":"awesomejerry","email":"jerry82422@gmail.com"}],"homepage":"https://github.com/8-interactive/insightark-skills#readme","bugs":{"url":"https://github.com/8-interactive/insightark-skills/issues"},"bin":{"super8-studio-api-skills":"scripts/super8-skills-cli.js"},"dist":{"shasum":"675c6bd73883eee34afea88f4b921fe8a65b10de","tarball":"https://registry.npmjs.org/@8-interactive/insightark-skills/-/insightark-skills-0.5.1.tgz","fileCount":78,"integrity":"sha512-2shnNNWzYxXLzvVWIL2u4J8mK6xzT+XhmqDPyd+FS8FKHzS9JohDTWXgyXpPLv3q6KVDZ9gkPB+LATykzZReAQ==","signatures":[{"sig":"MEYCIQDTupRpu34CLRoBPNHtgCiMVjZw2E0WKWLzPNOKH7Z5+AIhAO6hTk//jQJYJFhgcSItYRqeG4Z5LWteW5n7q0Eo4uI4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":236453},"engines":{"node":">=18"},"gitHead":"f02638ab2f9f4c50513cda441f4ad50a11c9a7c4","scripts":{"test":"node test/env-precedence.test.js && node test/multiselect.test.js","smoke":"node test/smoke.js","version":"node scripts/sync-versions.js","validate":"node scripts/validate-skills.js"},"_npmUser":{"name":"mosluce","email":"mosluce@gmail.com"},"repository":{"url":"git+https://github.com/8-interactive/insightark-skills.git","type":"git"},"_npmVersion":"10.8.2","description":"Super 8 Studio Developer API skills bundle and installer metadata.","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/insightark-skills_0.5.1_1782729384696_0.538146759008816","host":"s3://npm-registry-packages-npm-production"}},"0.5.2":{"name":"@8-interactive/insightark-skills","version":"0.5.2","license":"UNLICENSED","_id":"@8-interactive/insightark-skills@0.5.2","maintainers":[{"name":"mosluce","email":"mosluce@gmail.com"},{"name":"awesomejerry","email":"jerry82422@gmail.com"}],"homepage":"https://github.com/8-interactive/insightark-skills#readme","bugs":{"url":"https://github.com/8-interactive/insightark-skills/issues"},"bin":{"super8-studio-api-skills":"scripts/super8-skills-cli.js"},"dist":{"shasum":"81f5abb346a1c17511d8aaa43478576ef8b523e7","tarball":"https://registry.npmjs.org/@8-interactive/insightark-skills/-/insightark-skills-0.5.2.tgz","fileCount":81,"integrity":"sha512-OBhHm/bu9n8IE9V6g3RGF6n7xN9UcZm+3qNNf0p30bMXs1gCVLY20dBmiIcYfDWGevVkHGyB1EvY+ntFWb2Guw==","signatures":[{"sig":"MEYCIQDhLevXZpuW2L6fC33xWyqk869E2JHH5DMzF5CI/njXiAIhAOyFX98yPNwa9nCfuB74qAKKfAhBt0mCjDCnI0dz3+35","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":250133},"engines":{"node":">=18"},"gitHead":"e088bf0bf8cbc7f028fe42f5a7fecdf89a3e03a8","scripts":{"test":"node test/env-precedence.test.js && node test/multiselect.test.js && node test/session-precedence.test.js","smoke":"node test/smoke.js","version":"node scripts/sync-versions.js","validate":"node scripts/validate-skills.js"},"_npmUser":{"name":"mosluce","email":"mosluce@gmail.com"},"repository":{"url":"git+https://github.com/8-interactive/insightark-skills.git","type":"git"},"_npmVersion":"10.8.2","description":"Super 8 Studio Developer API skills bundle and installer metadata.","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/insightark-skills_0.5.2_1782743669772_0.15234359984771118","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@8-interactive/insightark-skills","version":"0.6.0","license":"Apache-2.0","_id":"@8-interactive/insightark-skills@0.6.0","maintainers":[{"name":"mosluce","email":"mosluce@gmail.com"},{"name":"awesomejerry","email":"jerry82422@gmail.com"}],"homepage":"https://github.com/8-interactive/insightark-skills#readme","bugs":{"url":"https://github.com/8-interactive/insightark-skills/issues"},"bin":{"insightark-skills":"scripts/super8-skills-cli.js"},"dist":{"shasum":"009d8156fa602d2c4bfb07be5d26367ae1b856fc","tarball":"https://registry.npmjs.org/@8-interactive/insightark-skills/-/insightark-skills-0.6.0.tgz","fileCount":81,"integrity":"sha512-lbd0ePxQz+JxcvahsgHQiMsRLthLpxUauAQnacnL9t+DarIMB7ZcgJFq4o/7E4wB8mNY6rjATk83kgqpMSIgxg==","signatures":[{"sig":"MEUCIDtV6K3pkNnGiMw/uMqcWiG7dCmPTdWmxrcrsuTaa+CfAiEAjgy32bE0ef92A3eR2+0yXMKLFR/6AV+m+U2K3BlD+Bo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":261154},"engines":{"node":">=18"},"gitHead":"37a8e9eae1081a49b79243b15dde3f67d1849938","scripts":{"test":"node test/env-precedence.test.js && node test/multiselect.test.js && node test/session-precedence.test.js","smoke":"node test/smoke.js","version":"node scripts/sync-versions.js","validate":"node scripts/validate-skills.js"},"_npmUser":{"name":"mosluce","email":"mosluce@gmail.com"},"repository":{"url":"git+https://github.com/8-interactive/insightark-skills.git","type":"git"},"_npmVersion":"10.8.2","description":"SUPER 8 Studio InsightArk Skills bundle and installer metadata.","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/insightark-skills_0.6.0_1782747536638_0.9204403606578846","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-06-29T09:45:11.143Z","modified":"2026-06-30T01:21:26.460Z","0.5.0":"2026-06-29T09:45:11.410Z","0.5.1":"2026-06-29T10:36:24.843Z","0.5.2":"2026-06-29T14:34:29.919Z","0.6.0":"2026-06-29T15:38:56.776Z"},"bugs":{"url":"https://github.com/8-interactive/insightark-skills/issues"},"license":"Apache-2.0","homepage":"https://github.com/8-interactive/insightark-skills#readme","repository":{"url":"git+https://github.com/8-interactive/insightark-skills.git","type":"git"},"description":"SUPER 8 Studio InsightArk Skills bundle and installer metadata.","maintainers":[{"email":"bonlee@no8.io","name":"bonlee"},{"email":"mosluce@gmail.com","name":"mosluce"},{"email":"jerry82422@gmail.com","name":"awesomejerry"}],"readme":"# SUPER 8 Studio InsightArk Skills\n\n[English](#english) | [中文](#中文)\n\n---\n\n<a name=\"english\"></a>\n\n**SUPER 8 Studio InsightArk Skills** is a plugin for Claude Code and Codex that brings the [SUPER 8 Studio](https://www.no8.io) Developer API directly into your AI agent workflow.\n\nIt provides a curated set of reusable skills covering the full CRM lifecycle — investigating conversations, managing customers, sending broadcasts, and automating marketing journeys. Once installed, your agent can query inboxes, update customer records, compose messages, and trigger campaigns without leaving the conversation interface.\n\nCredentials are managed securely through the platform's native keychain on Claude Code, or via an environment config file on Codex. A built-in health check runs automatically at session start to surface credential issues early.\n\n## Install for Claude Code\n\n```bash\nnpx @8-interactive/insightark-skills install --agents claude-code\nnpx @8-interactive/insightark-skills login     # log in (email/password), saves a session\n```\n\nThis copies the skills into `~/.claude/skills` and configures your session token.\n\n> The managed plugin-marketplace install (with `userConfig` prompts and a\n> `SessionStart` doctor hook) will be available once the repository is public.\n> Until then, use the npx install above.\n\n### Session token\n\n1. Console → **Account Settings → Developer API**\n2. Create a token (shown **once**)\n\nTokens expire after six months. Never commit tokens or share them in chat.\n\n---\n\n## Install for Codex\n\n```bash\nnpx @8-interactive/insightark-skills install --agents codex\nnpx @8-interactive/insightark-skills login\n```\n\nThis copies the skills into `~/.codex/skills` and writes credentials to `~/.super8-studio.env`.\n\n> The plugin-marketplace install will be available once the repository is public.\n\n### Session token\n\n1. Console → **Account Settings → Developer API**\n2. Create a token (shown **once**)\n\nTokens expire after six months. Never commit tokens or share them in chat.\n\n---\n\n## Install via npx (any coding agent)\n\nPure Node — works on macOS, Linux, and **native Windows** (no bash, `curl`, or `jq` required). Node 18+ only.\n\n```bash\nnpx @8-interactive/insightark-skills install     # interactive: choose location → agents → confirm\nnpx @8-interactive/insightark-skills login       # log in (email/password), saves a session\nnpx @8-interactive/insightark-skills doctor      # health check\n```\n\nThe installer asks **where** to install — global (`~`) or this repo (current\ndirectory) — and **which** coding agents to install for (Claude Code, OpenCode,\nCursor, GitHub Copilot, Codex), then copies the skills into each agent's skills\nfolder.\n\n### Config files\n\n| Location | Path | Contents |\n| --- | --- | --- |\n| Install registry | `~/.super8-studio.config` | Skills install paths |\n| Skills dir | `{skills-target}/.super8-studio.env` | `S8_SESSION_TOKEN`, `S8_ORG_ID` |\n| User (fallback) | `~/.super8-studio.env` | Fallback if install registry is missing |\n| Project override | `{project}/.super8-studio.env` | Optional `S8_ORG_ID` / stage URL override |\n\n**Token precedence:** login session (`~/.super8-studio.session`) → process environment (`S8_SESSION_TOKEN`) → project file → skills install dir → user file.\n\n### Non-interactive / advanced\n\n```bash\nnpx @8-interactive/insightark-skills install --location global --agents claude-code,cursor,codex\nnpx @8-interactive/insightark-skills install --location repo --agents all\nnpx @8-interactive/insightark-skills install --target ~/.agents/skills   # shared folder, no per-agent subpaths\nnpx @8-interactive/insightark-skills uninstall --location global --agents claude-code,codex\n```\n\n---\n\n## Authentication\n\nLog in with your Super 8 account (recommended) instead of pasting a token:\n\n```bash\nnpx @8-interactive/insightark-skills login    # email + password (+ TOTP if enabled), pick an org\nnpx @8-interactive/insightark-skills logout   # clear the local session\n```\n\n`login` stores a session at `~/.super8-studio.session` that takes **priority over `S8_SESSION_TOKEN`**. It expires automatically; `logout` removes it locally (the API has no server-side revoke). After `install`, an interactive run verifies any existing credential and offers to log in if needed. `setup` (pasting a Console token) still works but is **deprecated**.\n\n---\n\n## Skills\n\n| Skill | Purpose |\n| --- | --- |\n| `super8-studio-conversations` | List conversations by platform, inbox state, customer, or activity time |\n| `super8-studio-conversation-detail` | Conversation summary and message timeline |\n| `super8-studio-message-search` | Keyword search across the org or within one conversation |\n| `super8-studio-customer-search` | Find customer segments by tag or activity |\n| `super8-studio-customer-detail` | Customer profile and activity |\n| `super8-studio-customer-manager` | Manage customer records |\n| `super8-studio-customer-update` | Update customer fields |\n| `super8-studio-customer-tag-add` | Add tags to a customer |\n| `super8-studio-customer-tag-remove` | Remove tags from a customer |\n| `super8-studio-customer-send-message` | Send a message to a customer |\n| `super8-studio-broadcast-create` | Create a broadcast |\n| `super8-studio-broadcast-get` | Get broadcast details |\n| `super8-studio-broadcast-list` | List broadcasts |\n| `super8-studio-broadcast-manager` | Manage broadcast lifecycle |\n| `super8-studio-messaging` | Compose and send messages |\n| `super8-studio-investigator` | Deep investigation across conversations and customers |\n| `super8-studio-session` | Session and auth utilities |\n| `super8-studio-org-scope` | Org-scoped API utilities |\n\n**Typical flow:** `customer-search` or `conversations` → `message-search` → `conversation-detail`\n\n---\n\n<a name=\"中文\"></a>\n\n**SUPER 8 Studio InsightArk Skills** 是適用於 Claude Code 與 Codex 的 Plugin，將 [SUPER 8 Studio](https://www.no8.io) Developer API 直接整合進 AI Agent 工作流程。\n\n內含一組涵蓋完整 CRM 生命週期的可重用 Skills，包括對話調查、客戶管理、廣播發送與行銷自動化。安裝後，Agent 可在不離開對話介面的情況下查詢收件匣、更新客戶資料、撰寫訊息並觸發行銷活動。\n\n憑證管理方面，Claude Code 透過平台原生系統鑰匙圈安全儲存，Codex 則透過環境設定檔管理。內建健康檢查會在每次 session 開始時自動執行，提早偵測憑證問題。\n\n## 安裝（Claude Code）\n\n```bash\nnpx @8-interactive/insightark-skills install --agents claude-code\nnpx @8-interactive/insightark-skills login     # log in (email/password), saves a session\n```\n\n會把 skills 複製進 `~/.claude/skills` 並設定你的 session token。\n\n> 受管理的外掛市集安裝（含 `userConfig` 提示與 `SessionStart` doctor hook）會在 repo 公開後提供；在那之前請用上面的 npx 安裝。\n\n### Session Token 取得方式\n\n1. Console → **Account Settings → Developer API**\n2. 建立 Token（**僅顯示一次**）\n\nToken 有效期六個月，請勿提交至版本控制或在對話中分享。\n\n---\n\n## 安裝（Codex）\n\n```bash\nnpx @8-interactive/insightark-skills install --agents codex\nnpx @8-interactive/insightark-skills login\n```\n\n會把 skills 複製進 `~/.codex/skills`,並把憑證寫入 `~/.super8-studio.env`。\n\n> 外掛市集安裝會在 repo 公開後提供。\n\n### Session Token 取得方式\n\n1. Console → **Account Settings → Developer API**\n2. 建立 Token（**僅顯示一次**）\n\nToken 有效期六個月，請勿提交至版本控制或在對話中分享。\n\n---\n\n## 透過 npx 安裝（適用任何 coding agent）\n\n純 Node 實作——可在 macOS、Linux 與**原生 Windows** 上執行（無需 bash、`curl` 或 `jq`）。僅需 Node 18+。\n\n```bash\nnpx @8-interactive/insightark-skills install     # 互動式：選擇位置 → agents → 確認\nnpx @8-interactive/insightark-skills login       # log in (email/password), saves a session\nnpx @8-interactive/insightark-skills doctor      # 健康檢查\n```\n\n安裝器會詢問**安裝位置**——global（`~`）或此 repo（當前目錄）——以及要**安裝給哪些\ncoding agent**（Claude Code、OpenCode、Cursor、GitHub Copilot、Codex），然後將\nskills 複製到各 agent 的 skills 資料夾。\n\n### 設定檔說明\n\n| 位置 | 路徑 | 內容 |\n| --- | --- | --- |\n| 安裝登錄檔 | `~/.super8-studio.config` | Skills 安裝路徑 |\n| Skills 目錄 | `{skills-target}/.super8-studio.env` | `S8_SESSION_TOKEN`、`S8_ORG_ID` |\n| 使用者（備援） | `~/.super8-studio.env` | 找不到安裝登錄檔時的備援 |\n| 專案覆蓋 | `{project}/.super8-studio.env` | 可選的 `S8_ORG_ID` 或測試環境 URL |\n\n**Token 優先序：** 登入 session（`~/.super8-studio.session`）→ Process 環境變數（`S8_SESSION_TOKEN`）→ 專案檔案 → Skills 安裝目錄 → 使用者檔案。\n\n### 非互動 / 進階\n\n```bash\nnpx @8-interactive/insightark-skills install --location global --agents claude-code,cursor,codex\nnpx @8-interactive/insightark-skills install --location repo --agents all\nnpx @8-interactive/insightark-skills install --target ~/.agents/skills   # 共用資料夾，不使用各 agent 子目錄\nnpx @8-interactive/insightark-skills uninstall --location global --agents claude-code,codex\n```\n\n---\n\n## 驗證登入\n\n建議用 Super 8 帳號登入(取代貼 token):\n\n```bash\nnpx @8-interactive/insightark-skills login    # email + password(+ TOTP 若啟用),選 org\nnpx @8-interactive/insightark-skills logout   # 清除本地 session\n```\n\n`login` 會把 session 存到 `~/.super8-studio.session`,其**優先於 `S8_SESSION_TOKEN`**。session 會自動過期;`logout` 只清本地(API 無 server 端 revoke)。`install` 互動模式會驗證既有憑證,需要時引導登入。`setup`(貼 Console token)仍可用但**已 deprecated**。\n\n---\n\n## Skills 列表\n\n| Skill | 用途 |\n| --- | --- |\n| `super8-studio-conversations` | 依平台、收件匣狀態、客戶或活動時間列出對話 |\n| `super8-studio-conversation-detail` | 對話摘要與訊息時間軸 |\n| `super8-studio-message-search` | 跨全組織或在單一對話中搜尋關鍵字 |\n| `super8-studio-customer-search` | 依標籤或活動搜尋客戶族群 |\n| `super8-studio-customer-detail` | 客戶個人資料與活動紀錄 |\n| `super8-studio-customer-manager` | 管理客戶資料 |\n| `super8-studio-customer-update` | 更新客戶欄位 |\n| `super8-studio-customer-tag-add` | 為客戶新增標籤 |\n| `super8-studio-customer-tag-remove` | 移除客戶標籤 |\n| `super8-studio-customer-send-message` | 傳送訊息給客戶 |\n| `super8-studio-broadcast-create` | 建立廣播 |\n| `super8-studio-broadcast-get` | 取得廣播詳情 |\n| `super8-studio-broadcast-list` | 列出廣播 |\n| `super8-studio-broadcast-manager` | 管理廣播生命週期 |\n| `super8-studio-messaging` | 撰寫與發送訊息 |\n| `super8-studio-investigator` | 跨對話與客戶的深度調查 |\n| `super8-studio-session` | Session 與驗證工具 |\n| `super8-studio-org-scope` | 組織範圍 API 工具 |\n\n**典型流程：** `customer-search` 或 `conversations` → `message-search` → `conversation-detail`\n","readmeFilename":"README.md"}