- name
- lobster-rank
- description
- Scan locally installed OpenClaw skills, collect evidence data, submit to the lobster ranking server for scoring, and let the user confirm uploading their result to the public leaderboard. Use when the user asks to score, rate, evaluate, rank, or certify their lobster / AI agent capability set, or wants to upload their score to the leaderboard.
- dependencies
- env
- description
- Lobster leaderboard API key. Obtain from https://lobster-rank.wondercv.com/me. Can also be passed via --api-key flag.
- required
- true
- network
- purpose
- Lobster leaderboard server (operated by skill publisher). Receives skill metadata for scoring.
- localFiles
- purpose
- Read apiKey field only for authentication. No other fields are used or transmitted.
Lobster Rank
This skill scans your locally installed OpenClaw skills, collects metadata (skill names, structure flags, file counts, descriptions), and submits it to the lobster leaderboard server for scoring. No file contents, credentials, or personal data are sent — only structural metadata and heuristic signals. The scoring algorithm runs server-side.
Prerequisites
You need a Lobster API Key before submitting.
- Get it at: https://lobster-rank.wondercv.com/me
- Set it as an environment variable for convenience:
export OPENCLAW_API_KEY=your_key_here- Or pass it directly with
--api-keyon every command.
Privacy note: The script readsopenclaw.jsononly to extract yourapiKeyfield for authentication — no other fields are used or transmitted. It collects skill metadata (skill names, whether scripts/references/assets exist, file count, description) and heuristic signals (multi-model usage, log availability). No file contents, credentials, or personal data are sent. All data is submitted to the leaderboard server athttps://lobster-rank.wondercv.comwhich is operated by the skill publisher.
Workflow
Step 1 — Scan & Submit
Run the scanner. It collects metadata about your installed skills and sends the raw data to the server for scoring.
python3 scripts/lobster_submit.pyWith explicit API key:
python3 scripts/lobster_submit.py --api-key lbk_xxxxxxxxxxxxLive Challenge mode (higher credibility, blends in a real-time challenge score):
python3 scripts/lobster_submit.py --mode live-challenge --challenge-score 85Dry run (scan only, do not send to server):
python3 scripts/lobster_submit.py --dry-runStep 2 — Review the Result
The script prints the score returned by the server. Present it to the user in a readable format, including:
- Total score and grade
- Title
- Number of skills counted
- Evaluation mode
- Pending token expiry time
Ask the user: "要将这个成绩上传到排行榜吗？"
If they say yes, proceed to Step 3. If no, stop — the pending score stays valid for 24 hours and can be confirmed on the website.
Step 3 — Confirm Upload
Pass the pending_token from Step 2:
python3 scripts/lobster_submit.py --confirm <pending_token>On success the script prints a confirmation. Tell the user their score is now on the leaderboard.
Step 4 — View on Leaderboard
Direct the user to:
https://lobster-rank.wondercv.comOr their personal page:
https://lobster-rank.wondercv.com/meDiscovery Paths
The scanner checks these locations for skills:
~/.openclaw/workspace/skills~/Library/Application Support/QClaw/openclaw/config/skills
And these for config / logs:
~/.openclaw/openclaw.json~/Library/Application Support/QClaw/openclaw/config/openclaw.json~/Library/Logs/QClaw/openclaw
To scan a custom path:
python3 scripts/lobster_submit.py --root /path/to/skillsRules
- Do not invent skills or fabricate evidence.
- The scoring algorithm runs server-side; do not attempt to predict or influence it.
- If no user-installed skills are found, stop and report the issue.
- If the API key is missing or invalid, ask the user to retrieve it from https://lobster-rank.wondercv.com/me.
- If the pending token has expired, re-run Step 1 to get a fresh evaluation.