โ Back to Skills Marketplace
Mahjong AI
by
sceneun1ty
ยท GitHub โ
ยท v1.0.1
ยท MIT-0
186
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install mahjong-ai
Description
AI Mahjong Assistant ๐ โ Snap a photo of your hand, get optimal discard suggestions. Sichuan Mahjong rules (Blood Battle / ่กๆๅฐๅบ). Supports tile recognition...
README (SKILL.md)
้บปๅฐ AI ๅฉๆ ๐
ๅท้บป๏ผๅๅท้บปๅฐ๏ผAI ๅบ็้กพ้ฎใๆ็ งๅๆ็๏ผๅๆๆไผๅบ็ใ
่งๅ๏ผๅท้บป๏ผ่กๆๅฐๅบ๏ผ
- ๅชๆ ็ญใๆกใไธ ไธ้จ๏ผๅ ฑ 108 ๅผ ๏ผๆฏ็ง 1-9 ๅ 4 ๅผ ๏ผ
- ๆฏไบบ 13 ๅผ ๆ็๏ผๆธ็ๅ 14 ๅผ ้ๆฉๅบ็
- ่ก็ๆกไปถ๏ผ4 ็ป้ขๅญ๏ผ้กบๅญ/ๅปๅญ๏ผ+ 1 ๅฏนๅฐ๏ผ้ๅคด๏ผ
- ็นๆฎ่กๆณ๏ผไธๅฏนใ้พไธๅฏนใๆธ ไธ่ฒใๅฏนๅฏน่ก็ญ
- ่กๆๅฐๅบ๏ผไธไบบ่กไบ็ปง็ปญๆ๏ผ็ดๅฐๅฉไธไบบๆฒก่ก
ๅทฅไฝๆต็จ
Step 1: ่ฏๅซ็้ข๏ผๆ็ ง๏ผ
ๆถๅฐ็ ง็ๅ๏ผ็จ่ง่ง่ฏๅซ๏ผ
- ๆ็๏ผ13ๆ14ๅผ ๏ผ
- ๅบไธๅทฒๆๅบ็็๏ผ็ๆฑ /ๆฒณ็๏ผ
- ๅทฒ็ขฐ/ๆ ็็
็ผ็ ๆ ผๅผ๏ผ
- ไธๅญ๏ผ1m 2m ... 9m
- ็ญๅญ๏ผ1p 2p ... 9p
- ๆกๅญ๏ผ1s 2s ... 9s
ๅๅบ่ฏๅซ็ปๆ่ฎฉ็จๆท็กฎ่ฎคๅๅๅๆใ
Step 2: ่ฟ่กๅๆ
python3 scripts/mahjong_analyze.py \
--hand "1m,2m,3m,5m,5m,3p,4p,7p,8p,9p,2s,3s,4s,6s" \
--discard "1p,2p,5p,5p,9s,9s" \
--meld "6m,6m,6m"
ๅๆฐ๏ผ
--hand/-H๏ผๆ็๏ผๅฟ ๅกซ๏ผ13ๆ14ๅผ ๏ผ--discard/-d๏ผๅบไธๅทฒๆๅบ็็๏ผๅฏ้๏ผ--meld/-m๏ผๅทฒ็ขฐ/ๆ ็็๏ผๅฏ้๏ผ
Step 3: ่พๅบๅปบ่ฎฎ
- 14ๅผ โ ๆจ่ๆๅชๅผ ๏ผ้ๅฎๅ จๅบฆ๐ข๐ก๐ด + ๅฌ็ๅผ ๆฐ
- 13ๅผ โ ๆพ็คบๅฌไปไน็ + ๅฉไฝๅผ ๆฐ
- ๅฎๅ จๅบฆๅบไบๅบ้ขๅทฒๅบ็่ฎก็ฎ๏ผๅบ่ถๅค่ถๅฎๅ จใ19่พนๅผ ๆดๅฎๅ จ๏ผ
ๅท้บป็นๆฎ่งๅ
- ไธ่ฝๅ๏ผๅช่ฝ็ขฐ/ๆ /่ก
- ่กๆๅฐๅบ๏ผไธไบบ่กไบ็ปง็ปญๆ
- ็ชๆฐ๏ผๆธ ไธ่ฒ4็ชใไธๅฏน4็ชใ้พไธๅฏน8็ชใๅฏนๅฏน่ก2็ช
ๅ่
- ่ฏฆ็ป็็๏ผ่ง
references/mahjong_theory.md
Usage Guidance
This skill appears to be a local Mahjong analysis tool (python script + docs) and does not request credentials or install external packages. Before installing/use, confirm: (1) how the photoโtile recognition step is performed โ the bundle contains a visual guide but no vision model or remote endpoint; if your agent/platform performs vision, ensure images are not sent to unknown external services; (2) inspect scripts/mahjong_analyze.py for any network calls or filesystem operations (the visible portion uses only stdlib but review the whole file); (3) run the script in an isolated environment (e.g., a sandbox or virtualenv) to verify behavior and outputs; and (4) if you plan to share images, be comfortable with where they are processed/stored. If you want, I can scan the full mahjong_analyze.py file for network I/O, subprocess usage, or other risky operations.
Capability Analysis
Type: OpenClaw Skill
Name: mahjong-ai
Version: 1.0.1
The mahjong-ai skill bundle is a legitimate Mahjong assistant designed for Sichuan Mahjong rules. The core logic in scripts/mahjong_analyze.py is a self-contained Python script using only standard libraries to calculate game states (shanten, waiting tiles) and provide strategic advice. The instructions in SKILL.md and documentation in README.md/DEVLOG.md are entirely consistent with the stated purpose, showing no signs of malicious intent, data exfiltration, or prompt injection attacks.
Capability Assessment
Purpose & Capability
Name/description (Mahjong AI, Sichuan rules, discard suggestions) match the included README, DEVLOG, SKILL.md, and the provided analysis script; required resources (none) are appropriate for an offline Python analyzer.
Instruction Scope
SKILL.md describes a workflow that includes visual recognition of a photographed hand and then running the local analyzer with parsed tiles. The repository contains guidance for tile-vision (references/tile_visual_guide.md) but no vision/model code or network endpoints. The instructions appropriately ask the agent to list recognition results for user confirmation before analysis โ clarify where image recognition runs (platform-provided vision vs. external service) to close this gap.
Install Mechanism
No install spec; code is a standalone Python script using only standard-library modules (argparse, collections, itertools, sys). No downloads, package installs, or thirdโparty binaries are requested.
Credentials
No environment variables, credentials, or config paths are required. The skill does not request unrelated secrets or elevated access.
Persistence & Privilege
Skill is not always-enabled and uses normal model invocation. It does not request system-wide changes or persistent elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mahjong-ai - After installation, invoke the skill by name or use
/mahjong-ai - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
ๅท้บปAIๅบ็้กพ้ฎ๏ผๆ็
ง่ฏๅซๆ็+ๆไผๅบ็ๅๆ+ๅฌ็่ฎก็ฎ+ๅฎๅ
จๅบฆ่ฏไผฐ
v1.1.0
Added English README, improved description and tags for international users
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Mahjong AI?
AI Mahjong Assistant ๐ โ Snap a photo of your hand, get optimal discard suggestions. Sichuan Mahjong rules (Blood Battle / ่กๆๅฐๅบ). Supports tile recognition... It is an AI Agent Skill for Claude Code / OpenClaw, with 186 downloads so far.
How do I install Mahjong AI?
Run "/install mahjong-ai" in the OpenClaw or Claude Code chat to install it in one step โ no extra setup required.
Is Mahjong AI free?
Yes, Mahjong AI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Mahjong AI support?
Mahjong AI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mahjong AI?
It is built and maintained by sceneun1ty (@sceneun1ty); the current version is v1.0.1.
More Skills