← Back to Skills Marketplace
xueyetianya

Leaderboard

by bytesagain4 · GitHub ↗ · v2.0.2 · MIT-0
cross-platform ✓ Security Clean
249
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install leaderboard
Description
Record scores, rank players, and analyze game stats with terminal leaderboards. Use when tracking scores, ranking competitors, reviewing performance.
README (SKILL.md)

Leaderboard

Leaderboard makes gaming & entertainment simple. Record, search, and analyze your data with clear terminal output.

Why Leaderboard?

  • Works entirely offline — your data never leaves your machine
  • Simple command-line interface, no GUI needed
  • Export to JSON, CSV, or plain text anytime
  • Automatic history and activity logging

Getting Started

# See what you can do
leaderboard help

# Check current status
leaderboard status

# View your statistics
leaderboard stats

Commands

Command What it does
leaderboard roll Roll
leaderboard score Score
leaderboard rank Rank
leaderboard history History
leaderboard stats Stats
leaderboard challenge Challenge
leaderboard create Create
leaderboard join Join
leaderboard track Track
leaderboard leaderboard Leaderboard
leaderboard reward Reward
leaderboard reset Reset
leaderboard stats Summary statistics
leaderboard export \x3Cfmt> Export (json
leaderboard search \x3Cterm> Search entries
leaderboard recent Recent activity
leaderboard status Health check
leaderboard help Show this help
leaderboard version Show version
leaderboard $name: $c entries
leaderboard Total: $total entries
leaderboard Data size: $(du -sh "$DATA_DIR" 2>/dev/null
leaderboard Version: v2.0.0
leaderboard Data dir: $DATA_DIR
leaderboard Entries: $(cat "$DATA_DIR"/*.log 2>/dev/null
leaderboard Disk: $(du -sh "$DATA_DIR" 2>/dev/null
leaderboard Last: $(tail -1 "$DATA_DIR/history.log" 2>/dev/null
leaderboard Status: OK
leaderboard [Leaderboard] roll: $input
leaderboard Saved. Total roll entries: $total
leaderboard [Leaderboard] score: $input
leaderboard Saved. Total score entries: $total
leaderboard [Leaderboard] rank: $input
leaderboard Saved. Total rank entries: $total
leaderboard [Leaderboard] history: $input
leaderboard Saved. Total history entries: $total
leaderboard [Leaderboard] stats: $input
leaderboard Saved. Total stats entries: $total
leaderboard [Leaderboard] challenge: $input
leaderboard Saved. Total challenge entries: $total
leaderboard [Leaderboard] create: $input
leaderboard Saved. Total create entries: $total
leaderboard [Leaderboard] join: $input
leaderboard Saved. Total join entries: $total
leaderboard [Leaderboard] track: $input
leaderboard Saved. Total track entries: $total
leaderboard [Leaderboard] leaderboard: $input
leaderboard Saved. Total leaderboard entries: $total
leaderboard [Leaderboard] reward: $input
leaderboard Saved. Total reward entries: $total
leaderboard [Leaderboard] reset: $input
leaderboard Saved. Total reset entries: $total

Data Storage

All data is stored locally at ~/.local/share/leaderboard/. Each action is logged with timestamps. Use export to back up your data anytime.

Feedback

Found a bug or have a suggestion? Let us know: https://bytesagain.com/feedback/


Powered by BytesAgain | bytesagain.com | [email protected]

Usage Guidance
This skill runs entirely locally and stores all data in ~/.local/share/leaderboard (history and per-command .log files). Before installing, review that you're comfortable with persistent local logs and exports (exports include all logged entries). There are no network calls or credential requests. A minor implementation note: the JSON export may produce formatting issues (the script appends a literal "\n]"), but that is a functional bug rather than a security concern. If you need strict privacy, back up or remove the data directory when finished; otherwise the skill appears safe and coherent for its stated purpose.
Capability Analysis
Type: OpenClaw Skill Name: leaderboard Version: 2.0.2 The Leaderboard skill is a straightforward local logging utility for tracking game scores and statistics. Analysis of 'scripts/script.sh' shows it manages data entirely within a local directory (~/.local/share/leaderboard) and lacks any network communication, credential access, or persistence mechanisms. While the '_export' function contains a minor vulnerability where unsanitized user input could break JSON formatting, there is no evidence of malicious intent or harmful instructions in 'SKILL.md'.
Capability Assessment
Purpose & Capability
Name and description (record scores, rank players, analyze stats) match the provided script and SKILL.md. All required functionality is implemented locally and stored under ~/.local/share/leaderboard; no unrelated credentials, binaries, or services are requested.
Instruction Scope
SKILL.md and the runtime script keep scope to leaderboard operations (commands, local storage, export, search). The instructions do not request unrelated files, environment variables, or external endpoints. The skill does automatically log activity to history.log (explicitly documented).
Install Mechanism
No install spec; the skill is instruction + a single shell script. Nothing is downloaded or extracted from remote URLs during install.
Credentials
The skill requires no environment variables, no credentials, and no config paths beyond its documented data directory (~/.local/share/leaderboard). This is proportionate to its purpose.
Persistence & Privilege
always:false and no system-wide changes are requested. The skill writes only to its own data dir and does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install leaderboard
  3. After installation, invoke the skill by name or use /leaderboard
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.2
update
v2.0.1
v2.5 retry: desc+homepage+source+security
v1.0.1
retry-fix-token
v2.0.0
Domain-specific upgrade
Metadata
Slug leaderboard
Version 2.0.2
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 4
Frequently Asked Questions

What is Leaderboard?

Record scores, rank players, and analyze game stats with terminal leaderboards. Use when tracking scores, ranking competitors, reviewing performance. It is an AI Agent Skill for Claude Code / OpenClaw, with 249 downloads so far.

How do I install Leaderboard?

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

Is Leaderboard free?

Yes, Leaderboard is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Leaderboard support?

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

Who created Leaderboard?

It is built and maintained by bytesagain4 (@xueyetianya); the current version is v2.0.2.

💬 Comments