Read and write Bluesky: view profiles and timelines, search posts, post, follow, read notifications.

MITAuto-check passedWriting & Content

Install Bluesky

skills CLI
$ npx skills add Anil-matcha/awesome-muse-connectors --skill bluesky -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Anil-matcha/awesome-muse-connectors bluesky --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/bluesky .claude/skills/bluesky && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bluesky
GitHub stars
1.3k
Token cost
~709 tokens
SKILL.md length
245 words
Files
2
Skills in repo
153
Repo updated
First seen
Licence
MIT

At a glance

Read and write Bluesky: view profiles and timelines, search posts, post, follow, read notifications.

  • Works in 4 steps: post and follow are writes: confirm the… → Reading (profile, timeline, search,… → The session manager reuses cached tokens… → …
  • Phrases: bluesky
  • SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Bluesky is an agent skill from Anil-matcha/awesome-muse-connectors. Read and write Bluesky: view profiles and timelines, search posts, post, follow, read notifications. Trigger phrases: bluesky, atproto.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/bluesky.py`).

It sits in Writing & Content. It works with Bluesky. The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

When your agent uses it

  • Phrases: bluesky

Example prompts

  • “/bluesky”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. post and follow are writes: confirm the exact text or target handle with the user before running, unless standing permission exists.
  2. Reading (profile, timeline, search, notifications) needs no confirmation.
  3. The session manager reuses cached tokens and refreshes on 401; it never calls createSession more than needed (rate cap 30/5min). Do not…
  4. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the key value.

What it can do on your machine

Read from SKILL.md and the folder at commit d6dc5d8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bluesky loads about 709 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 245 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~709

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 245 words, ~709 tokens.

Download SKILL.mdSave it as .claude/skills/bluesky/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
bluesky
description
Read and write Bluesky: view profiles and timelines, search posts, post, follow, read notifications. Trigger phrases: bluesky, atproto.
metadata.includeInPrompt
true
tagline
Read timelines, search posts, post and follow.
catalog_auth
App password (per-account; session-based)
catalog_hosts
bsky.social

Bluesky

Purpose

Read and write the user's Bluesky account through the AT Protocol (XRPC): view profiles and the home timeline, search posts, create posts, follow accounts, and list notifications. Use when the user mentions Bluesky or atproto.

Tooling

All commands go through bin/bluesky.py. Every command takes a required --handle (the account handle, e.g. me.bsky.social):

bash
bin/bluesky.py auth --handle me.bsky.social                  # verify the session
bin/bluesky.py profile --handle me.bsky.social               # view a profile (add --target to view someone else)
bin/bluesky.py timeline --handle me.bsky.social              # home timeline
bin/bluesky.py search --handle me.bsky.social --query "agents"  # search posts
bin/bluesky.py post --handle me.bsky.social --text "hello world"  # publish a post (confirm first)
bin/bluesky.py follow --handle me.bsky.social --target them.bsky.social  # follow an account (confirm first)
bin/bluesky.py notifications --handle me.bsky.social         # list notifications

The CLI resolves the account's PDS automatically (via resolveHandle + the DID document), caches the session at .bluesky-session.json next to the skill, and refreshes tokens transparently on 401.

Auth

  • Provider id: bluesky (credential is collected as custom.bluesky)
  • Collection: a Bluesky app password via the secure credential flow (credentials.request_api_access); created in the Bluesky app under Settings > App passwords. Use an app password only, never the main account password.
  • Allowed hosts: bsky.social, public.api.bsky.app, plc.directory, plus the account's resolved PDS host (added at runtime after resolution)
  • Status check: bin/bluesky.py auth --handle <your-handle> (must return "ok": true)

Operating Rules

  1. post and follow are writes: confirm the exact text or target handle with the user before running, unless standing permission exists.
  2. Reading (profile, timeline, search, notifications) needs no confirmation.
  3. The session manager reuses cached tokens and refreshes on 401; it never calls createSession more than needed (rate cap 30/5min). Do not hammer endpoints; respect atproto rate-limit points.
  4. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the key value.

Files

  • SKILL.md
  • bin/bluesky.py

Maturity

🧪 Draft: written from the AT Protocol's public API docs; not yet live-tested end-to-end.

© Anil-matcha, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in connectors/bluesky of Anil-matcha/awesome-muse-connectors.

  • SKILL.md
  • bin/bluesky.py

Open the folder on GitHubat commit d6dc5d8

Compare with similar skills

Bluesky next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bluesky compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bluesky this skillAnil-matcha/awesome-muse-connectors1.3k—~709Automated safety check: PassMIT
Postizgitroomhq/postiz-agent5082 repos~7.9kAutomated safety check: PassAGPL-3.0
Typefullyfreekmurze/dotfiles1k1 repos~3.4kAutomated safety check: NotesNone
Creating Letta Code Channelsletta-ai/skills149—~1.1kAutomated safety check: PassMIT
Outlier Post FinderScrapeCreators/social-media-research-skills3.4k—~1.5kAutomated safety check: NotesMIT
Content Calendar Smsblacktwist/social-media-skills560—~2.8kAutomated safety check: PassMIT

Similar skills

  • Postiz

    gitroomhq/postiz-agent

    Postiz is a tool to schedule social media and chat posts to 28+ channels X, LinkedIn, LinkedIn Page, Reddit, Instagram, Facebook Page, Threads, YouTube, Google My Business, TikTok, Pinterest…

    508 GitHub starsUsed in 2 repos~7.9k tokens
    Writing & ContentAuto-check passed
  • Typefully

    freekmurze/dotfiles

    Create, schedule, and manage social media posts via Typefully.

    1k GitHub starsUsed in 1 repo~3.4k tokens
    Writing & ContentAuto-check: notes
  • Builds and debugs Letta Code channels, including first-party channel adapters and dynamic user channel plugins under ~/.letta/channels.

    149 GitHub stars~1.1k tokensUpdated 8 days ago
    Writing & ContentAuto-check passed
  • Outlier Post Finder

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline.

    3.4k GitHub stars~1.5k tokensUpdated 1 mo ago
    Writing & ContentAuto-check: notes
  • Content Calendar Sms

    blacktwist/social-media-skills

    When the user wants to plan a posting schedule, create a content calendar, or organize when and what to post.

    560 GitHub stars~2.8k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • Content Repurposer Sms

    blacktwist/social-media-skills

    When the user wants to turn one piece of content into multiple formats or adapt content across text-first and visual-first platforms (LinkedIn, Twitter/X, Threads, Bluesky, Facebook, Instagram…

    560 GitHub stars~3.7k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed

More from Anil-matcha/awesome-muse-connectors

All 153 skills in this repo
  • Airtable

    Anil-matcha/awesome-muse-connectors

    List Airtable bases, read table records, and add records. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub stars~511 tokensUpdated 5 days ago
    Auto-check passed
  • Alphavantage

    Anil-matcha/awesome-muse-connectors

    Stock quotes and daily price history. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub stars~517 tokensUpdated 5 days ago
    Auto-check passed
  • Amadeus

    Anil-matcha/awesome-muse-connectors

    Search travel with Amadeus: flight offers and prices, airport autocomplete, hotel offers, cheapest dates.

    1.3k GitHub stars~699 tokensUpdated 5 days ago
    Auto-check passed
  • Apollo

    Anil-matcha/awesome-muse-connectors

    Search B2B contacts with Apollo.io: find people by title and company, enrich contacts and companies.

    1.3k GitHub stars~492 tokensUpdated 5 days ago
    Auto-check passed
  • Aqara

    Anil-matcha/awesome-muse-connectors

    Read and control Aqara smart home devices: plugs, switches, lights, AC, locks, curtains, scenes.

    1.3k GitHub stars~1.6k tokensUpdated 5 days ago
    Auto-check passed
  • Asana

    Anil-matcha/awesome-muse-connectors

    Read and manage Asana tasks: my tasks, task details, create tasks.

    1.3k GitHub stars~481 tokensUpdated 5 days ago
    Auto-check passed

Works with

Questions about Bluesky

What does Bluesky do?

Read and write Bluesky: view profiles and timelines, search posts, post, follow, read notifications. Bluesky is an agent skill from Anil-matcha/awesome-muse-connectors. Read and write Bluesky: view profiles and timelines, search posts, post, follow, read notifications.

When should I use Bluesky?

Bluesky fits situations like: phrases: bluesky.

How do I install Bluesky in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill bluesky -a claude-code`. Or copy the skill folder (connectors/bluesky in Anil-matcha/awesome-muse-connectors) into .claude/skills/bluesky in your project. Claude Code loads it when a task matches its description.

How do I install Bluesky in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill bluesky -a codex`. Or copy the skill folder (connectors/bluesky in Anil-matcha/awesome-muse-connectors) into .agents/skills/bluesky in your project. Codex loads it when a task matches its description.

Can I use Bluesky in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Anil-matcha/awesome-muse-connectors --skill bluesky -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bluesky, .gemini/skills/bluesky, .github/skills/bluesky and .opencode/skills/bluesky in your project.

What does Bluesky need to run?

Going by SKILL.md and its folder, Bluesky needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Bluesky access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bluesky safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bluesky use?

Bluesky is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bluesky use?

About 709 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bluesky?

Skills that share tags, products or a category with Bluesky: Postiz (gitroomhq/postiz-agent, 508 stars), Typefully (freekmurze/dotfiles, 1k stars), Creating Letta Code Channels (letta-ai/skills, 149 stars) and Outlier Post Finder (ScrapeCreators/social-media-research-skills, 3.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bluesky?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,347 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.