From 21d41c28c82c9af36c8c31c9bcc595d9054ad854 Mon Sep 17 00:00:00 2001 From: Patrick Singletary Date: Mon, 17 Aug 2026 21:45:45 -0400 Subject: [PATCH] atproto-digest Phase 7: add SKILLS-INDEX.md, cross-links in atproto-development --- skills/SKILLS-INDEX.md | 65 +++++++++++++++++++ .../atproto-development/SKILL.md | 8 +++ 2 files changed, 73 insertions(+) create mode 100644 skills/SKILLS-INDEX.md diff --git a/skills/SKILLS-INDEX.md b/skills/SKILLS-INDEX.md new file mode 100644 index 0000000..096d837 --- /dev/null +++ b/skills/SKILLS-INDEX.md @@ -0,0 +1,65 @@ +# ATProto Skills Index + +Master index of the ATProto/Bluesky skill set in this repo. Load `atproto-ecosystem-map` +first if you're not sure which skill you need — it routes every task. + +## Routing by task + +| Task | Skill | +|---|---| +| "How does the network work / where do I start?" | atproto-ecosystem-map | +| Python SDK (Client, Firehose, Jetstream, IdResolver) | atproto-python | +| JS/TS apps, OAuth, deploy, DID:WEB basics | atproto-development | +| Real-time binary stream (relays, subscribeRepos) | atproto-relays-firehose | +| JSON streams, providers, edge caches, archive replay | atproto-jetstream-providers | +| PDS provisioning, migration, health checks | atproto-pds-ops | +| Lexicon discovery, authoring, publishing | atproto-lexicon-registry | +| did:web via goat, PLC ops, passkey rotation | atproto-identity-deep | +| Custom feeds, feed generators, algorithms | atproto-feeds-algorithms | +| Labels, labelers, ozone, mutes/blocks, mod lists | atproto-moderation-tools | +| Phishing/OAuth/key-custody posture + audit tooling | atproto-security-landscape | +| "Is there a tool that...?" / client & utility index | atproto-tools-catalog | +| Blob tooling (orphans, backup, cleanup) | atproto-blob-lifecycle | +| Static site deploy (wispctl, Tangled Sites) | atproto-site-deployment | +| Small-biz domain/DID/PDS migration | small-business-atproto-migration | +| Bluesky post embeds in web apps | bluesky-post-embeds | +| Semble (Cosmik) knowledge-network API | semble-cosmik | + +## Full index + +### In this repo (~/dev/_shared/skills/software-development/) + +| Skill | Scope | Status | +|---|---|---| +| atproto-ecosystem-map | Network roles (PDS/relay/jetstream/appview/labeler) + infra registry + routing | live (2026-08-17) | +| atproto-relays-firehose | Relay network, subscribeRepos, replay windows | live (2026-08-17) | +| atproto-jetstream-providers | Jetstream v2, providers, edge caches, archive replay | live (2026-08-17) | +| atproto-pds-ops | PDS hosting, migration (incl. adversarial), health/debug tools | live (2026-08-17) | +| atproto-lexicon-registry | Lexicon registries, authoring, interop clusters | live (2026-08-17) | +| atproto-identity-deep | did:web via goat, PLC mirrors/ops, passkeys as rotation keys | live (2026-08-17) | +| atproto-feeds-algorithms | Feed generators, algorithmic patterns, discovery | live (2026-08-17) | +| atproto-moderation-tools | Labels/labelers, ozone, mutes/blocks/mod lists | live (2026-08-17) | +| atproto-security-landscape | Risk surfaces, audit tooling, standing security rules | live (2026-08-17) | +| atproto-tools-catalog | Curated app/utility index (full 897-URL catalog in docs/atproto-digest/) | live (2026-08-17) | + +### In the Hermes profile (~/.hermes/skills/) — authored earlier + +| Skill | Scope | +|---|---| +| atproto-development | JS/TS @atproto/api, OAuth, wisp/Tangled deploy, DID:WEB, post-edit pitfall, CRA traps | +| atproto-python | MarshalX Python SDK: clients, namespaces, models, firehose/jetstream, identity, DMs | +| atproto-blob-lifecycle | Blob tools: orphan scans, backup, cleanup | +| atproto-site-deployment | Static site deploy to Tangled/wisp.place | +| small-business-atproto-migration | Small-biz ATProto migration: domains, DID, PDS, wisp, bsky | +| bluesky-post-embeds | Embedding Bluesky posts via oEmbed | +| semble-cosmik | Semble xrpc API (cards, collections, feeds) | + +## Conventions + +- Skills live in `software-development/`; symlinked into `~/.hermes/skills/` (Hermes) + and `~/.agents/skills/` (Claude Code) so any agent can load them. +- All ecosystem facts date from the digest snapshot (2026-08-17); live infra + registry facts should be re-verified via firehose.directory / pds.directory / + plc.directory before production use. +- Source data: `~/dev/_shared/docs/atproto-digest/` (catalog.md, classification.json, + notes/, deepdive-list.md). diff --git a/skills/software-development/atproto-development/SKILL.md b/skills/software-development/atproto-development/SKILL.md index 150957b..53b6e71 100644 --- a/skills/software-development/atproto-development/SKILL.md +++ b/skills/software-development/atproto-development/SKILL.md @@ -391,6 +391,14 @@ This keeps the PDS identity separate from the public-facing business domain, pre For Python implementations (MarshalX/atproto): `Client`/`AsyncClient`, namespaces, models, Firehose/Jetstream streaming, `IdResolver`, DMs — see the `atproto-python` skill. This skill covers the JS/TS side (@atproto/api, OAuth, wisp/Tangled deploy, DID:WEB). +## Ecosystem skills (from the 2026-08 digest) + +Network roles, infra registry, and per-domain depth live in sibling skills in this +repo: `atproto-ecosystem-map` (start here), `atproto-relays-firehose`, +`atproto-jetstream-providers`, `atproto-pds-ops`, `atproto-lexicon-registry`, +`atproto-identity-deep`, `atproto-feeds-algorithms`, `atproto-moderation-tools`, +`atproto-security-landscape`, `atproto-tools-catalog`. See SKILLS-INDEX.md. + ## CRA/webpack 5 + @atproto Pitfalls (blank page) Symptom: deployed CRA app renders a blank page; console shows -- 2.51.2