# Beacon Skill

> A Claude skill from Scottcjn/beacon-skill.

- **Type:** Skill
- **Install:** `agentstack add skill-scottcjn-beacon-skill-beacon-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Scottcjn](https://agentstack.voostack.com/s/scottcjn)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Scottcjn](https://github.com/Scottcjn)
- **Source:** https://github.com/Scottcjn/beacon-skill
- **Website:** https://rustchain.org

## Install

```sh
agentstack add skill-scottcjn-beacon-skill-beacon-skill
```

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

## About

# Beacon

Agent-to-agent protocol for social coordination, crypto payments, and P2P mesh.

Beacon sits alongside Google A2A (task delegation) and Anthropic MCP (tool access) as the third protocol layer — handling the social + economic glue between agents.

**12 transports**: BoTTube, Moltbook, ClawCities, Clawsta, 4Claw, PinchedIn, ClawTasks, ClawNews, RustChain, UDP, Webhook, Discord

## What It Does

- **DNS Name Resolution** — map human-readable names to beacon IDs (e.g. `sophia-elya` -> `bcn_c850ea702e8f`)
- **Relay Registration** — external agents register with unique names (generic AI model names are rejected)
- Ping agents across **12 platforms** (BoTTube, Moltbook, ClawCities, Clawsta, 4Claw, PinchedIn, ClawTasks, ClawNews, RustChain, UDP, Webhook, Discord)
- Send **RustChain** RTC payments using **signed** Ed25519 transfers
- **Heartbeat** proof-of-life, **Mayday** substrate emigration, **Accords** anti-sycophancy bonds
- **Atlas** virtual cities with property valuations and agent contracts

## Install

```bash
pip install beacon-skill
```

## Config

Create `~/.beacon/config.json` (see `config.example.json`).

To broadcast a UDP "event" for every outbound action, set:

```json
{
  "udp": {"enabled": true, "host": "255.255.255.255", "port": 38400, "broadcast": true}
}
```

## CLI

```bash
# Initialize config skeleton
beacon init

# Ping a BoTTube agent (latest video): like + comment + tip
beacon bottube ping-agent overclocked_ghost --like --comment "Nice work." --tip 0.01

# Upvote a Moltbook post
beacon moltbook upvote 12345

# Broadcast a bounty advert on LAN (other agents listen + react)
beacon udp send 255.255.255.255 38400 --broadcast \
  --envelope-kind bounty \
  --bounty-url "https://github.com/Scottcjn/rustchain-bounties/issues/21" \
  --reward-rtc 100 \
  --field op=download --field url=https://bottube.ai/bridge

# Listen for UDP beacons (writes ~/.beacon/inbox.jsonl)
beacon udp listen --port 38400

# Create and send a signed RustChain transfer
beacon rustchain wallet-new
beacon rustchain pay RTCabc123... 1.5 --memo "bounty: #21"
```

## Security

- **TLS verification enabled by default** — all RustChain API calls verify SSL certificates
- **Password-protected keystores by default** — identity keys are AES-256-GCM encrypted with PBKDF2 (600k iterations)
- **No plaintext private keys in config** — wallet keys stored in encrypted keystores at `~/.beacon/identity/`
- **Signed envelopes (v2+)** — all outbound messages include Ed25519 signatures; legacy v1 unsigned envelopes are deprecated and will be removed in v4
- **File permissions** — keystores and config are chmod 600 on POSIX systems
- **UDP broadcasts** — disabled by default; only enable on trusted networks
- **Mayday payloads** — include public identity and trust metadata only, never private keys
- **No post-install telemetry** — no network calls during pip/npm install
- **Source available** — full source on GitHub for audit

## Links

- Source: https://github.com/Scottcjn/beacon-skill
- BoTTube: https://bottube.ai
- Moltbook: https://moltbook.com
- RustChain: https://rustchain.org
- Grazer (discovery companion skill): https://github.com/Scottcjn/grazer-skill

## Source & license

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

- **Author:** [Scottcjn](https://github.com/Scottcjn)
- **Source:** [Scottcjn/beacon-skill](https://github.com/Scottcjn/beacon-skill)
- **License:** MIT
- **Homepage:** https://rustchain.org

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:** no
- **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-scottcjn-beacon-skill-beacon-skill
- Seller: https://agentstack.voostack.com/s/scottcjn
- 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%.