bluesky-engagement

Monitor Bluesky notifications and queue human-reviewable reply drafts.

25|7|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/IgorGanapolsky/ThumbGate --skill bluesky-engagement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluesky-engagement
Source: https://github.com/IgorGanapolsky/ThumbGate/tree/main/skills/bluesky-engagement
Command: npx skills add https://github.com/IgorGanapolsky/ThumbGate --skill bluesky-engagement

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

ThumbGate needs a deterministic way to monitor Bluesky replies and mentions so engagement can be reviewed and approved instead of auto-posted.

Core Features & Use Cases

  • Automated reply monitoring: Polls the AT Protocol notifications endpoint every 15 minutes and scopes handling to reply/mention/quote notifications.
  • Human-reviewable draft queueing: Writes proposed replies into a jsonl queue with autoPost disabled, enabling a sign-off workflow.
  • Safe federation-aware routing: Authenticated calls must hit the user’s own PDS (via didDoc serviceEndpoint) to avoid upstream 502 failures, and the skill soft-fails on transient upstream incidents.
  • Credential rotation and troubleshooting authority: Centralizes the correct Bluesky app password setup and explains failure modes such as 401 auth issues and PDS routing breakage.

Quick Start

Ask your ThumbGate agent to monitor your Bluesky notifications and create a draft queue you can review and approve before posting.

Frequently Asked Questions about bluesky-engagement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor Bluesky replies and mentions without auto-posting?

You can monitor Bluesky notifications and generate human-reviewable reply drafts by polling the AT Protocol notifications endpoint every 15 minutes and writing proposed replies into a jsonl queue with auto-posting disabled.

How do I set up AT Protocol credentials for Bluesky reply monitoring?

Setting up Bluesky reply monitoring requires an app password for AT Protocol session creation, and authenticated calls must route to your own PDS via the didDoc serviceEndpoint to avoid upstream 502 failures.

What causes 401 authentication errors during Bluesky notification polling?

401 authentication errors during Bluesky notification polling typically stem from incorrect app password setup, requiring centralized credential rotation and troubleshooting to resolve the auth failure.

Can I deduplicate Bluesky mention notifications in a draft queue?

Yes, state-based dedupe is applied to reply, mention, and quote notifications when generating draft queues, ensuring duplicate entries are filtered out before human approval.

How does Bluesky federation affect automated reply routing?

Federation-aware routing requires authenticated calls to hit the user's own PDS to avoid upstream 502 failures, and the monitoring skill soft-fails on transient upstream 5xx incidents.

What is the best way to handle transient upstream 5xx incidents in Bluesky monitoring?

The best way to handle transient upstream 5xx incidents in Bluesky monitoring is to implement soft-failure logic that safely pauses processing without losing queued drafts or breaking the state-based dedupe.