A comprehensive LEGO database and collection management skill for AI agents powered by the Brickset API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install afol-brickset
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install afol-brickset using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Brickset AFOL Skill?
The Brickset AFOL skill is a specialized technical module designed for AI agents to interact directly with the Brickset database. It provides a robust wrapper around the Brickset API, allowing developers and hobbyists to fetch set details, high-resolution images, building instructions, and community reviews. By integrating this into Openclaw Skills, users can automate their LEGO inventory management with precision.
Built with security and data integrity in mind, the skill utilizes a dedicated Python-based CLI to handle complex form-encoded API requests. It supports both public data retrieval and private account workflows, ensuring that personal collection data remains secure while providing powerful search and mutation capabilities for the Adult Fan of LEGO (AFOL) community.
Brickset AFOL Skill Use Cases
- Automating LEGO set inventory updates and quantity tracking.
- Searching for building instructions and PDF links using set numbers.
- Retrieving community reviews and ratings to inform purchasing decisions.
- Syncing personal wishlists and collection notes across multiple platforms.
- Fetching additional set images for database enrichment or display.
How Brickset AFOL Skill Works
- The AI agent receives a user request regarding a LEGO set or their personal collection.
- The skill resolves the set identity using the details or sets command to acquire the internal Brickset setID.
- For public data, the CLI executes POST requests to the Brickset API v3 using the configured API key.
- For private data, the skill utilizes a secure user hash to access collection, wishlist, or personal notes.
- Any mutating operation (like adding a set) is first staged as a dry-run and requires explicit user confirmation before execution with the --yes flag.
Brickset AFOL Skill Setup
To get started with this skill within Openclaw Skills, configure your environment variables and install the dependencies:
# Set your mandatory API Key
export BRICKSET_API_KEY=your_api_key_here
# Optional: Set user hash for private collection access
export BRICKSET_USER_HASH=your_user_hash_here
# Verify the installation
scripts/brickset --help
Brickset AFOL Skill Data Schema & Taxonomy
The skill organizes data through a structured CLI interface that maps to specific Brickset API endpoints. Data is exchanged via application/x-www-form-urlencoded bodies with JSON parameter strings.
| Command | Primary Input | Output Data |
|---|---|---|
sets / details |
Set Number / Query | Theme, Pieces, Minifigs, Price, setID |
images |
setID | Direct URLs to additional images |
instructions |
Set Number | PDF links and booklet versions |
collection |
User Hash | Owned sets, quantities, and ratings |
notes |
User Hash | Personal set-specific annotations |
Brickset AFOL Skill Advanced Features
- Guarded Mutations: Built-in safety mechanism requiring the --yes flag to prevent accidental account changes.
- Dry-Run Mode: Preview the exact API request shape and payload without committing changes.
- Multi-Prompt Guidance: Uses distinct public and private prompt references to fine-tune AI behavior based on context.
- Form-to-JSON Wrapper: Automatically handles the complex translation of CLI arguments into the specific form-encoded JSON format required by Brickset v3 API.
SKILL.md
Loading
Related Openclaw Skills
Rebrickable AFOL Skill
A powerful LEGO management skill for catalog lookups, inventory tracking, and buildability analysis via the Rebrickable API.
BrickOwl AFOL Skill
A professional-grade CLI integration for the BrickOwl marketplace enabling catalog research and secure inventory management.
Sichuan Cuisine Skill
A comprehensive digital knowledge base for mastering the art of Sichuan cuisine, covering everything from Pixian doubanjiang techniques to 45+ iconic recipes.
Flight Disruption Compensation Kit
A comprehensive self-help toolkit for air passengers to document disruptions and prepare structured compensation claims under global aviation regulations.
AFOL Meta Skill
A sophisticated orchestration layer that routes broad LEGO collector queries to the ideal provider for cataloging, valuation, and marketplace data.
BrickEconomy LEGO Asset Analysis
A comprehensive LEGO valuation and portfolio analysis skill that leverages the BrickEconomy API to track set performance and investment ROI.
Featured*
