- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add oaustegard/claude-skills --skill atprotoing -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add oaustegard/claude-skills --skill atprotoing -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add oaustegard/claude-skills --skill atprotoing -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add oaustegard/claude-skills --skill atprotoing -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/oaustegard/claude-skills/tree/HEAD/atprotoing來自發布者
Reads the atmosphere from sources that stay up when Bluesky PLC's AppView does not. On 2026-08-16 the AppView timed out and Jetstream returned 503 while PDSes and Constellation served every request — this skill is built around that split.
python3 <skill>/scripts/atproto.py <command> [--json]
Digest output is the default and is what belongs in a transcript. Reach for
--json only when the result will be transformed programmatically; raw records
are large and re-reading them into context defeats the purpose.
Each read targets the cheapest source that survives independently. Prefer the PDS for anything a repo owns — it is authoritative and had no outage.
feed is the one composite read: there is no AppView-free getTimeline, so it
rebuilds the Following timeline from follows → PLC → each followee's PDS, then
hydrates what the AppView would have inlined — facet byte-ranges to character
ranges, blob CIDs to cdn.bsky.app URLs, quote and parent URIs to fetched
records — and threads the result by reply root. --html writes a self-contained
Preact reader (same components as austegard.com/bsky/thread-reader.html), so a
feed request is one call, not a fan-out the caller re-derives by hand.
Ranking, mutes, and blocks live in the AppView and are absent by construction:
this is the raw follow graph.
Constellation is the persistent index. Do not rebuild one locally: it already indexes the whole network, is operated independently of Bluesky PLC, and is reachable when the AppView is not.
interactions walks the five Bluesky paths in LINK_PATHS. backlinks walks
whatever Constellation has indexed — tangled issues, vouches, list membership,
lexicons nobody here has heard of — so reach for it when the question is "who
references this, anywhere" rather than "who liked this post". Both are
two-phase for the same reason: links/all reports which sources are non-empty,
and only then does enumeration cost anything.
lexicons answers a different question from sample_firehose in
browsing-bluesky: UFOs consumes Jetstream and rolls it up per NSID, so a
single call reports what is running across the whole network without sampling
anything here. --others drops app.bsky., chat.bsky. and com.atproto.,
which is what turns the leaderboard from "Bluesky is large" into a list of the
other apps. --schema NSID fetches the published lexicon document from the
publisher's own repo, deriving the publisher by the reverse-DNS convention
(com.whtwnd.blog.entry → whtwnd.com); publishing that record is optional and
plenty of busy collections skip it, so a miss is a fact about the publisher, not
a failure.
State is a /tmp SQLite scratch (ATPROTO_CACHE to relocate), session-scoped
by design. Cold start is the only start, and that is fine because wall-clock
and token cost are decoupled — the script absorbs the HTTP fan-out and returns
a digest. Measured: interactions --hours 8 over 100 posts ≈ 18s and ~30 output
lines, against ~15 tool calls doing it by hand.
interactions is two-phase on purpose: one cheap links/all per post reports
which link paths are non-empty, so per-path enumeration only runs where
something exists. Preserve that when extending.
Unavailable is raised for egress blocks, 4xx, and exhausted retries; the CLI
exits 2 with the reason on stderr. Report which layer failed rather than
retrying blindly — "the AppView is down" and "atproto is down" are different
facts and the distinction is usually the answer the user wants.
Two known limits worth stating plainly when they bite:
aturi.to/api/mcp (hosted, keyless, read-only, beta) covers the same three
areas and about 30 more. It was measured on 2026-08-28 at 38 tools / ~8.6k
tokens of schema resident per session, returning pretty-printed JSON rather
than digests, with every read routed through one host. These commands go
straight to plc.directory, Constellation and UFOs, which is the point of this
skill — the 2026-08-16 split is exactly the case a single upstream reintroduces.
Use the MCP for what it alone has: the waypoint catalog and the atproto docs
search. Do not route these three through it.
This skill reads. For posting, use muninn_utils.bsky_card — it already writes
straight to the PDS (facets, blobs, embeds, create_session) and therefore
works during an AppView outage. muninn_utils.bsky_limit enforces the
300-grapheme cap, which len() gets wrong on emoji and combining marks.
Read Bluesky/ATProto without depending on Bluesky's AppView — interactions on a user's posts, thread replies, any repo's records, network-wide backlinks across every lexicon, an account's handle and P
---name: atprotoingdescription: Read Bluesky/ATProto without depending on Bluesky's AppView — interactions on a user's posts, thread replies…---# atprotoing/SKILL.md總覽
Read Bluesky/ATProto without depending on Bluesky's AppView — interactions on a user's posts, thread replies, any repo's records, network-wide backlinks across every lexicon, an account's handle and PDS history, which collections are active network-wide, and layer-by-layer outage diagnosis. Use when bsky.app or the AppView is down or slow, when a Bluesky read returns timeouts or 5xx, when asked who liked/replied/quoted/reposted something, when pulling live Bluesky context cheaply, when reading records straight from a PDS, when asked who references a record or account anywhere on the network, whether an account has changed handle or migrated servers, or which lexicons and non-Bluesky apps are active on atproto. Complements browsing-bluesky, which routes everything through the AppView and fails when it does.
常見問題
從發布者下載 atprotoing/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/oaustegard/claude-skills。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。