twentythree-skills 1.3.4 → 1.3.6

package/package.json

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

package/skills/reference/video.md

@@ -58,7 +58,29 @@ twentythree video upload ./video.mp4 --title "Q2 Keynote" --category-id <cat-id>
 | Flag | Required | Default | Description |
 |------|----------|---------|-------------|
 | `--limit` | no | — | Maximum number of videos to return (default: all) |
+| `--search` | no | — | Search by title, description, or tags |
+| `--album-id` | no | — | Filter to videos in one or more categories (comma-separated IDs) |
+| `--user-id` | no | — | Filter by uploader (`me` for authenticated user) |
+| `--photo-id` | no | — | Limit results to a single video by its ID |
+| `--live-id` | no | — | Filter to videos associated with a specific webinar |
+| `--tag` | no | — | Filter to videos with a specific tag |
+| `--tags` | no | — | Space-separated list of tags to filter by |
+| `--tag-mode` | no | — | How to combine tag filters: `and` or `or` |
+| `--order-by` | no | — | Sort field: `uploaded`, `published`, `created`, `creation`, `taken`, `title`, `views`, `comments`, `rating`, `numratings`, `video_length`, `words`, `related`, `posted`, `rank`, `default-published` |
+| `--order` | no | — | Sort direction: `asc` or `desc` |
+| `--before-time` | no | — | Filter to videos uploaded before this timestamp (ISO 8601) |
+| `--after-time` | no | — | Filter to videos uploaded after this timestamp (ISO 8601) |
+| `--year` | no | — | Filter to videos from a specific year |
+| `--month` | no | — | Filter to videos from a specific month (1–12, requires `--year`) |
+| `--day` | no | — | Filter to videos from a specific day (1–31, requires `--year` and `--month`) |
+| `--published` / `--no-published` | no | — | Filter by published status |
+| `--promoted` / `--no-promoted` | no | — | Filter by promoted status |
+| `--unalbummed` | no | — | Filter to videos not assigned to any category |
 | `--include-unpublished` | no | — | Include unpublished videos in results |
+| `--include-stats` | no | — | Include per-video performance statistics (view count, play rate, engagement) |
+| `--include-sections-count` | no | — | Include the number of chapters for each video |
+| `--include-user-group` | no | — | Include the user group assignment for each video |
+| `--fields` | no | — | Comma-separated list of fields to return in the API response |
 
 ```bash
 # List all published videos
@@ -66,6 +88,24 @@ twentythree video list --json
 
 # List up to 20 videos including unpublished
 twentythree video list --limit 20 --include-unpublished --json
+
+# Search for videos by keyword, sorted by most viewed
+twentythree video list --search "intro" --order-by views --order desc --json
+
+# Filter to videos in a category
+twentythree video list --album-id 42 --json
+
+# Filter to videos uploaded by the authenticated user
+twentythree video list --user-id me --limit 10 --json
+
+# Filter by date range
+twentythree video list --after-time 2024-01-01T00:00:00Z --before-time 2024-12-31T23:59:59Z --json
+
+# List with stats included
+twentythree video list --include-stats --include-sections-count --json
+
+# Return only specific fields
+twentythree video list --fields photo_id,title,views --json
 ```
 
 ---
@@ -291,6 +331,29 @@ twentythree video section generate 12345 --json
 
 ---
 
+### video section check-generate-available
+
+**Auth scope:** write  **Side effects:** none  **Output:** key-value
+
+Checks whether AI chapter generation is available for a given video. Returns `section_generation_available_p` (boolean). Requires both the workspace feature to be enabled and the video to have a transcript. Use this before calling `video section generate` to avoid errors.
+
+No required flags beyond the video ID positional argument.
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--fields` | no | — | Comma-separated list of fields to return |
+
+```bash
+# Check if AI chapter generation is available
+twentythree video section check-generate-available <id> --json
+
+# Example with a real ID
+twentythree video section check-generate-available 12345 --json
+#    => { "data": { "section_generation_available_p": true } }
+```
+
+---
+
 ### video section set-thumbnail
 
 **Auth scope:** write  **Side effects:** updates  **Output:** key-value

package/skills/reference/webinar.md

@@ -38,6 +38,7 @@ After create, the CLI prints the new webinar ID and its admin URL. Capture `data
 | `--live-date` | no | — | Schedule date/time (ISO 8601) |
 | `--draft` | no | false | Set as draft |
 | `--publish` | no | false | Publish the webinar |
+| `--webinar-design-id` | no | — | Assign a webinar design by ID |
 
 ```bash
 # Create a basic upcoming webinar
@@ -86,6 +87,7 @@ twentythree webinar list --search "Q2 Town Hall" --include-private --json
 | `--live-date` | no | — | Schedule date/time (ISO 8601) |
 | `--draft` | no | — | Set as draft |
 | `--publish` | no | — | Publish or unpublish the webinar |
+| `--webinar-design-id` | no | — | Assign a webinar design by ID |
 
 ```bash
 # Update title and description
@@ -124,6 +126,7 @@ Duplicates a webinar and schedules the copy at a new date/time. After repeat, th
 | Flag | Required | Default | Description |
 |------|----------|---------|-------------|
 | `--date` | yes | — | Schedule date/time for the new webinar (ISO 8601) |
+| `--webinar-design-id` | no | — | Assign a webinar design by ID to the new webinar |
 
 ```bash
 # Schedule a repeat of a webinar
@@ -273,15 +276,20 @@ twentythree webinar speaker list 12345 --json
 
 | Flag | Required | Default | Description |
 |------|----------|---------|-------------|
-| `--name` | no | — | Speaker name |
-| `--email` | no | — | Speaker email |
+| `--name` | yes | — | Speaker name |
+| `--email` | no | — | Speaker email (required for WebRTC speakers) |
 | `--title` | no | — | Speaker title or job title |
 | `--description` | no | — | Speaker bio or description |
+| `--connection-type` | no | `webrtc` | Speaker connection type: `webrtc`, `gearmode`, `rtmp`, `whip`, `srt`, `url` |
+| `--connection-type-pull-url` | no | — | Pull URL for connection types that support stream pull (`whip`, `url`) |
 
 ```bash
-# Add a speaker with name and email
+# Add a WebRTC speaker (email required for webrtc)
 twentythree webinar speaker add <id> --name "Jane Doe" --email jane@example.com --json
 
+# Add an RTMP speaker (no email required)
+twentythree webinar speaker add <id> --name "John Smith" --connection-type rtmp --json
+
 # Add a speaker with full details
 twentythree webinar speaker add <id> --name "John Smith" --email john@example.com --title "CTO" --description "Engineering lead" --json
 ```
@@ -338,11 +346,16 @@ twentythree webinar speaker add-from-user <id> --user-id <user-id> --json
 | `--email` | no | — | Speaker email |
 | `--title` | no | — | Speaker title or job title |
 | `--description` | no | — | Speaker bio or description |
+| `--connection-type` | no | — | Speaker connection type: `webrtc`, `gearmode`, `rtmp`, `whip`, `srt`, `url` |
+| `--connection-type-pull-url` | no | — | Pull URL for connection types that support stream pull (`whip`, `url`) |
 
 ```bash
 # Update a speaker's title and email
 twentythree webinar speaker update <id> <speaker-id> --title "CEO" --email ceo@example.com --json
 
+# Change a speaker's connection type to RTMP
+twentythree webinar speaker update <id> <speaker-id> --connection-type rtmp --json
+
 # Update speaker bio
 twentythree webinar speaker update <id> <speaker-id> --description "Updated bio" --json
 ```