Create and manage content for Bluesky social network. An agent skill from OpenClaudia/openclaudia-skills.

MITAuto-check passedWriting & Content

Install Bluesky

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill bluesky -a claude-code

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

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills 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/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/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
713
Token cost
~1.4k tokens
SKILL.md length
480 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Create and manage content for Bluesky social network. An agent skill from OpenClaudia/openclaudia-skills.

  • Works in 5 steps: Reply generously — The community is… → Repost with comment — Add your take when… → Follow custom feeds — Find your niche… → …
  • The user says Bluesky post
  • SKILL.md covers Platform Overview, Content Strategy, Writing for Bluesky and Engagement Tactics, plus 3 more sections
  • Calls curl; reaches bsky.social; needs ACCESS_TOKEN and BLUESKY_APP_PASSWORD

What it does

Bluesky is an agent skill from OpenClaudia/openclaudia-skills. Create and manage content for Bluesky social network. Use when the user says "Bluesky post", "post to Bluesky", "Bluesky content", "Bluesky strategy", "AT Protocol", or asks about creating content for or engaging on Bluesky.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Content strategy. It works with Bluesky. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • The user says Bluesky post
  • Post to Bluesky
  • Bluesky content
  • Bluesky strategy

Example prompts

  • “Bluesky post”
  • “post to Bluesky”
  • “Bluesky content”
  • “/bluesky”

Requirements

  • A credential in ACCESS_TOKEN

Workflow steps

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

  1. Reply generously — The community is small enough that genuine replies build relationships fast
  2. Repost with comment — Add your take when sharing others' posts
  3. Follow custom feeds — Find your niche audience through topic feeds
  4. Create a custom feed — Establish authority by curating a feed for your niche
  5. Cross-reference other platforms — "I wrote about this in more detail on my blog" (with link)

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. 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

    Shell commands in SKILL.md call:

    • curl

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • bsky.social

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ACCESS_TOKEN
    • BLUESKY_APP_PASSWORD

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

Context cost

Bluesky loads about 1.4k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 480 words of instructions outside code blocks.

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

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 OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 480 words, ~1,434 tokens.

Download SKILL.mdSave it as .claude/skills/bluesky/SKILL.md (or your agent's skills folder).
name
bluesky
description
Create and manage content for Bluesky social network. Use when the user says "Bluesky post", "post to Bluesky", "Bluesky content", "Bluesky strategy", "AT Protocol", or asks about creating content for or engaging on Bluesky.

Bluesky Social Media Skill

You are a Bluesky content and engagement specialist. Help create, schedule, and strategize content for the Bluesky social network (AT Protocol).

Platform Overview

Bluesky is a decentralized social network built on the AT Protocol. Key differences from Twitter/X:

  • 300 character limit per post (vs. 280 on X)
  • Algorithmic choice — Users pick their own feed algorithms
  • Custom feeds — Anyone can create topic-based feeds
  • No ads — Organic reach is the only reach
  • Open API — Full AT Protocol access for automation
  • Decentralized — Users own their identity and data

Content Strategy

What Works on Bluesky
Content TypePerformanceNotes
Hot takes & opinionsHighEarly-adopter audience loves debate
Industry insightsHighTech, media, and culture topics thrive
Threads (long-form)HighNo algorithm penalty for threads
Original humorMedium-HighNot memes — original wit
Community engagementHighReply culture is stronger than on X
Self-promotionLow-MediumTolerated if mixed with value
Link sharesMediumNo link penalty (unlike LinkedIn)
Visual contentMediumGrowing but not primary format
Bluesky Audience Profile (2026)
  • Tech-forward early adopters
  • Journalists and media professionals
  • Academic and research community
  • Open-source and decentralization advocates
  • Users who left Twitter/X
  • Creator economy participants
Content Calendar

Posting frequency: 2-5 posts per day (higher tolerance than LinkedIn/Instagram) Best times: Morning (8-10am ET) and early evening (5-7pm ET) Thread timing: Post threads in morning for maximum engagement

Writing for Bluesky

Post Formulas

1. Insight + Context (Best performer)

{One sentence insight about industry/topic.}

{Why this matters or what it means for the audience.}

2. Question + Take

{Provocative question?}

My take: {Your opinion in 1-2 sentences.}

3. Short observation

{Brief, punchy observation about something you noticed today.}

4. Thread opener (for multi-post threads)

{Topic I've been thinking about:}

A thread 🧵
Thread Structure

Bluesky threads work well for longer content:

Post 1 (Hook): {Compelling opener that makes people want to read more}

Post 2-N (Body): {One point per post, 1-3 sentences each}

Final post: {Summary + CTA (follow, repost, or reply)}

Thread rules:

  • Each post should be independently valuable
  • 5-10 posts is the sweet spot
  • Number your posts if sequential (1/8, 2/8, etc.)
  • End with a clear takeaway
Show full SKILL.md (201 more words)Show less
Hashtag Strategy

Bluesky doesn't have traditional hashtags. Instead:

  • Use descriptive text that feeds can pick up
  • Mention relevant topics naturally
  • Custom feeds use keyword matching, so include relevant terms

Engagement Tactics

  1. Reply generously — The community is small enough that genuine replies build relationships fast
  2. Repost with comment — Add your take when sharing others' posts
  3. Follow custom feeds — Find your niche audience through topic feeds
  4. Create a custom feed — Establish authority by curating a feed for your niche
  5. Cross-reference other platforms — "I wrote about this in more detail on my blog" (with link)

AT Protocol API (Automation)

For programmatic posting and engagement:

Authentication:

bash
# Create session
curl -s -X POST "https://bsky.social/xrpc/com.atproto.server.createSession" \
  -H "Content-Type: application/json" \
  -d '{"identifier": "${BLUESKY_HANDLE}", "password": "${BLUESKY_APP_PASSWORD}"}'

Create post:

bash
curl -s -X POST "https://bsky.social/xrpc/com.atproto.repo.createRecord" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "repo": "${DID}",
    "collection": "app.bsky.feed.post",
    "record": {
      "$type": "app.bsky.feed.post",
      "text": "Your post text here",
      "createdAt": "'$(date -u +%Y-%m-%dT%H:%M:%S.000Z)'"
    }
  }'

Search posts:

bash
curl -s "https://bsky.social/xrpc/app.bsky.feed.searchPosts?q={keyword}&limit=25" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

Get profile:

bash
curl -s "https://bsky.social/xrpc/app.bsky.actor.getProfile?actor={handle}" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

Output Format

When creating Bluesky content:

markdown
## Bluesky Post

**Type:** {Single post / Thread / Reply}
**Target audience:** {Who this is for}

---

{The actual post text, within 300 characters}

---

**Engagement strategy:** {How to maximize reach for this post}
**Reply prompt:** {Suggested reply if someone engages}

For threads:

markdown
## Bluesky Thread ({N} posts)

**Topic:** {Thread topic}

---

**1/{N}:** {Hook post}

**2/{N}:** {Point 1}

...

**{N}/{N}:** {Summary + CTA}

---

Important Notes

  • Bluesky's culture values authenticity. Overly promotional or corporate tone will be ignored.
  • The platform is growing but still smaller than X. Focus on relationship building, not viral scale.
  • App passwords (not your main password) are used for API access. Generate at Settings > App Passwords.
  • Custom feeds are Bluesky's killer feature. If you can create a useful feed for your niche, you gain ongoing visibility.
  • Cross-posting from X is frowned upon. Adapt content for the platform's voice and culture.

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

Files

Just SKILL.md in skills/bluesky of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

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 skillOpenClaudia/openclaudia-skills713—~1.4kAutomated safety check: PassMIT
Content Calendar Smsblacktwist/social-media-skills559—~2.8kAutomated safety check: PassMIT
Contentnotque/vexjoy-agent439—~2.9kAutomated safety check: NotesMIT
Platform Strategy Smsblacktwist/social-media-skills559—~3.8kAutomated safety check: PassMIT
Social Publisherericrisco/rsc-harness174—~3.2kAutomated safety check: PassMIT
Blogger Distillerotter1101/blogger-distiller697—~3.8kAutomated safety check: NotesMIT

Similar skills

  • 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.

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

    notque/vexjoy-agent

    Content operations: editorial calendar, marketing, publishing, social media management.

    439 GitHub stars~2.9k tokensUpdated 6 days ago
    Writing & ContentAuto-check: notes
  • Platform Strategy Sms

    blacktwist/social-media-skills

    When the user wants platform-specific tactical guidance for LinkedIn, Twitter/X, Threads, or Bluesky.

    559 GitHub stars~3.8k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • Social Publisher

    ericrisco/rsc-harness

    A skill your agent uses when planning a posting schedule, building a multi-platform content calendar, or reshaping one source asset into channel-native posts across X, LinkedIn, Instagram, Threads…

    174 GitHub stars~3.2k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Blogger Distiller

    otter1101/blogger-distiller

    A skill your agent uses when the user wants to analyze or distill a blogger/account on Xiaohongshu or Douyin, benchmark a target creator, or diagnose their own content strategy.

    697 GitHub stars~3.8k tokensUpdated 16 days ago
    Writing & ContentAuto-check: notes
  • Linkedin Content Planner

    sergebulaev/linkedin-skills

    Generate a 7-day LinkedIn content plan from a theme, audience, and pillars.

    4.4k GitHub starsUsed in 1 repo~2.1k tokens
    Writing & ContentAuto-check passed

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    713 GitHub stars~1.2k tokensUpdated 21 days ago
    Auto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    713 GitHub stars~694 tokensUpdated 21 days ago
    Auto-check passed
  • Gsc Portfolio Audit

    OpenClaudia/openclaudia-skills

    Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

    713 GitHub stars~1k tokensUpdated 21 days ago
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    713 GitHub stars~882 tokensUpdated 21 days ago
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    713 GitHub stars~1.9k tokensUpdated 21 days ago
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~1.7k tokensUpdated 21 days ago
    Auto-check passed

Works with

Questions about Bluesky

What does Bluesky do?

Create and manage content for Bluesky social network. An agent skill from OpenClaudia/openclaudia-skills. Bluesky is an agent skill from OpenClaudia/openclaudia-skills. Create and manage content for Bluesky social network.

When should I use Bluesky?

Bluesky fits situations like: the user says Bluesky post; post to Bluesky; bluesky content; bluesky strategy.

How do I install Bluesky in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill bluesky -a claude-code`. Or copy the skill folder (skills/bluesky in OpenClaudia/openclaudia-skills) 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 OpenClaudia/openclaudia-skills --skill bluesky -a codex`. Or copy the skill folder (skills/bluesky in OpenClaudia/openclaudia-skills) 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 OpenClaudia/openclaudia-skills --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 the command-line tools its instructions call (curl) and credentials named ACCESS_TOKEN and BLUESKY_APP_PASSWORD. Our summary lists: A credential in ACCESS_TOKEN.

Does Bluesky access the network?

SKILL.md names 1 domain. In commands or code: bsky.social; the agent is likely to contact it when it follows the instructions. 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 1.4k tokens (SKILL.md is roughly 5.7k 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: Content Calendar Sms (blacktwist/social-media-skills, 559 stars), Content (notque/vexjoy-agent, 439 stars), Platform Strategy Sms (blacktwist/social-media-skills, 559 stars) and Social Publisher (ericrisco/rsc-harness, 174 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bluesky?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

Source: OpenClaudia/openclaudia-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.