claude up some atproto stuff
address retro feedback: public API auth boundaries, ufos guidance, wisp auth model
- app-patterns: document which Bluesky public API endpoints work without
auth (getProfile, getFeed, etc.) vs which don't (searchPosts, getTimeline)
- ufos: emphasize web explorer over raw API for browsing
- wisp: clarify auth is inline during deploy, no separate login subcommand
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+13
-2
+9
skills/app-patterns/SKILL.md
+9
skills/app-patterns/SKILL.md
···
32
32
- **atproto-mcp** — search atproto docs, lexicon schemas, cookbook examples
33
33
- **pub-search** — search published writing across atmosphere platforms for prior art
34
34
35
+
## using the Bluesky public API
36
+
37
+
`public.api.bsky.app` is useful alongside Microcosm — especially for feeds, profiles, and content that Bluesky's AppView has already assembled.
38
+
39
+
**Works without auth:** `app.bsky.actor.getProfile`, `app.bsky.feed.getFeed`, `app.bsky.feed.getPostThread`, `app.bsky.feed.getPosts`, `app.bsky.unspecced.getPopularFeedGenerators`
40
+
41
+
**Requires auth or is heavily rate-limited:** `app.bsky.feed.searchPosts`, `app.bsky.feed.getTimeline`, `app.bsky.notification.*`
42
+
35
43
## notes
36
44
37
45
- all Microcosm services are unauthenticated and support CORS — safe to call directly from client-side apps
46
+
- `public.api.bsky.app` also supports CORS
38
47
- for lexicons beyond `app.bsky.*`, use UFOs to discover what exists
39
48
- check each service's live docs for the latest API details
+3
-1
skills/ufos/SKILL.md
+3
-1
skills/ufos/SKILL.md
···
12
12
**API:** https://ufos-api.microcosm.blue
13
13
**Source:** https://github.com/at-microcosm/microcosm-rs/tree/main/ufos
14
14
15
-
Use it to discover what atproto apps exist beyond Bluesky, check if a lexicon is active, or understand what records look like in an unfamiliar collection. Start with the web explorer for interactive browsing.
15
+
Use it to discover what atproto apps exist beyond Bluesky, check if a lexicon is active, or understand what records look like in an unfamiliar collection.
16
+
17
+
**Start with the web explorer** at ufos.microcosm.blue for interactive browsing — it handles filtering and presentation far better than the raw API, which includes junk/namespace-probing records in results.
16
18
17
19
## API endpoints
18
20
+1
-1
skills/wisp/SKILL.md
+1
-1
skills/wisp/SKILL.md
···
38
38
39
39
## auth
40
40
41
-
The CLI opens a browser for AT Protocol OAuth on first use. Sessions are cached. Don't automate the auth flow — ensure the user has run wispctl once interactively.
41
+
Auth happens inline during `deploy` and other commands — there is no separate `login` subcommand. On first use, the CLI opens a browser for AT Protocol OAuth. Sessions are cached after that. Don't automate the auth flow — ensure the user has run wispctl once interactively.
42
42
43
43
## other commands
44
44