← Back to Skills Marketplace
Snooker Skill
by
Greg Stephens
· GitHub ↗
· v0.3.0
· MIT-0
419
Downloads
1
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install snooker-skill
Description
Look up snooker rankings, results, player profiles, live matches and head-to-head records via api.snooker.org.
Usage Guidance
This skill appears coherent for fetching snooker data, but before installing: 1) you will need a SNOOKER_API_KEY and the script will store it in plaintext at ~/.nanobot/workspace/snooker/config.json — consider file permissions or using environment variables instead; 2) ensure python3 is available and run the script with python3 snooker.py if your system doesn't honor the provided shebang; 3) the tool logs URLs it fetches to stdout (not the secret), and it will send your API key to api.snooker.org in the X-Requested-By header (this is required for the API). If any of these behaviors are unacceptable (plaintext key on disk, file creation in your home), do not install or run the skill.
Capability Analysis
Type: OpenClaw Skill
Name: snooker-skill
Version: 0.3.0
The snooker skill is a legitimate tool for querying professional snooker data from api.snooker.org. The Python script (snooker.py) uses standard libraries to perform API requests and manage a local configuration file in the user's home directory (~/.nanobot/workspace/snooker/config.json). There is no evidence of data exfiltration, unauthorized execution, or prompt injection; the code logic strictly aligns with the stated purpose of retrieving rankings, player profiles, and match results.
Capability Assessment
Purpose & Capability
Name/description ask for snooker data from api.snooker.org and the code only calls api.snooker.org endpoints, so the requested SNOOKER_API_KEY and python3 binary are appropriate and expected.
Instruction Scope
SKILL.md instructs invoking the included snooker.py script. The script will read SNOOKER_API_KEY from the environment (or a local config file) and performs only API requests to api.snooker.org. Note: the setup command writes a plaintext config.json under ~/.nanobot/workspace/snooker/, and the script prints fetched URLs to stdout (logging).
Install Mechanism
No install spec — it's instruction-only with an included Python script. Nothing is downloaded or executed from external, untrusted URLs.
Credentials
Only the SNOOKER_API_KEY credential is declared and used. The script sends that key in an X-Requested-By header to api.snooker.org and otherwise does not request unrelated credentials or env vars.
Persistence & Privilege
always:false and normal autonomous invocation. The script creates and writes its own config file at ~/.nanobot/workspace/snooker/config.json to persist the API key; it does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install snooker-skill - After installation, invoke the skill by name or use
/snooker-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.0
- Removed setup step and script path now references snooker.py directly from the root (not scripts/snooker.py).
- Environment variable SNOOKER_API_KEY must be set manually; configuration via script is no longer included.
- Updated SKILL.md documentation to reflect these usage and setup changes.
- Cleaned up requirements to remove unnecessary environment variable and clarified instructions.
v0.2.6
- Updated version to 0.2.6 in SKILL.md.
- No functional or feature changes; documentation version number increment only.
v0.2.5
- Replaced the old script location with a new main file: snooker.py replaces scripts/snooker.py.
- Updated documentation in SKILL.md with new metadata, environment variable requirements, and API rate limit info.
- Added explicit OpenClaw integration metadata for environment and binary requirements.
- Removed unused files: README.md and the old scripts/snooker.py.
v0.1.0
Initial release: Query live snooker stats, player info, rankings, results, and more via api.snooker.org.
- Provides command-line scripts to fetch snooker rankings, player profiles, results, event info, and schedules
- Supports specific queries like live matches, head-to-head records, and upcoming tournaments
- Requires a personal API key for setup and access
- Includes detailed usage examples for each command in the documentation
Metadata
Frequently Asked Questions
What is Snooker Skill?
Look up snooker rankings, results, player profiles, live matches and head-to-head records via api.snooker.org. It is an AI Agent Skill for Claude Code / OpenClaw, with 419 downloads so far.
How do I install Snooker Skill?
Run "/install snooker-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Snooker Skill free?
Yes, Snooker Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Snooker Skill support?
Snooker Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Snooker Skill?
It is built and maintained by Greg Stephens (@rgstephens); the current version is v0.3.0.
More Skills