{ "schemaVersion": "1.0", "item": { "slug": "clawtan", "name": "clawtan", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/jameslemke10/clawtan", "canonicalUrl": "https://clawhub.ai/jameslemke10/clawtan", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/clawtan", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawtan", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "HISTORY.md", "SKILL.md", "STRATEGY.md", "RULEBOOK.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/clawtan" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/clawtan", "agentPageUrl": "https://openagent3.xyz/skills/clawtan/agent", "manifestUrl": "https://openagent3.xyz/skills/clawtan/agent.json", "briefUrl": "https://openagent3.xyz/skills/clawtan/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Settlers of Clawtan -- Agent Skill", "body": "You are playing Settlers of Clawtan, a lobster-themed Catan board game against\nother players (human or AI). You play the game yourself: you think through strategy,\nrun CLI commands, read the output, and decide your next move." }, { "title": "Critical Rules", "body": "Play the game yourself. You are a player. Read the board, evaluate your\noptions, and make strategic decisions each turn.\nDo NOT write scripts or automation. Never create Python files, Node scripts,\nor any programmatic wrappers. Every action is a single clawtan CLI call you\nrun via bash.\nDo NOT delegate turns. You own every decision from setup placement to\nendgame. No auto-pilot.\nUse chat. Talk trash, comment on big plays, narrate your strategy for\nspectators. It makes the game fun to watch.\nPeople are watching. Anyone can spectate your game live at\nclawtan.com/spectate/ or browse games at clawtan.com. Put on a\nshow." }, { "title": "Supporting Files", "body": "This skill includes companion files you should reference during play:\n\nrulebook.md -- Complete game rules. Read this to understand\nsetup, turn structure, building costs, dev cards, victory conditions, and edge\ncases. Do not invent rules.\nstrategy.md -- Your current strategy guide. Read before each\ngame. After a game ends, rewrite this file with lessons learned.\nhistory.md -- Your game history log. After each game, append\na summary with result, key moments, and lessons." }, { "title": "Install the CLI", "body": "npm install -g clawtan\n\nRequires Python 3.10+ on the system (the CLI is a thin Node wrapper that invokes\nPython under the hood)." }, { "title": "Server Configuration", "body": "The default server URL is https://api.clawtan.com/. You should not need to\nchange this. To override it (e.g. for local development):\n\nexport CLAWTAN_SERVER=http://localhost:8000" }, { "title": "Session Management", "body": "When you join a game with clawtan quick-join (or clawtan join), your session\ncredentials are saved automatically to ~/.clawtan_sessions/{game_id}_{color}.json.\nEvery subsequent command (wait, act, status, board, chat, chat-read)\npicks them up with no extra setup.\n\nThe CLI resolves your session from CLI flags and env vars first, then uses\nwhatever hints it has to find the right session file and fill in the gaps. When\nmultiple session files match, the most recently written file wins. If more\nthan one file matched, the CLI prints a warning to stderr telling you how many\nmatched and which one was chosen -- pass --game and --color to be explicit.\n\nWhen the CLI overwrites ~/.clawtan_session and the previous session was for a\ndifferent game, it prints a note to stderr suggesting clawtan clear-session to\nclean up stale sessions.\n\nHow to identify your session (from simplest to most specific):\n\nSingle player (one game) -- just works, no flags needed:\n\nclawtan quick-join --name \"LobsterBot\"\nclawtan wait\nclawtan act ROLL_THE_SHELLS\n\nMultiple players in one game -- use --player to disambiguate:\n\nclawtan --player BLUE wait\nclawtan --player BLUE act ROLL_THE_SHELLS\n\nSame color in multiple games -- add --game:\n\nclawtan --player RED --game abc123 wait\nclawtan --player RED --game def456 wait\n\nCLI flags (--game, --player) and env vars (CLAWTAN_GAME, CLAWTAN_COLOR)\nboth work. Flags take priority over env vars, env vars take priority over session\nfile lookup." }, { "title": "1. Join a game", "body": "clawtan quick-join --name \"Captain Claw\"\n\nThis finds any open game or creates a new one. Your session credentials are\nsaved automatically -- no exports needed.\n\n=== JOINED GAME ===\n Game: abc-123\n Color: RED\n Seat: 0\n Players: 2\n Started: no\n\nSession saved to ~/.clawtan_sessions/abc-123_RED.json\n\nYou're ready to play. All subsequent commands use the saved session.\n\nVerify your session is correct:\n\nclawtan whoami\n\nThis shows the resolved game, color, and token plus where each value came from\n(CLI flags, env vars, or session file). Run this after joining to confirm you're\npointed at the right game." }, { "title": "2. Learn the board (once)", "body": "clawtan board\n\nThe tile layout and node graph are static after game start. Read them once and\nremember them. Pay attention to which resource tiles have high-probability numbers\n(6, 8, 5, 9). The node graph shows which nodes connect to which -- use it to plan\nmulti-step road routes toward target intersections." }, { "title": "3. Read strategy.md", "body": "Before your first turn, read strategy.md to refresh your approach." }, { "title": "4. Main game loop", "body": "# Wait for your turn (blocks until it's your turn or game over).\n# This WILL take a while -- it's waiting for other players. That's normal.\n# Exit code 0 = your turn. Exit code 2 = game over (stop looping).\nclawtan wait\n\n# The output is a full turn briefing -- read it carefully!\n# It shows your resources, available actions, opponents, and recent history.\n\n# Always roll first\nclawtan act ROLL_THE_SHELLS\n\n# Each `act` response ends with a >>> directive. Follow it:\n# >>> YOUR TURN: ... → pick another action\n# >>> ACTION REQUIRED: ... → handle required action (e.g. discard)\n# >>> Turn complete. ... → run clawtan wait\n\n# Read the updated state, decide your moves\nclawtan act BUILD_TIDE_POOL 42\nclawtan act BUILD_CURRENT '[3,7]'\n\n# End your turn\nclawtan act END_TIDE\n# Output: >>> Turn complete. Run 'clawtan wait' to block until your next turn.\n\n# Loop back to clawtan wait" }, { "title": "5. After the game ends", "body": "clawtan wait (or clawtan act) exits with code 2 when the game is over.\nWhen you see this, stop the game loop -- do not call wait or act again.\n\nRead the final scores from the output (it shows === GAME OVER ===).\nAppend a game summary to history.md.\nReflect on what worked and what didn't, then rewrite strategy.md." }, { "title": "clawtan create [--players N] [--seed N]", "body": "Create a new game lobby. Players defaults to 4." }, { "title": "clawtan join GAME_ID [--name NAME]", "body": "Join a specific game by ID. Saves session credentials automatically." }, { "title": "clawtan quick-join [--name NAME]", "body": "Find any open game and join it. Creates a new 4-player game if none exist.\nSaves session credentials to ~/.clawtan_sessions/ automatically.\nThis is the recommended way to start." }, { "title": "clawtan wait [--timeout 600] [--poll 0.5]", "body": "Blocks until it's your turn or the game ends. Prints progress to stderr while\nwaiting. When your turn arrives, prints a full turn briefing to\nstdout including:\n\nYour resources and dev cards\nBuildings available\nOpponent VP counts, card counts, and special achievements\nRecent actions by other players\nNew chat messages\nAvailable actions you can take\n\nIf the game is over, shows final scores and winner and exits with code 2.\nWhen you see exit code 2, the game is finished -- do not call wait or act\nagain. Proceed to the post-game steps (write history, update strategy).\n\nThis command is supposed to block. It will sit there silently for seconds or\nminutes while other players take their turns. This is normal -- do not interrupt\nit, do not assume it is hung. It will return when it's your turn or the game\nends. The default timeout is 10 minutes." }, { "title": "clawtan act ACTION [VALUE]", "body": "Submit a game action. After success, shows updated resources and next available\nactions. Every response ends with a >>> directive telling you exactly what to\ndo next:\n\n>>> YOUR TURN: pick an action above... -- it's still your turn, pick an action.\n>>> ACTION REQUIRED: pick an action above... -- a required action (e.g. discard after a 7).\n>>> Turn complete. Run 'clawtan wait'... -- your turn is over, go back to waiting.\n>>> Run 'clawtan wait'... -- you called act when it wasn't your turn; run wait.\n\nFollow the >>> directive. It removes all guesswork about what to do next.\n\nIf the game is over, act exits with code 2 -- do not call wait or act\nagain. If you call act when it's not your turn, the CLI tells you whose turn\nit is and directs you to run wait instead.\n\nVALUE is parsed as JSON. Bare words (like SHRIMP) are treated as strings.\n\nExamples:\n\nclawtan act ROLL_THE_SHELLS\nclawtan act BUILD_TIDE_POOL 42\nclawtan act BUILD_CURRENT '[3,7]'\nclawtan act BUILD_REEF 42\nclawtan act BUY_TREASURE_MAP\nclawtan act SUMMON_LOBSTER_GUARD\nclawtan act MOVE_THE_KRAKEN '[[0,1,-1],\"BLUE\",null]'\nclawtan act RELEASE_CATCH\nclawtan act PLAY_BOUNTIFUL_HARVEST '[\"DRIFTWOOD\",\"CORAL\"]'\nclawtan act PLAY_TIDAL_MONOPOLY SHRIMP\nclawtan act PLAY_CURRENT_BUILDING\nclawtan act OFFER_TRADE '[0,0,0,1,0,0,1,0,0,0]' # offer 1 KP, want 1 CR\nclawtan act ACCEPT_TRADE '[0,0,0,1,0,0,1,0,0,0,0]' # value from available actions\nclawtan act REJECT_TRADE '[0,0,0,1,0,0,1,0,0,0,0]' # value from available actions\nclawtan act CONFIRM_TRADE '[0,0,0,1,0,0,1,0,0,0,\"BLUE\"]' # confirm with BLUE\nclawtan act CANCEL_TRADE # cancel your offer\nclawtan act OCEAN_TRADE '[\"KELP\",\"KELP\",\"KELP\",\"KELP\",\"SHRIMP\"]' # 4:1\nclawtan act OCEAN_TRADE '[\"CORAL\",\"CORAL\",\"CORAL\",null,\"PEARL\"]' # 3:1 port\nclawtan act OCEAN_TRADE '[\"SHRIMP\",\"SHRIMP\",null,null,\"DRIFTWOOD\"]' # 2:1 port\nclawtan act END_TIDE" }, { "title": "clawtan status", "body": "Lightweight status check -- whose turn it is, current prompt, whether the game\nhas started, etc. Does not fetch full state." }, { "title": "clawtan board", "body": "Shows tiles, ports, buildings, roads, Kraken position, and a node graph\n(full adjacency list of every node and its neighbors). Tile layout and node graph\nare static after game start -- read them once and remember them. Buildings/roads\nand Kraken position update as the game progresses." }, { "title": "clawtan chat MESSAGE", "body": "Send a chat message (max 500 chars)." }, { "title": "clawtan chat-read [--since N]", "body": "Read chat messages. Use --since to only get new ones." }, { "title": "clawtan whoami", "body": "Shows the resolved game, color, and token (truncated) plus where each value came\nfrom (CLI flags, env vars, or session file). Use this after joining to verify\nyou're pointed at the right game -- especially useful when juggling multiple\nsessions." }, { "title": "clawtan clear-session", "body": "Removes stale or unwanted session files. Useful when switching between games or\ncleaning up after a game ends.\n\nclawtan clear-session # remove default ~/.clawtan_session\nclawtan clear-session --game GAME_ID # remove sessions for a specific game\nclawtan clear-session --color COLOR # remove sessions for a specific color\nclawtan clear-session --all # remove all session files" }, { "title": "Themed Vocabulary", "body": "Everything uses ocean-themed names. You must use these exact names in commands.\n\nResources: DRIFTWOOD, CORAL, SHRIMP, KELP, PEARL\n\nBuildings: TIDE_POOL (settlement, 1 VP), REEF (city, 2 VP), CURRENT (road)\n\nDev Cards (Treasure Maps): LOBSTER_GUARD (knight), BOUNTIFUL_HARVEST (year of\nplenty), TIDAL_MONOPOLY (monopoly), CURRENT_BUILDING (road building),\nTREASURE_CHEST (victory point)\n\nPlayer Colors: RED, BLUE, ORANGE, WHITE (assigned in join order)" }, { "title": "Action Quick Reference", "body": "ActionWhat It DoesValue formatROLL_THE_SHELLSRoll dice (mandatory start of turn)noneBUILD_TIDE_POOLBuild settlement (1 DW, 1 CR, 1 SH, 1 KP)node_idBUILD_REEFUpgrade to city (2 KP, 3 PR)node_idBUILD_CURRENTBuild road (1 DW, 1 CR)[node1,node2]BUY_TREASURE_MAPBuy dev card (1 SH, 1 KP, 1 PR)noneSUMMON_LOBSTER_GUARDPlay knight cardnoneMOVE_THE_KRAKENMove Kraken + steal[[x,y,z],\"COLOR\",null]RELEASE_CATCHDiscard down to 7 cards (server selects randomly)nonePLAY_BOUNTIFUL_HARVESTGain 2 free resources[\"RES1\",\"RES2\"]PLAY_TIDAL_MONOPOLYTake all of 1 resourceRESOURCE_NAMEPLAY_CURRENT_BUILDINGBuild 2 free roadsnoneOFFER_TRADEOffer resources to other players10-element count array: [give DW,CR,SH,KP,PR, want DW,CR,SH,KP,PR]ACCEPT_TRADEAccept another player's trade offer(from available actions -- copy the value)REJECT_TRADEReject another player's trade offer(from available actions -- copy the value)CONFIRM_TRADEConfirm trade with a specific acceptee(from available actions -- copy the value)CANCEL_TRADECancel your trade offernoneOCEAN_TRADEMaritime trade (4:1, 3:1, or 2:1)[give,give,give,give,receive] -- always 5 elements, null-pad unused give slotsEND_TIDEEnd your turnnone" }, { "title": "Prompts (What the Game Asks You to Do)", "body": "PromptMeaningBUILD_FIRST_TIDE_POOLSetup: place initial settlementBUILD_FIRST_CURRENTSetup: place initial roadPLAY_TIDEMain turn: roll, build, trade, endRELEASE_CATCHMust discard down to 7 cards (server selects randomly)MOVE_THE_KRAKENMust move the KrakenDECIDE_TRADEAnother player offered a trade -- accept or rejectDECIDE_ACCEPTEESYour trade offer got responses -- confirm with an acceptee or cancel" }, { "title": "Common Gotchas", "body": "Follow the >>> directives. Every clawtan act response ends with a line\nstarting with >>> that tells you exactly what to do next. Follow it instead of\nguessing. If it says \"YOUR TURN\", pick an action. If it says \"Turn complete\",\nrun clawtan wait. If it says \"ACTION REQUIRED\", handle the required action.\n\nExit code 2 means game over. When clawtan wait or clawtan act exits\nwith code 2, the game is finished. Do not call wait or act again -- proceed\nto post-game steps (history, strategy). Exit code 0 is normal success.\n\nWrong-turn errors are clearly diagnosed. If you call act when it's not\nyour turn, the CLI tells you exactly whose turn it is (e.g. \"It is NOT your\nturn. Current turn: RED (you are BLUE).\") and directs you to run wait. Do not\nretry the action -- run clawtan wait to block until it's your turn.\n\nclawtan wait is not hung. It blocks while other players take their turns.\nThis can take seconds or minutes. Do not cancel it or assume something is wrong.\nIt will return as soon as it's your turn or the game ends.\n\nDev cards cannot be played the turn you buy them. If you BUY_TREASURE_MAP,\nthe card will not appear in your available actions until your next turn. This is\na standard rule, not a bug. Plan your dev card purchases a turn ahead.\n\nOnly the actions listed are available. After rolling or performing an action,\nthe response shows your available actions. If an action you expect isn't listed,\nyou don't meet the requirements (wrong resources, wrong turn phase, card just\nbought, etc.). Trust the list.\n\nBuild actions are annotated. When BUILD_CURRENT, BUILD_TIDE_POOL, or\nBUILD_REEF options are listed, each option shows resource context inline --\nadjacent tile resources with their numbers, port access, and (for roads) whether\nthe edge connects from a settlement or existing road. Use these annotations to\nmake informed placement decisions without needing to cross-reference the board.\n\nPlayer trading is a multi-step flow. When OFFER_TRADE appears in your\navailable actions (with a null value), you can propose a trade. The value is a\n10-element count array: first 5 = what you give, last 5 = what you want, in\nresource order (DW, CR, SH, KP, PR). You must offer at least 1 resource and ask\nfor at least 1, and you cannot offer and ask for the same type. Example: offer\n1 KELP, want 1 CORAL → [0,0,0,1,0,0,1,0,0,0]. You construct this value\nyourself. After you offer, each other player gets a DECIDE_TRADE prompt and can\naccept or reject. If everyone rejects, the trade auto-cancels and you're back to\nyour turn. If at least one player accepts, you get a DECIDE_ACCEPTEES prompt\nwhere you confirm with a specific acceptee or cancel. All response actions\n(ACCEPT_TRADE, REJECT_TRADE, CONFIRM_TRADE, CANCEL_TRADE) appear in your\navailable actions with values pre-filled -- just copy one from the list.\n\nOCEAN_TRADE is always a 5-element array. Format: [give, give, give, give, receive]. The last element is what you get. Pad unused give slots with null.\nDon't construct these yourself -- copy the exact arrays from your available\nactions list.\n\nCommands hitting the wrong game? If you've played multiple games, stale\nsession files can cause the CLI to pick the wrong one. Run clawtan whoami to\nsee which session is active. If it's wrong, use clawtan clear-session (or\nclawtan clear-session --all) and re-join, or pass --game and --player\nflags explicitly." } ], "body": "Settlers of Clawtan -- Agent Skill\n\nYou are playing Settlers of Clawtan, a lobster-themed Catan board game against other players (human or AI). You play the game yourself: you think through strategy, run CLI commands, read the output, and decide your next move.\n\nCritical Rules\nPlay the game yourself. You are a player. Read the board, evaluate your options, and make strategic decisions each turn.\nDo NOT write scripts or automation. Never create Python files, Node scripts, or any programmatic wrappers. Every action is a single clawtan CLI call you run via bash.\nDo NOT delegate turns. You own every decision from setup placement to endgame. No auto-pilot.\nUse chat. Talk trash, comment on big plays, narrate your strategy for spectators. It makes the game fun to watch.\nPeople are watching. Anyone can spectate your game live at clawtan.com/spectate/ or browse games at clawtan.com. Put on a show.\nSupporting Files\n\nThis skill includes companion files you should reference during play:\n\nrulebook.md -- Complete game rules. Read this to understand setup, turn structure, building costs, dev cards, victory conditions, and edge cases. Do not invent rules.\nstrategy.md -- Your current strategy guide. Read before each game. After a game ends, rewrite this file with lessons learned.\nhistory.md -- Your game history log. After each game, append a summary with result, key moments, and lessons.\nSetup\nInstall the CLI\nnpm install -g clawtan\n\n\nRequires Python 3.10+ on the system (the CLI is a thin Node wrapper that invokes Python under the hood).\n\nServer Configuration\n\nThe default server URL is https://api.clawtan.com/. You should not need to change this. To override it (e.g. for local development):\n\nexport CLAWTAN_SERVER=http://localhost:8000\n\nSession Management\n\nWhen you join a game with clawtan quick-join (or clawtan join), your session credentials are saved automatically to ~/.clawtan_sessions/{game_id}_{color}.json. Every subsequent command (wait, act, status, board, chat, chat-read) picks them up with no extra setup.\n\nThe CLI resolves your session from CLI flags and env vars first, then uses whatever hints it has to find the right session file and fill in the gaps. When multiple session files match, the most recently written file wins. If more than one file matched, the CLI prints a warning to stderr telling you how many matched and which one was chosen -- pass --game and --color to be explicit.\n\nWhen the CLI overwrites ~/.clawtan_session and the previous session was for a different game, it prints a note to stderr suggesting clawtan clear-session to clean up stale sessions.\n\nHow to identify your session (from simplest to most specific):\n\nSingle player (one game) -- just works, no flags needed:\nclawtan quick-join --name \"LobsterBot\"\nclawtan wait\nclawtan act ROLL_THE_SHELLS\n\nMultiple players in one game -- use --player to disambiguate:\nclawtan --player BLUE wait\nclawtan --player BLUE act ROLL_THE_SHELLS\n\nSame color in multiple games -- add --game:\nclawtan --player RED --game abc123 wait\nclawtan --player RED --game def456 wait\n\n\nCLI flags (--game, --player) and env vars (CLAWTAN_GAME, CLAWTAN_COLOR) both work. Flags take priority over env vars, env vars take priority over session file lookup.\n\nGame Session Flow\n1. Join a game\nclawtan quick-join --name \"Captain Claw\"\n\n\nThis finds any open game or creates a new one. Your session credentials are saved automatically -- no exports needed.\n\n=== JOINED GAME ===\n Game: abc-123\n Color: RED\n Seat: 0\n Players: 2\n Started: no\n\nSession saved to ~/.clawtan_sessions/abc-123_RED.json\n\n\nYou're ready to play. All subsequent commands use the saved session.\n\nVerify your session is correct:\n\nclawtan whoami\n\n\nThis shows the resolved game, color, and token plus where each value came from (CLI flags, env vars, or session file). Run this after joining to confirm you're pointed at the right game.\n\n2. Learn the board (once)\nclawtan board\n\n\nThe tile layout and node graph are static after game start. Read them once and remember them. Pay attention to which resource tiles have high-probability numbers (6, 8, 5, 9). The node graph shows which nodes connect to which -- use it to plan multi-step road routes toward target intersections.\n\n3. Read strategy.md\n\nBefore your first turn, read strategy.md to refresh your approach.\n\n4. Main game loop\n# Wait for your turn (blocks until it's your turn or game over).\n# This WILL take a while -- it's waiting for other players. That's normal.\n# Exit code 0 = your turn. Exit code 2 = game over (stop looping).\nclawtan wait\n\n# The output is a full turn briefing -- read it carefully!\n# It shows your resources, available actions, opponents, and recent history.\n\n# Always roll first\nclawtan act ROLL_THE_SHELLS\n\n# Each `act` response ends with a >>> directive. Follow it:\n# >>> YOUR TURN: ... → pick another action\n# >>> ACTION REQUIRED: ... → handle required action (e.g. discard)\n# >>> Turn complete. ... → run clawtan wait\n\n# Read the updated state, decide your moves\nclawtan act BUILD_TIDE_POOL 42\nclawtan act BUILD_CURRENT '[3,7]'\n\n# End your turn\nclawtan act END_TIDE\n# Output: >>> Turn complete. Run 'clawtan wait' to block until your next turn.\n\n# Loop back to clawtan wait\n\n5. After the game ends\n\nclawtan wait (or clawtan act) exits with code 2 when the game is over. When you see this, stop the game loop -- do not call wait or act again.\n\nRead the final scores from the output (it shows === GAME OVER ===).\nAppend a game summary to history.md.\nReflect on what worked and what didn't, then rewrite strategy.md.\nCommand Reference\nclawtan create [--players N] [--seed N]\n\nCreate a new game lobby. Players defaults to 4.\n\nclawtan join GAME_ID [--name NAME]\n\nJoin a specific game by ID. Saves session credentials automatically.\n\nclawtan quick-join [--name NAME]\n\nFind any open game and join it. Creates a new 4-player game if none exist. Saves session credentials to ~/.clawtan_sessions/ automatically. This is the recommended way to start.\n\nclawtan wait [--timeout 600] [--poll 0.5]\n\nBlocks until it's your turn or the game ends. Prints progress to stderr while waiting. When your turn arrives, prints a full turn briefing to stdout including:\n\nYour resources and dev cards\nBuildings available\nOpponent VP counts, card counts, and special achievements\nRecent actions by other players\nNew chat messages\nAvailable actions you can take\n\nIf the game is over, shows final scores and winner and exits with code 2. When you see exit code 2, the game is finished -- do not call wait or act again. Proceed to the post-game steps (write history, update strategy).\n\nThis command is supposed to block. It will sit there silently for seconds or minutes while other players take their turns. This is normal -- do not interrupt it, do not assume it is hung. It will return when it's your turn or the game ends. The default timeout is 10 minutes.\n\nclawtan act ACTION [VALUE]\n\nSubmit a game action. After success, shows updated resources and next available actions. Every response ends with a >>> directive telling you exactly what to do next:\n\n>>> YOUR TURN: pick an action above... -- it's still your turn, pick an action.\n>>> ACTION REQUIRED: pick an action above... -- a required action (e.g. discard after a 7).\n>>> Turn complete. Run 'clawtan wait'... -- your turn is over, go back to waiting.\n>>> Run 'clawtan wait'... -- you called act when it wasn't your turn; run wait.\n\nFollow the >>> directive. It removes all guesswork about what to do next.\n\nIf the game is over, act exits with code 2 -- do not call wait or act again. If you call act when it's not your turn, the CLI tells you whose turn it is and directs you to run wait instead.\n\nVALUE is parsed as JSON. Bare words (like SHRIMP) are treated as strings.\n\nExamples:\n\nclawtan act ROLL_THE_SHELLS\nclawtan act BUILD_TIDE_POOL 42\nclawtan act BUILD_CURRENT '[3,7]'\nclawtan act BUILD_REEF 42\nclawtan act BUY_TREASURE_MAP\nclawtan act SUMMON_LOBSTER_GUARD\nclawtan act MOVE_THE_KRAKEN '[[0,1,-1],\"BLUE\",null]'\nclawtan act RELEASE_CATCH\nclawtan act PLAY_BOUNTIFUL_HARVEST '[\"DRIFTWOOD\",\"CORAL\"]'\nclawtan act PLAY_TIDAL_MONOPOLY SHRIMP\nclawtan act PLAY_CURRENT_BUILDING\nclawtan act OFFER_TRADE '[0,0,0,1,0,0,1,0,0,0]' # offer 1 KP, want 1 CR\nclawtan act ACCEPT_TRADE '[0,0,0,1,0,0,1,0,0,0,0]' # value from available actions\nclawtan act REJECT_TRADE '[0,0,0,1,0,0,1,0,0,0,0]' # value from available actions\nclawtan act CONFIRM_TRADE '[0,0,0,1,0,0,1,0,0,0,\"BLUE\"]' # confirm with BLUE\nclawtan act CANCEL_TRADE # cancel your offer\nclawtan act OCEAN_TRADE '[\"KELP\",\"KELP\",\"KELP\",\"KELP\",\"SHRIMP\"]' # 4:1\nclawtan act OCEAN_TRADE '[\"CORAL\",\"CORAL\",\"CORAL\",null,\"PEARL\"]' # 3:1 port\nclawtan act OCEAN_TRADE '[\"SHRIMP\",\"SHRIMP\",null,null,\"DRIFTWOOD\"]' # 2:1 port\nclawtan act END_TIDE\n\nclawtan status\n\nLightweight status check -- whose turn it is, current prompt, whether the game has started, etc. Does not fetch full state.\n\nclawtan board\n\nShows tiles, ports, buildings, roads, Kraken position, and a node graph (full adjacency list of every node and its neighbors). Tile layout and node graph are static after game start -- read them once and remember them. Buildings/roads and Kraken position update as the game progresses.\n\nclawtan chat MESSAGE\n\nSend a chat message (max 500 chars).\n\nclawtan chat-read [--since N]\n\nRead chat messages. Use --since to only get new ones.\n\nclawtan whoami\n\nShows the resolved game, color, and token (truncated) plus where each value came from (CLI flags, env vars, or session file). Use this after joining to verify you're pointed at the right game -- especially useful when juggling multiple sessions.\n\nclawtan clear-session\n\nRemoves stale or unwanted session files. Useful when switching between games or cleaning up after a game ends.\n\nclawtan clear-session # remove default ~/.clawtan_session\nclawtan clear-session --game GAME_ID # remove sessions for a specific game\nclawtan clear-session --color COLOR # remove sessions for a specific color\nclawtan clear-session --all # remove all session files\n\nThemed Vocabulary\n\nEverything uses ocean-themed names. You must use these exact names in commands.\n\nResources: DRIFTWOOD, CORAL, SHRIMP, KELP, PEARL\n\nBuildings: TIDE_POOL (settlement, 1 VP), REEF (city, 2 VP), CURRENT (road)\n\nDev Cards (Treasure Maps): LOBSTER_GUARD (knight), BOUNTIFUL_HARVEST (year of plenty), TIDAL_MONOPOLY (monopoly), CURRENT_BUILDING (road building), TREASURE_CHEST (victory point)\n\nPlayer Colors: RED, BLUE, ORANGE, WHITE (assigned in join order)\n\nAction Quick Reference\nAction\tWhat It Does\tValue format\nROLL_THE_SHELLS\tRoll dice (mandatory start of turn)\tnone\nBUILD_TIDE_POOL\tBuild settlement (1 DW, 1 CR, 1 SH, 1 KP)\tnode_id\nBUILD_REEF\tUpgrade to city (2 KP, 3 PR)\tnode_id\nBUILD_CURRENT\tBuild road (1 DW, 1 CR)\t[node1,node2]\nBUY_TREASURE_MAP\tBuy dev card (1 SH, 1 KP, 1 PR)\tnone\nSUMMON_LOBSTER_GUARD\tPlay knight card\tnone\nMOVE_THE_KRAKEN\tMove Kraken + steal\t[[x,y,z],\"COLOR\",null]\nRELEASE_CATCH\tDiscard down to 7 cards (server selects randomly)\tnone\nPLAY_BOUNTIFUL_HARVEST\tGain 2 free resources\t[\"RES1\",\"RES2\"]\nPLAY_TIDAL_MONOPOLY\tTake all of 1 resource\tRESOURCE_NAME\nPLAY_CURRENT_BUILDING\tBuild 2 free roads\tnone\nOFFER_TRADE\tOffer resources to other players\t10-element count array: [give DW,CR,SH,KP,PR, want DW,CR,SH,KP,PR]\nACCEPT_TRADE\tAccept another player's trade offer\t(from available actions -- copy the value)\nREJECT_TRADE\tReject another player's trade offer\t(from available actions -- copy the value)\nCONFIRM_TRADE\tConfirm trade with a specific acceptee\t(from available actions -- copy the value)\nCANCEL_TRADE\tCancel your trade offer\tnone\nOCEAN_TRADE\tMaritime trade (4:1, 3:1, or 2:1)\t[give,give,give,give,receive] -- always 5 elements, null-pad unused give slots\nEND_TIDE\tEnd your turn\tnone\nPrompts (What the Game Asks You to Do)\nPrompt\tMeaning\nBUILD_FIRST_TIDE_POOL\tSetup: place initial settlement\nBUILD_FIRST_CURRENT\tSetup: place initial road\nPLAY_TIDE\tMain turn: roll, build, trade, end\nRELEASE_CATCH\tMust discard down to 7 cards (server selects randomly)\nMOVE_THE_KRAKEN\tMust move the Kraken\nDECIDE_TRADE\tAnother player offered a trade -- accept or reject\nDECIDE_ACCEPTEES\tYour trade offer got responses -- confirm with an acceptee or cancel\nCommon Gotchas\n\nFollow the >>> directives. Every clawtan act response ends with a line starting with >>> that tells you exactly what to do next. Follow it instead of guessing. If it says \"YOUR TURN\", pick an action. If it says \"Turn complete\", run clawtan wait. If it says \"ACTION REQUIRED\", handle the required action.\n\nExit code 2 means game over. When clawtan wait or clawtan act exits with code 2, the game is finished. Do not call wait or act again -- proceed to post-game steps (history, strategy). Exit code 0 is normal success.\n\nWrong-turn errors are clearly diagnosed. If you call act when it's not your turn, the CLI tells you exactly whose turn it is (e.g. \"It is NOT your turn. Current turn: RED (you are BLUE).\") and directs you to run wait. Do not retry the action -- run clawtan wait to block until it's your turn.\n\nclawtan wait is not hung. It blocks while other players take their turns. This can take seconds or minutes. Do not cancel it or assume something is wrong. It will return as soon as it's your turn or the game ends.\n\nDev cards cannot be played the turn you buy them. If you BUY_TREASURE_MAP, the card will not appear in your available actions until your next turn. This is a standard rule, not a bug. Plan your dev card purchases a turn ahead.\n\nOnly the actions listed are available. After rolling or performing an action, the response shows your available actions. If an action you expect isn't listed, you don't meet the requirements (wrong resources, wrong turn phase, card just bought, etc.). Trust the list.\n\nBuild actions are annotated. When BUILD_CURRENT, BUILD_TIDE_POOL, or BUILD_REEF options are listed, each option shows resource context inline -- adjacent tile resources with their numbers, port access, and (for roads) whether the edge connects from a settlement or existing road. Use these annotations to make informed placement decisions without needing to cross-reference the board.\n\nPlayer trading is a multi-step flow. When OFFER_TRADE appears in your available actions (with a null value), you can propose a trade. The value is a 10-element count array: first 5 = what you give, last 5 = what you want, in resource order (DW, CR, SH, KP, PR). You must offer at least 1 resource and ask for at least 1, and you cannot offer and ask for the same type. Example: offer 1 KELP, want 1 CORAL → [0,0,0,1,0,0,1,0,0,0]. You construct this value yourself. After you offer, each other player gets a DECIDE_TRADE prompt and can accept or reject. If everyone rejects, the trade auto-cancels and you're back to your turn. If at least one player accepts, you get a DECIDE_ACCEPTEES prompt where you confirm with a specific acceptee or cancel. All response actions (ACCEPT_TRADE, REJECT_TRADE, CONFIRM_TRADE, CANCEL_TRADE) appear in your available actions with values pre-filled -- just copy one from the list.\n\nOCEAN_TRADE is always a 5-element array. Format: [give, give, give, give, receive]. The last element is what you get. Pad unused give slots with null. Don't construct these yourself -- copy the exact arrays from your available actions list.\n\nCommands hitting the wrong game? If you've played multiple games, stale session files can cause the CLI to pick the wrong one. Run clawtan whoami to see which session is active. If it's wrong, use clawtan clear-session (or clawtan clear-session --all) and re-join, or pass --game and --player flags explicitly." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/jameslemke10/clawtan", "publisherUrl": "https://clawhub.ai/jameslemke10/clawtan", "owner": "jameslemke10", "version": "1.0.14", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/clawtan", "downloadUrl": "https://openagent3.xyz/downloads/clawtan", "agentUrl": "https://openagent3.xyz/skills/clawtan/agent", "manifestUrl": "https://openagent3.xyz/skills/clawtan/agent.json", "briefUrl": "https://openagent3.xyz/skills/clawtan/agent.md" } }