ably-new-command
Installation
SKILL.md
Ably CLI New Command
This skill helps you create new commands for the Ably CLI, including the command file, test file, and any needed index/topic files. The Ably CLI is built on oclif (TypeScript) and has strict conventions that every command must follow.
Step 1: Identify the command pattern
Every command in this CLI falls into one of these patterns. Pick the right one based on what the command does:
| Pattern | When to use | Base class | Client | Example |
|---|---|---|---|---|
| Subscribe | Long-running event listener | AblyBaseCommand |
Realtime | channels subscribe, rooms messages subscribe |
| Publish/Send | Send messages | AblyBaseCommand |
REST or Realtime | channels publish, rooms messages send |
| History | Query past messages/events | AblyBaseCommand |
REST | channels history, rooms messages history |
| Get | One-shot query for current state | AblyBaseCommand |
REST | channels occupancy get, rooms occupancy get |
| List | Enumerate resources via REST API | AblyBaseCommand |
REST | channels list, rooms list |
| Enter | Join presence/space then optionally listen | AblyBaseCommand |
Realtime | channels presence enter, spaces members enter |
| REST Mutation | One-shot REST mutation (no subscription) | AblyBaseCommand |
REST | rooms messages update, rooms messages delete |
| CRUD | Create/read/update/delete via Control API | ControlBaseCommand |
Control API (HTTP) | integrations create, queues delete |