What problem does it solve?
Making authenticated or unauthenticated HTTP calls to AT Protocol XRPC services requires juggling sessions, headers, service proxying, retries, and schema validation by hand. This Skill provides the patterns for using the Client from @atproto/lex so those concerns are handled consistently and type-safely.
Core Features & Use Cases
- Session-based requests: Construct a client from an OAuth session, an app-password
PasswordSession, a static service credential, or a custom agent, then call any Lexicon-defined query or procedure.
- Repository operations: Create, read, update, delete, list, and batch-write records, plus upload and fetch blobs, with typed results and optimistic-concurrency options.
- Resilience and control: Configure retries, request/response validation, labelers, service proxying, and handle typed XRPC errors via throwing or discriminated-result APIs.
- Use Case: A bot logs in with an app password, pages through a user's posts with
listAll, and atomically deletes stale records with applyWrites, all with automatic retries and schema-checked responses.
Quick Start
Ask the AI to write a TypeScript script that logs into Bluesky with an app password using PasswordSession and creates a feed post via the @atproto/lex Client.