atproto-skills

A Claude Code plugin that packages ATProtocol-specific skills — lexicon design, DID resolution, XRPC, DAG-CBOR, MST/repo inspection, OAuth flows, record parsing — so agents can load specialized knowledge on demand instead of relying on generic recall.

Status

Active. Seven skills shipped:

atproto-attestation — badge.blue record attestations (inline + remote), ECDSA low-S, two-CID model. Rust · TypeScript · Go.
atproto-cid — CID parsing, construction, and validation (DASL / BDASL). Rust · TypeScript · Go.
atproto-identity-resolution — handle ↔ DID resolution, DID documents, bidirectional verification. Rust · TypeScript · Go.
atproto-lexicon — lexicon authoring, schema validation, XRPC invocation, record parsing. Rust · TypeScript · Go.
atproto-oauth — OAuth 2.1 + AT Proto profile (PAR, DPoP, PKCE, private_key_jwt). Rust · TypeScript (Node + Browser) · Go.
atproto-publish-lexicon — publish lexicons as com.atproto.lexicon.schema records; NSID authority binding.
atproto-repository — CAR v1, MST, DRISL canonical CBOR, commit signing/verification. Rust · TypeScript · Go.

Six are polyglot (language-neutral spec with per-language guides); atproto-publish-lexicon is a single-file skill. Skills load automatically when their trigger terms appear in conversation — see each skill's description for the full trigger surface.

Bluesky-domain record idioms (app.bsky.* facets, richtext, embeds, threadgates, labels) are out of scope for this plugin.

Install

The repo ships a marketplace manifest at .claude-plugin/marketplace.json. Add it to your Claude Code config:

{
  "extraKnownMarketplaces": {
    "atproto-skills": {
      "source": {
        "source": "github",
        "repo": "ngerakines/atproto-skills"
      }
    }
  },
  "enabledPlugins": {
    "atproto-skills@atproto-skills": true
  }
}

Prefer to work from a local clone? Swap the source:

"source": { "source": "filesystem", "path": "/absolute/path/to/atproto-skills" }

Use

Skills are loaded by Claude Code on demand based on their description field. You don't invoke them directly — just work on ATProto code and talk about what you're doing in natural language ("my did:plc lookup is returning 404", "help me design a lexicon for…"). When a skill matches, the agent pulls it into context automatically.

Skills

Each skill lives at skills/<name>/ with a polyglot structure (shared/ + rust/ / typescript/ / go/) unless noted otherwise. The scenarios below are the kinds of prompts that will load the skill.

`atproto-attestation`

Inline and remote record attestations per the badge.blue specification. Rust · TypeScript · Go.

"Sign this record with an inline ECDSA attestation and append it to signatures[]."
"Write a remote attestation: put a proof record in my repo, reference it from the subject via strongRef."
"Verify the attestations on this record I just fetched — inline and remote both."
"I'm getting RemoteAttestationCidMismatch / SignatureValidationFailed — walk me through what could be off."
"Port my Rust atproto-attestation signing code to @noble/curves in TypeScript."

`atproto-cid`

CID parsing, construction, and validation under the DASL / BDASL profile. Rust · TypeScript · Go.

"Parse bafyreib... and tell me whether it's a valid DASL CID."
"Compute the CID for this DAG-CBOR record / this raw blob."
"Decode the $link form in this JSON and the CBOR tag-42 form in this binary."
"My encoder and my PDS disagree on the CID — what's wrong with my canonicalization?"
"Add BLAKE3 (BDASL) support for hashing large video blobs."

`atproto-identity-resolution`

Handle ↔ DID resolution, DID document handling, and bidirectional verification. Rust · TypeScript · Go.

"Resolve alice.bsky.social to a DID — try DNS TXT and /.well-known/atproto-did concurrently."
"Resolve did:plc:… to a DID document, extract the PDS endpoint and signing key."
"Run bidirectional verification: handle → DID → alsoKnownAs → handle."
"My user's handle is showing handle.invalid — what's the recovery flow?"
"Why does this did:web resolve but did:webvh rejects at fetch time in my library?"

`atproto-lexicon`

Lexicon authoring, schema validation, XRPC invocation, and protocol-level record parsing. Rust · TypeScript · Go.

"Author a lexicon for a com.example.notes.entry record with an open union and a strongRef."
"Validate this record against its lexicon — strict on write, lenient on read."
"Invoke com.atproto.repo.listRecords with typed inputs/outputs from my Go client."
"Consume the firehose and dispatch on $type without a codegen step."
"I want to add a field to an existing lexicon — is this change backward-compatible?"

`atproto-oauth`

atproto-skills

Status

Active. Seven skills shipped:

atproto-attestation — badge.blue record attestations (inline + remote), ECDSA low-S, two-CID model. Rust · TypeScript · Go.
atproto-cid — CID parsing, construction, and validation (DASL / BDASL). Rust · TypeScript · Go.
atproto-identity-resolution — handle ↔ DID resolution, DID documents, bidirectional verification. Rust · TypeScript · Go.
atproto-lexicon — lexicon authoring, schema validation, XRPC invocation, record parsing. Rust · TypeScript · Go.
atproto-oauth — OAuth 2.1 + AT Proto profile (PAR, DPoP, PKCE, private_key_jwt). Rust · TypeScript (Node + Browser) · Go.
atproto-publish-lexicon — publish lexicons as com.atproto.lexicon.schema records; NSID authority binding.
atproto-repository — CAR v1, MST, DRISL canonical CBOR, commit signing/verification. Rust · TypeScript · Go.

Bluesky-domain record idioms (app.bsky.* facets, richtext, embeds, threadgates, labels) are out of scope for this plugin.

Install

The repo ships a marketplace manifest at .claude-plugin/marketplace.json. Add it to your Claude Code config:

{
  "extraKnownMarketplaces": {
    "atproto-skills": {
      "source": {
        "source": "github",
        "repo": "ngerakines/atproto-skills"
      }
    }
  },
  "enabledPlugins": {
    "atproto-skills@atproto-skills": true
  }
}

Prefer to work from a local clone? Swap the source:

"source": { "source": "filesystem", "path": "/absolute/path/to/atproto-skills" }

Use

Skills

`atproto-attestation`

Inline and remote record attestations per the badge.blue specification. Rust · TypeScript · Go.

"Sign this record with an inline ECDSA attestation and append it to signatures[]."
"Write a remote attestation: put a proof record in my repo, reference it from the subject via strongRef."
"Verify the attestations on this record I just fetched — inline and remote both."
"I'm getting RemoteAttestationCidMismatch / SignatureValidationFailed — walk me through what could be off."
"Port my Rust atproto-attestation signing code to @noble/curves in TypeScript."

`atproto-cid`

CID parsing, construction, and validation under the DASL / BDASL profile. Rust · TypeScript · Go.

"Parse bafyreib... and tell me whether it's a valid DASL CID."
"Compute the CID for this DAG-CBOR record / this raw blob."
"Decode the $link form in this JSON and the CBOR tag-42 form in this binary."
"My encoder and my PDS disagree on the CID — what's wrong with my canonicalization?"
"Add BLAKE3 (BDASL) support for hashing large video blobs."

`atproto-identity-resolution`

Handle ↔ DID resolution, DID document handling, and bidirectional verification. Rust · TypeScript · Go.

"Resolve alice.bsky.social to a DID — try DNS TXT and /.well-known/atproto-did concurrently."
"Resolve did:plc:… to a DID document, extract the PDS endpoint and signing key."
"Run bidirectional verification: handle → DID → alsoKnownAs → handle."
"My user's handle is showing handle.invalid — what's the recovery flow?"
"Why does this did:web resolve but did:webvh rejects at fetch time in my library?"

`atproto-lexicon`

Lexicon authoring, schema validation, XRPC invocation, and protocol-level record parsing. Rust · TypeScript · Go.

"Author a lexicon for a com.example.notes.entry record with an open union and a strongRef."
"Validate this record against its lexicon — strict on write, lenient on read."
"Invoke com.atproto.repo.listRecords with typed inputs/outputs from my Go client."
"Consume the firehose and dispatch on $type without a codegen step."
"I want to add a field to an existing lexicon — is this change backward-compatible?"

Help us improve

Find plugins for your project

Help us improve

atproto-skills

Popularity

What's Inside

Help us improve

Health & Quality

Confidence

README

atproto-skills

Status

Install

Use

Skills

`atproto-attestation`

`atproto-cid`

`atproto-identity-resolution`

`atproto-lexicon`

`atproto-oauth`

Similar Plugins

jacquard

autology

persona-pack

Vouch Protocol

fedify

fullstack-dev-skills

More by ngerakines

jd

cosmic-grackle

atproto-skills

Status

Install

Use

Skills

`atproto-attestation`

`atproto-cid`

`atproto-identity-resolution`

`atproto-lexicon`

`atproto-oauth`