Skip to content

Add Agent Skills documentation and signposts across getting started guides#3295

Open
umair-ably wants to merge 1 commit intomainfrom
agent-skills-docs
Open

Add Agent Skills documentation and signposts across getting started guides#3295
umair-ably wants to merge 1 commit intomainfrom
agent-skills-docs

Conversation

@umair-ably
Copy link
Contributor

Summary

  • Adds a new "Agent skills" section to the Building with LLMs page with install commands and skill descriptions
  • Reframes the existing LLM configuration prompt section as a manual alternative
  • Adds an Aside callout to all getting started guides (Pub/Sub, Chat, AI Transport) and their index pages linking to Agent Skills

Files changed (30)

  • src/pages/docs/platform/ai-llms/index.mdx — new Agent Skills section + reframed manual prompt heading
  • 15 Pub/Sub getting started guides — Aside before Prerequisites
  • 8 Chat getting started guides — Aside before Prerequisites
  • 4 AI Transport getting started guides — Aside before Prerequisites
  • 2 getting started index pages — Aside before Tiles

Test plan

  • /docs/platform/ai-llms — Agent Skills section renders correctly with code blocks
  • /docs/getting-started — Aside appears on index page
  • /docs/getting-started/javascript — Aside appears before Prerequisites
  • /docs/chat/getting-started — Aside appears on index page
  • /docs/chat/getting-started/javascript — Aside appears before Prerequisites
  • /docs/ai-transport/getting-started/anthropic — Aside appears before Prerequisites
  • Lint passes with no new warnings

🤖 Generated with Claude Code

@coderabbitai
Copy link

coderabbitai bot commented Mar 25, 2026

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 0b140043-776c-4a3d-867e-5875d5e7834f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent-skills-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@umair-ably umair-ably requested a review from m-hulbert March 25, 2026 11:15
Copy link
Contributor

@m-hulbert m-hulbert left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just 1 comment Umair. We also have getting started guides for push as well if you think they'd benefit from the context.

These are your first steps towards building a Chat application that can effortlessly scale to serve millions of users.

<Aside data-type='note'>
Using an AI coding assistant? [Teach it Ably](/docs/platform/ai-llms#agent-skills) with Agent Skills for Claude Code, Cursor, Copilot, and more. Run `claude plugin add ably/agent-skills` or `npx skills add ably/agent-skills` to get started.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Any reason not to have the longer version on the guides themselves?

I'd also suggest rather than listing out all the different agents with an 'and more', we just say something like 'for all popular agents' or something similar.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants