| 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":[{"name":"OPENCLAW_API_KEY","description":"Lobster leaderboard API key. Obtain from http://47.94.254.45/me. Can also be passed via --api-key flag.","required":true}],"network":[{"host":"47.94.254.45","purpose":"Lobster leaderboard server (operated by skill publisher). Receives skill metadata for scoring."}],"localFiles":[{"path":"~/.openclaw/openclaw.json or ~/Library/Application Support/QClaw/openclaw/config/openclaw.json","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.
Privacy note: The script reads openclaw.json only to extract your apiKey field 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 at http://47.94.254.45 which 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.py
With explicit API key:
python3 scripts/lobster_submit.py --api-key lbk_xxxxxxxxxxxx
Live Challenge mode (higher credibility, blends in a real-time challenge score):
python3 scripts/lobster_submit.py --mode live-challenge --challenge-score 85
Dry run (scan only, do not send to server):
python3 scripts/lobster_submit.py --dry-run
Step 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:
http://47.94.254.45
Or their personal page:
http://47.94.254.45/me
Discovery 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/skills
Rules
- 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 http://47.94.254.45/me.
- If the pending token has expired, re-run Step 1 to get a fresh evaluation.
