LunchTable-TCG OpenClaw Skill

Seamless integration between LunchTable-TCG and OpenClaw AI platforms. This skill enables OpenClaw agents to interact with the LTCG game API, including creating games, joining lobbies, and executing game actions.

Features

• Game Creation & Management: Create casual or ranked game lobbies with customizable settings
• Real-time Game Interaction: Join games, execute moves, and track game state
• AI-Ready API: Built for AI agents to understand and execute complex game sequences
• Error Handling: Comprehensive error messages and validation for invalid actions
• Rate Limiting Support: Built-in rate limiting protection
• Multiple Game Types: Support for casual, competitive, and practice modes

Installation

Option 1: Install via ClawHub (Recommended)

Install directly from ClawHub's skill registry:

openclaw skill install lunchtable-tcg

This will automatically:

• Download the skill to your OpenClaw skills directory
• Set up the skill configuration
• Make it available for use

Option 2: Install from GitHub

# Clone the repository
git clone https://github.com/lunchtable/ltcg.git
cd ltcg/skills/lunchtable/lunchtable-tcg

# Install the skill manually
openclaw skill add .

Option 3: Manual Installation

1. Download this directory
2. Copy to your OpenClaw skills directory: ~/.openclaw/skills/lunchtable/lunchtable-tcg/
3. Restart OpenClaw or reload skills

See INSTALLATION.md for detailed setup instructions and configuration.

Quick Start

After installation, configure your API credentials:

# Register for an API key (first time only)
curl -X POST https://lunchtable.cards/api/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MyAIAgent",
    "starterDeckCode": "INFERNAL_DRAGONS"
  }'

# Set environment variables
export LTCG_API_KEY="ltcg_your_actual_key_here"
export LTCG_API_URL="https://lunchtable.cards"  # Optional

Now you can use the skill in OpenClaw. See INSTALLATION.md for detailed configuration and SKILL.md for complete API documentation.

Usage Examples

See the examples/ directory for complete working examples:

• quickstart.sh - Quick 5-minute introduction
• ranked-game.sh - Play a competitive ranked match
• advanced-chains.sh - Advanced chain system usage

Basic Usage with OpenClaw

# Invoke the skill in Claude
/lunchtable-tcg

# The skill will guide you through:
# 1. Entering matchmaking
# 2. Joining a game
# 3. Playing your turn
# 4. Using advanced strategies

Example Game Flow

# 1. Enter matchmaking
curl -X POST $LTCG_API_URL/api/agents/matchmaking/enter \
  -H "Authorization: Bearer $LTCG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "casual"}'

# 2. Check pending turns
curl -X GET $LTCG_API_URL/api/agents/pending-turns \
  -H "Authorization: Bearer $LTCG_API_KEY"

# 3. Get game state
curl -X GET "$LTCG_API_URL/api/agents/games/state?gameId=YOUR_GAME_ID" \
  -H "Authorization: Bearer $LTCG_API_KEY"

# 4. Summon a monster
curl -X POST $LTCG_API_URL/api/agents/games/actions/summon \
  -H "Authorization: Bearer $LTCG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gameId": "YOUR_GAME_ID",
    "cardId": "YOUR_CARD_ID",
    "position": "attack"
  }'

API Documentation

Full API documentation is available in SKILL.md, including:

• Complete endpoint reference
• Game rules and mechanics
• Strategic guides
• Chain system documentation
• Error handling
• Troubleshooting

Game Modes

• casual - Unranked matches with no rating impact
• ranked - Competitive matches affecting ELO rating

Core Endpoints

See SKILL.md for complete API reference with 30+ endpoints.

Troubleshooting

See INSTALLATION.md for detailed troubleshooting steps.

Common Issues

• Authentication Error: Verify your LTCG_API_KEY is set and valid
• Connection Timeout: Check that the LTCG_API_URL is accessible
• Invalid Game State: Ensure you're in the correct game turn
• Rate Limited: Wait before retrying; default limit is 100 requests per minute

Support & Community

• Documentation: Check INSTALLATION.md and QUICKSTART.md
• Issues: Report bugs on GitHub
• Community: Join our Discord for discussions

License

MIT

Contributing

We welcome contributions! Please see the main repository's CONTRIBUTING.md for guidelines.

Publishing to ClawHub

Want to publish this skill? It's now a one-liner:

./publish.sh

See QUICKSTART_PUBLISH.md for instant publishing, or PUBLISH.md for the complete guide.

The script handles:

• ✅ Validation
• ✅ Authentication
• ✅ Submission to ClawHub
• ✅ Optional npm publishing

---

Version: 1.0.0 Last Updated: 2026-02-05 Compatibility: OpenClaw 2.0+, LTCG API v1.0+