← Back to Skills Marketplace
thisisjeron

Beaconchain

by ThisIsJeron · GitHub ↗ · v0.1.1
cross-platform ✓ Security Clean
1115
Downloads
2
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install beaconchain
Description
Monitor Ethereum validator dashboard health on beaconcha.in via V2 API, focused on one-check-per-day status and BeaconScore-first triage. Use when the user asks to check validator health, BeaconScore, missed duties, or set up low-anxiety daily monitoring/alerts for a beaconcha.in dashboard.
README (SKILL.md)

Beaconchain

Use this skill to reduce validator-check anxiety: do one concise daily health check, then only surface issues.

Quick Start

  1. Set credentials as env vars:
    • BEACONCHAIN_API_KEY
    • BEACONCHAIN_DASHBOARD_ID
  2. Run:
python3 skills/beaconchain/scripts/check_dashboard.py --json
  1. Interpret exit code:
    • 0 = good
    • 2 = bad (needs attention)
    • 1 = error (auth/rate-limit/endpoint failure)

Monitoring Workflow

  1. Run scripts/check_dashboard.py once per day.
  2. If status=good, respond with a short reassurance and avoid extra detail.
  3. If status=bad, report:
    • BeaconScore (if available)
    • Which signal tripped (missed/penalty fallback)
    • Next action: inspect dashboard details and validator logs.
  4. If status=error, report key checks:
    • API key validity
    • dashboard ID
    • plan/rate-limit permissions.

Command Patterns

Basic check

python3 skills/beaconchain/scripts/check_dashboard.py

JSON output (for cron/parsing)

python3 skills/beaconchain/scripts/check_dashboard.py --json

Custom threshold

python3 skills/beaconchain/scripts/check_dashboard.py --warn-threshold 75

Notes

  • Script uses POST /api/v2/ethereum/validators/performance-aggregate with dashboard selector and reads data.beaconscore.total directly.
  • Default window is 24h; supported windows: 24h, 7d, 30d, 90d, all_time.
  • Keep responses intentionally terse when healthy to support low-anxiety operations.

Security & Transparency

  • Runtime: python3 only, using Python standard library (argparse, json, urllib, datetime).
  • Credentials: reads BEACONCHAIN_API_KEY and BEACONCHAIN_DASHBOARD_ID (or equivalent CLI flags).
  • Network egress: only https://beaconcha.in/api/v2/ethereum/validators/performance-aggregate.
  • Local filesystem: no writes, no shell execution, no subprocess spawning.

References

  • API overview: references/api-notes.md
Usage Guidance
This skill is internally consistent and implements precisely what it claims: a small Python script that POSTs to beaconcha.in and reports a simple daily status. Before installing, ensure you trust beaconcha.in and are comfortable granting that API key to this script (treat BEACONCHAIN_API_KEY as a secret). Review/scan the included script in your environment before running, store the key in a secure secret store or environment isolated from other services, and consider creating an API key with minimal scope or a dedicated key for this monitoring use. If you plan to run it on a schedule (cron), run it in a restricted environment (non-privileged account, limited network access) and rotate the API key if you suspect compromise. Finally, the skill disables autonomous model invocation, so it will only run when you explicitly call it.
Capability Analysis
Type: OpenClaw Skill Name: beaconchain Version: 0.1.1 The skill bundle is benign. The `SKILL.md` clearly defines the skill's purpose, required environment variables (`BEACONCHAIN_API_KEY`, `BEACONCHAIN_DASHBOARD_ID`), and explicitly states limitations such as 'no writes, no shell execution, no subprocess spawning' and 'Network egress: only https://beaconcha.in/api/v2/ethereum/validators/performance-aggregate'. The `scripts/check_dashboard.py` Python code confirms these claims, using only standard libraries (`urllib.request`, `os.getenv`) to fetch data from the specified beaconcha.in API endpoint. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the AI agent.
Capability Assessment
✓ Purpose & Capability
Name/description match the implementation: the script POSTs to beaconcha.in performance-aggregate and reads BEACONCHAIN_API_KEY and BEACONCHAIN_DASHBOARD_ID. There are no unrelated binaries, hosts, or credentials requested.
✓ Instruction Scope
SKILL.md instructions align with the script: calls only the documented API endpoint, uses only env vars or CLI flags declared, prints JSON/concise outputs, and documents exit codes. The script does not read other files, spawn shells, or transmit data to other endpoints.
✓ Install Mechanism
No install specification is provided (instruction-only with an included Python script). This is low-risk; the script appears self-contained and uses only Python standard library modules.
✓ Credentials
The skill requires only BEACONCHAIN_API_KEY and BEACONCHAIN_DASHBOARD_ID (and python3). Those are appropriate and necessary for calling the beaconcha.in API. No unrelated secrets or config paths are requested.
✓ Persistence & Privilege
Skill is not always-enabled and sets disableModelInvocation=true (so the model will not autonomously invoke it). It does not modify other skills or system settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install beaconchain
  3. After installation, invoke the skill by name or use /beaconchain
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Declare required env vars/runtime in metadata, add security transparency section, and set disableModelInvocation for explicit-use safety.
v0.1.0
Initial release: low-anxiety Beaconchain dashboard health check using performance-aggregate BeaconScore with concise good/bad triage.
Metadata
Slug beaconchain
Version 0.1.1
License —
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Beaconchain?

Monitor Ethereum validator dashboard health on beaconcha.in via V2 API, focused on one-check-per-day status and BeaconScore-first triage. Use when the user asks to check validator health, BeaconScore, missed duties, or set up low-anxiety daily monitoring/alerts for a beaconcha.in dashboard. It is an AI Agent Skill for Claude Code / OpenClaw, with 1115 downloads so far.

How do I install Beaconchain?

Run "/install beaconchain" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Beaconchain free?

Yes, Beaconchain is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Beaconchain support?

Beaconchain is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Beaconchain?

It is built and maintained by ThisIsJeron (@thisisjeron); the current version is v0.1.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments