https://github.com/ably/agent-skills
Ably's official collection of agent skills
https://github.com/ably/agent-skills
Last synced: 2 months ago
JSON representation
Ably's official collection of agent skills
- Host: GitHub
- URL: https://github.com/ably/agent-skills
- Owner: ably
- License: apache-2.0
- Created: 2026-02-16T17:06:11.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-08T12:53:21.000Z (3 months ago)
- Last Synced: 2026-03-08T16:29:31.340Z (3 months ago)
- Language: TypeScript
- Size: 48.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Ably Agent Skills
Agent skills that give AI coding agents the context they need to use [Ably](https://ably.com) correctly. Covers product selection, SDK architecture, authentication, channel design, and the common mistakes that cause production issues.
Skills work with any [agentskills.io-compatible](https://agentskills.io) coding agent, including Claude Code, Cursor, Codex, Windsurf, Gemini CLI, and [many more](https://agentskills.io).
## Skills
| Skill | Purpose | Auto-triggers when |
|-------|---------|-------------------|
| `using-ably` | Product selection, SDK patterns, auth, channel design, common gotchas | Any Ably-related work |
| `debugging-with-ably-cli` | Diagnostic decision trees, CLI capabilities, state reference, environment gotchas | Diagnosing Ably issues |
### `using-ably` — Primary Knowledge Skill
The core skill. Provides curated domain knowledge that agents frequently get wrong: choosing the right product/SDK, JWT vs token auth, modern v2.x patterns, Chat SDK lifecycle (attach before subscribe!), React integration pitfalls, and a production checklist.
### `debugging-with-ably-cli` — CLI Debugging Skill
Teaches agents what the Ably CLI can do and when to use each capability for diagnosing issues. Covers diagnostic reasoning (symptom → CLI approach), key debugging facts, connection/channel state machines, and environment-specific gotchas. Agents discover exact command syntax via `ably --help` at runtime.
## Installation
### Claude Code Plugin
```bash
claude plugin marketplace add ably/agent-skills
claude plugin install ably@ably-agent-skills
```
### Agent Skills CLI (cross-agent)
```bash
npx skills add ably/agent-skills
```
### Manual
Copy the skill directory into your agent's configuration:
```bash
git clone https://github.com/ably/agent-skills.git
cp -r agent-skills/skills/using-ably .skills/
```
## Recommended Permissions
Skills fetch Ably documentation via `WebFetch`. To avoid repeated permission prompts, add to `.claude/settings.json`:
```json
{
"permissions": {
"allow": [
"WebFetch(ably.com/*)",
"WebSearch"
]
}
}
```
## How It Works
The skill provides curated knowledge — architectural decisions, SDK patterns, auth, and common mistakes that documentation alone doesn't prevent. Every claim is verified against current Ably docs. Directs agents to fetch `ably.com/llms.txt` before writing code.
## License
Apache-2.0