← Back to Skills Marketplace

guandan

Name: guandan
Author: mikewei

by Mike Wei · GitHub ↗ · v0.1.1 · MIT-0

linuxdarwin ✓ Security Clean

131

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install guandan

Description

Play GuanDan(掼蛋) card game via `clawguandan CLI`. Use when users ask to play GuanDan or create/list/join tables in game.

README (SKILL.md)

Guandan

You can play GuanDan (掼蛋) card game through the clawguandan CLI as one or more AI players.

Prerequisites

Check CLI available Run the CLI wrapper:
```
./scripts/run.sh show version
```
When not found, install it first if the user trust it.
Check server ready Run:
```
./scripts/run.sh server status
```
If the status is unreachable, you can restart the local server:
```
./scripts/run.sh server restart
```
You can see the Web UI URLs for human users once everything is ready.

Quick start (Bot Mode, default)

Read the current table list:
```
./scripts/run.sh table list
```
Confirm whether you should create the table or the user already specified a table.
- If you create the table, run ./scripts/run.sh table create "\x3Ca_cool_table_name>" and obtain tableId.
Confirm with the user how many Bot players should join, then run the command in background:
```
./scripts/run.sh bot llm-bot --default-script openclaw --players \x3Cnumber_of_bot_players> -t \x3CtableId> -v
```
If some error occurs, try to fix it and retry.

If it still does not work, confirm with user to degrade to rule-based bot player.

./scripts/run.sh bot rule-bot --players \x3Cnumber_of_bot_players> -t \x3CtableId> -v

Game started. Report game status when needed.

Security notes

This skill wraps the clawguandan CLI.

The CLI communicates only with a local server process and local agent.
It does not require API keys, tokens, or external credentials by default.
It does not send data to external services unless the user explicitly configures it to do so.

Usage Guidance

This skill is a thin wrapper around an external npm CLI package. Before installing or running it: 1) Inspect the upstream npm package (@mikewei-labs/clawguandan) and its repository/release history to ensure you trust it; 2) If you plan to use the 'llm-bot' mode, confirm whether that mode connects to external LLM services and whether it requires API keys or sends gameplay data externally; 3) Prefer installing and running this in a contained environment (local user account or sandbox) until you confirm the CLI's behavior; 4) If you do not trust the npm package, do not run 'npm install' from an unverified source.

Capability Analysis

Type: OpenClaw Skill Name: guandan Version: 0.1.1 The skill bundle is a straightforward wrapper for a card game CLI tool ('clawguandan'). The 'scripts/run.sh' script is a standard utility to locate and execute the CLI, and 'SKILL.md' provides clear, task-aligned instructions for the AI agent to manage game tables and bot players. No evidence of malicious intent, data exfiltration, or suspicious obfuscation was found.

Capability Assessment

✓ Purpose & Capability

Name/description match the delivered assets: SKILL.md documents using the clawguandan CLI and the repo includes a small wrapper script that launches the 'clawguandan' executable from PATH or node_modules. Requiring npm as a prerequisite is reasonable because installation guidance uses npm.

ℹ Instruction Scope

Instructions only invoke the local wrapper script (table list/create, server status/restart, bot launch). They do not instruct reading unrelated files or environment variables. One point to note: the instructions reference an 'llm-bot' mode; the skill does not document whether that mode calls external LLM services or only a local agent — that behavior is determined by the external CLI package, not the provided files.

✓ Install Mechanism

There is no install spec and the included script is a simple shell wrapper. Nothing in the skill downloads or extracts remote archives or writes arbitrary files. The only install advice is to run 'npm install @mikewei-labs/clawguandan@latest' which is a standard npm package install.

ℹ Credentials

The skill declares no required environment variables or credentials, which aligns with the SKILL.md claim that no API keys are required by default. However, 'llm-bot' or other CLI behaviors might require external model credentials or configuration if the underlying CLI is configured that way — this is outside the wrapper and should be verified in the external package's docs.

✓ Persistence & Privilege

The skill does not request always:true, does not modify other skills, and has no install-time persistent agents. It only runs a local CLI wrapper when invoked.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install guandan
After installation, invoke the skill by name or use /guandan
Provide required inputs per the skill's parameter spec and get structured output

Version History

v0.1.1

- Added a new "Security notes" section to clarify how the skill interacts with the clawguandan CLI and handles data privacy. - No changes to the workflow or commands.

v0.1.0

- Initial release of the guandan skill. - Play GuanDan (掼蛋) via the clawguandan CLI with support for AI and rule-based bots. - Includes instructions for setting up prerequisites, checking server status, and starting games. - Supports Linux and Darwin operating systems; requires npm.

v0.1.0-beta.7

Version 0.1.0 - Added scripts/run.sh as a CLI wrapper for all commands. - Updated documentation to use the new scripts/run.sh interface for running and managing games. - Removed outdated reference to subagent_mode.md. - Simplified fallback instructions for bot mode failures. - Improved clarity and step-by-step guidance in SKILL.md.

v0.1.0-beta.6

guandan 0.1.0 - Updated installation instructions to check for and install the `clawguandan` CLI with npm if not found - Metadata requirements now specify only the `npm` binary - Improved and clarified server readiness and quick start instructions - Corrected and streamlined bot joining workflow and error handling steps - Simplified documentation by removing Subagent Mode warnings and referencing its usage more clearly

v0.1.0-beta.5

Initial release of the Guandan skill. - Play GuanDan (掼蛋) card game via the `clawguandan` CLI. - Supports listing, creating, and joining game tables. - Choose between bot players (LLM or rule-based) and Subagent Mode. - Includes setup instructions and troubleshooting steps for server and gameplay. - Compatible with Linux and macOS; requires `clawguandan` binary (installable via npm).

Metadata

Slug guandan

Version 0.1.1

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 5

Frequently Asked Questions

What is guandan?

Play GuanDan(掼蛋) card game via `clawguandan CLI`. Use when users ask to play GuanDan or create/list/join tables in game. It is an AI Agent Skill for Claude Code / OpenClaw, with 131 downloads so far.

How do I install guandan?

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

Is guandan free?

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

Which platforms does guandan support?

guandan is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin).

Who created guandan?

It is built and maintained by Mike Wei (@mikewei); the current version is v0.1.1.

More Skills