bluesky-socialOfficial·11 Agent Skills Included

atproto

Build and maintain Bluesky's decentralized social protocol services

Guides AI agents through the AT Protocol TypeScript monorepo behind Bluesky, covering Lexicon codegen, XRPC clients, and server routes. Eliminates guesswork around schema generation, test runner selection, and legacy SDK migration. Helps developers ship protocol-compliant services, OAuth flows, and data validation faster with fewer build errors.

9,624|915

↗

npx skills add bluesky-social/atproto --all -g -y

Available:

Instructs the AI agent on the monorepo layout, build and codegen commands, and when to invoke each sub-skill for testing, Lexicon codegen, XRPC routes, and UI work.

All Skills in This Repository (11)

Pure Emerald Level Indicators

📦 In Repo

bluesky-social

vitest-patterns

Establish Vitest test conventions covering imports, structure, and assertions.

lex-client

Call AT Protocol XRPC services with the typed Client from @atproto/lex.

update-chat-lexicons

Sync chat.bsky Lexicon JSON from the chat repo and regenerate derived TypeScript code.

lex-setup

Configure and troubleshoot @atproto/lex code generation for TypeScript packages.

lexification-server

Migrates service packages from legacy lex gen-server codegen to @atproto/lex and @atproto/xrpc-server.

playwright

Drive and inspect the OAuth provider UI and Account Manager for puppeteer-based UI tests.

lex-schema

Validate, parse, and construct AT Protocol data against Lexicon schemas with @atproto/lex.

testing

Applies monorepo testing conventions for vitest, jest, and integration test fixtures.

lex-data

Parse, serialize, hash, and validate AT Protocol data values with @atproto/lex.

xrpc-server

Build and register XRPC routes on AT Protocol services using @atproto/xrpc-server.

lexification-client

Migrates AT Protocol client code from legacy @atproto/api and @atproto/xrpc to @atproto/lex.

Official

Advanced

Frequently Asked Questions

FAQPage Schema

How to install atproto skills?▼

Run `npx skills add bluesky-social/atproto --all -g -y` in your terminal to install all skills in this suite globally.

What is the AT Protocol reference implementation?▼

It is the official TypeScript codebase for the decentralized protocol behind Bluesky, including the PDS server, AppView, OAuth, and Lexicon SDK packages.

How do I generate TypeScript from Lexicon schemas?▼

The lex-setup skill guides your agent to run `lex build`, which compiles the JSON schemas in lexicons/ into a typed TypeScript tree under src/lexicons/.

Can AI help migrate off the legacy @atproto/api stack?▼

Yes. The lexification-client and lexification-server skills walk the agent through replacing AtpAgent, legacy codegen, and old type guards with the modern @atproto/lex SDK.

Do these skills work with Claude Code and other agents?▼

Yes. All skills follow the standard SKILL.md format and work in Claude Code, Cursor, Codex, and other compatible AI coding agents.