# Bluesky Poller

> Monitor Bluesky notifications (replies, mentions, quotes) on a schedule. Ready-to-use poller following the pollers.json contract with follow-gate trust tiers. Install from ClawHub or copy into your agent's skills/ folder.

- **Type:** Skill
- **Install:** `agentstack add skill-tkellogg-open-strix-bluesky-poller`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tkellogg](https://agentstack.voostack.com/s/tkellogg)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tkellogg](https://github.com/tkellogg)
- **Source:** https://github.com/tkellogg/open-strix/tree/main/optional-skills/bluesky-poller

## Install

```sh
agentstack add skill-tkellogg-open-strix-bluesky-poller
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Bluesky Notification Poller

Monitors your Bluesky account for new replies, mentions, and quotes. Emits events to the agent only when there's something actionable.

## Installation

Install from [ClawHub](https://clawhub.ai):

```bash
npx clawhub install bluesky-poller
```

Or copy this skill directory into your agent's `skills/` folder.

After installation, call `reload_pollers` to register the poller with the scheduler.

## Setup

### 1. Set environment variables

The poller reads credentials from the agent's environment (`.env` file or system env):

| Variable | Required | Description |
|----------|----------|-------------|
| `BLUESKY_HANDLE` | yes | Your Bluesky handle (e.g., `agent.bsky.social`) |
| `BLUESKY_APP_PASSWORD` | yes | App password from Bluesky Settings > App Passwords |

**Important:** Use a dedicated agent account, not a personal account. The poller doesn't mark notifications as read, but using a separate account keeps things clean.

### 2. Configure pollers.json

The skill ships with a default `pollers.json` that polls every 5 minutes:

```json
{
  "pollers": [
    {
      "name": "bluesky-mentions",
      "command": "python poller.py",
      "cron": "*/5 * * * *"
    }
  ]
}
```

Adjust the cron schedule as needed. For lower-traffic accounts, `*/15 * * * *` (every 15 minutes) is fine.

### 3. Reload pollers

After installation, call `reload_pollers` to register the poller with the scheduler.

## What It Reports

The poller emits events for:
- **Replies** to your posts
- **Mentions** of your handle
- **Quote posts** of your content

Each event includes the author, text, and URIs needed to respond.

Likes and follows are ignored — they don't require agent action.

## Trust Tiers (Follow-Gate)

Events from accounts you follow are emitted as normal prompts. Events from accounts you don't follow are prefixed with `[PERMISSION NEEDED]` — the agent should ask the operator before engaging.

The follow list is cached for 1 hour to avoid API rate limits.

## Dependencies

Requires the `atproto` Python package:

```bash
pip install atproto
```

Or with uv:

```bash
uv add atproto
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tkellogg](https://github.com/tkellogg)
- **Source:** [tkellogg/open-strix](https://github.com/tkellogg/open-strix)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tkellogg-open-strix-bluesky-poller
- Seller: https://agentstack.voostack.com/s/tkellogg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.