Skip to content

ably/agent-skills

Repository files navigation

Ably Agent Skills

Agent skills that give AI coding agents the context they need to use Ably correctly. Covers product selection, SDK architecture, authentication, channel design, and the common mistakes that cause production issues.

Skills work with any agentskills.io-compatible coding agent, including Claude Code, Cursor, Codex, Windsurf, Gemini CLI, and many more.

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

claude plugin marketplace add ably/agent-skills
claude plugin install ably@ably-agent-skills

Agent Skills CLI (cross-agent)

npx skills add ably/agent-skills

Manual

Copy the skill directory into your agent's configuration:

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:

{
  "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

About

Ably's official collection of agent skills

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors