twentythree-skills 1.3.7 → 1.4.0

package/README.md

@@ -1,8 +1,24 @@
 # twentythree-skills
 
-AI agent skills for the [TwentyThree CLI](https://github.com/23/twentythree-cli) — installable markdown skill definitions for Claude Code, OpenAI Codex, GitHub Copilot, and Cursor.
+AI agent skills for the [TwentyThree CLI](https://github.com/23/twentythree-cli) — installable markdown skill definitions for Claude Code, OpenAI Codex, GitHub Copilot, Cursor, Windsurf, Cline, and Gemini CLI.
 
-## Install
+## Install from your AI assistant (no terminal)
+
+Paste this into Claude Code, Codex, Cursor, Windsurf, Cline, Gemini CLI, or any agent that can run shell commands, and it will install everything for you:
+
+```text
+Install the TwentyThree CLI and its AI skills on this machine, then verify:
+1. Run: npm install -g twentythree-cli
+2. Run: npx -y twentythree-skills
+3. Ask me for my TwentyThree workspace domain and bearer token, then run:
+   twentythree auth credentials --domain <domain> --token <token>
+4. Verify with: twentythree doctor
+If Node 22+ / npm isn't installed, stop and tell me how to install it first.
+```
+
+The assistant runs the install, detects its own runtime, and drops the skill files in the right place — then you can ask it to upload videos, run webinars, or query analytics in plain language.
+
+## Install from the terminal
 
 ```bash
 npx twentythree-skills
@@ -26,12 +42,17 @@ Installs into `.claude/skills/`, `.agents/skills/`, `.github/skills/`, or `.curs
 
 ## Supported runtimes
 
-| Runtime | Detection | Global install path |
-|---------|-----------|---------------------|
-| Claude Code | `~/.claude/` | `~/.claude/skills/twentythree/` |
-| OpenAI Codex | `~/.codex/` | `~/.codex/skills/twentythree/` |
-| GitHub Copilot | `~/.github/copilot/` | `~/.github/skills/twentythree/` |
-| Cursor | `~/.cursor/` | `~/.cursor/skills/twentythree/` |
+| Runtime | Detection | Global install path | Project install path (`--project`) |
+|---------|-----------|---------------------|------------------------------------|
+| Claude Code | `~/.claude/` | `~/.claude/skills/twentythree/` | `.claude/skills/twentythree/` |
+| OpenAI Codex | `~/.codex/` | `~/.codex/skills/twentythree/` | `.agents/skills/twentythree/` |
+| GitHub Copilot | `~/.github/copilot/` | `~/.github/skills/twentythree/` | `.github/skills/twentythree/` |
+| Cursor | `~/.cursor/` | `~/.cursor/skills/twentythree/` | `.cursor/skills/twentythree/` |
+| Windsurf | `~/.codeium/` | `~/.codeium/windsurf/skills/twentythree/` | `.windsurf/skills/twentythree/` |
+| Cline | `~/.clinerules/` | `~/.clinerules/twentythree/` | `.clinerules/twentythree/` |
+| Gemini CLI | `~/.gemini/` | `~/.gemini/skills/twentythree/` | `.gemini/skills/twentythree/` |
+
+The installer copies the same Markdown skill tree into every detected runtime's directory — each agent ingests it as project/skill context. See the [AI agents guide](https://github.com/23/twentythree-cli/blob/master/packages/twentythree-cli/docs/guides/ai-agents.md) for per-runtime quick starts.
 
 ## Prerequisites
 

package/bin/add.js

@@ -38,6 +38,24 @@ const RUNTIMES = [
     globalDest: join(home, '.cursor', 'skills', 'twentythree'),
     projectDest: join(cwd, '.cursor', 'skills', 'twentythree'),
   },
+  {
+    name: 'Windsurf',
+    detect: join(home, '.codeium'),
+    globalDest: join(home, '.codeium', 'windsurf', 'skills', 'twentythree'),
+    projectDest: join(cwd, '.windsurf', 'skills', 'twentythree'),
+  },
+  {
+    name: 'Cline',
+    detect: join(home, '.clinerules'),
+    globalDest: join(home, '.clinerules', 'twentythree'),
+    projectDest: join(cwd, '.clinerules', 'twentythree'),
+  },
+  {
+    name: 'Gemini CLI',
+    detect: join(home, '.gemini'),
+    globalDest: join(home, '.gemini', 'skills', 'twentythree'),
+    projectDest: join(cwd, '.gemini', 'skills', 'twentythree'),
+  },
 ]
 
 function walkDir(dir) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twentythree-skills",
-  "version": "1.3.7",
+  "version": "1.4.0",
   "description": "AI agent skills for the TwentyThree CLI",
   "license": "MIT",
   "author": "TwentyThree",

package/skills/SKILL.md

@@ -44,6 +44,14 @@ Prompts interactively for:
 - **Domain** — your workspace domain (e.g. `company.video.twentythree.com`)
 - **Bearer token** — copy from `Settings → API` inside your TwentyThree workspace admin
 
+**Agentic / non-interactive setup:** the interactive prompt cannot be driven without a TTY. Pass `--domain` to configure credentials without prompts — ask the user for their domain and token first, then run:
+
+```bash
+twentythree auth credentials --domain <domain> --token <token> --json
+```
+
+The token can also be supplied via the `TWENTYTHREE_TOKEN` env var instead of `--token` (keeps it out of shell history). Add `--workspace "<name or domain>"` to pick the active workspace when the token unlocks several; omit the token entirely for anonymous (domain-only) access.
+
 Credentials are stored in the OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service) — never in plaintext files.
 
 Verify auth is working: