A comprehensive Chinese idiom reference tool for AI agents providing meanings, historical stories, and interactive word games.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install idiom-dictionary
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 idiom-dictionary 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 Idiom Dictionary?
The Idiom Dictionary skill is a powerful extension designed for Openclaw Skills that enables AI agents to query and interact with the vast world of Chinese idioms (Chengyu). It goes beyond simple definitions, offering historical context through classical stories, interactive word chain games, and educational quizzes. This skill is essential for developers building linguistic tools or cultural learning assistants that require high-quality Chinese language data.
By integrating this into Openclaw Skills, agents gain the ability to provide accurate usage examples, categorize idioms by theme, and engage users in traditional wordplay. It serves as a bridge between modern AI and classical literature, ensuring that idiom-related queries are handled with depth and precision without requiring external API dependencies.
Idiom Dictionary Use Cases
- Researching the historical origin or classical story behind a specific Chinese idiom.
- Generating creative writing examples using correct idiom usage in modern sentences.
- Hosting interactive Cheng-yu Jie-long (idiom chain) games within an AI chat interface.
- Providing educational quizzes to help students master Chinese cultural expressions and folklore.
- Categorizing idioms for thematic content creation or linguistic analysis projects.
How Idiom Dictionary Works
- The AI agent triggers the skill within the Openclaw Skills environment when a user asks about a specific idiom or requests a dictionary function.
- The skill executes the search or story command to retrieve definitions and historical context from the local data directory.
- For interactive sessions, the agent uses the chain or quiz logic to manage the state of word games and validate user input.
- The usage command generates contextual sentence examples to demonstrate how the idiom is applied in real-world scenarios.
- Results are formatted as structured text and returned to the user through the Openclaw Skills interface.
Idiom Dictionary Setup
To get started with this component of Openclaw Skills, use the following commands in your terminal:
# Display available commands and help documentation
idiom-dictionary help
# Initialize the skill and run the main interface
idiom-dictionary run
By default, data is stored in ~/.local/share/idiom-dictionary/. You can customize this by setting the environment variable:
export IDIOM_DICTIONARY_DIR="/your/custom/path"
Idiom Dictionary Data Schema & Taxonomy
The Idiom Dictionary within Openclaw Skills organizes its data into the following structure for easy retrieval and analysis:
| Field | Description |
|---|---|
| Idiom Name | The primary key used for search, indexing, and chain games. |
| Definition | The literal and metaphorical meaning of the idiom in modern Chinese. |
| Story | Classical origin, historical context, and the literature it derived from. |
| Usage | Example sentences demonstrating modern application and syntax. |
| Category | Thematic classification such as courage, wisdom, nature, or history. |
Idiom Dictionary Advanced Features
- Interactive Chain Games: Built-in logic for idiom chain challenges to test agent and user knowledge limits.
- Cultural Quiz Mode: Automated quiz generation for educational workflows and interactive learning.
- Custom Data Directories: Support for the IDIOM_DICTIONARY_DIR variable to integrate with existing private knowledge bases.
- No-API Dependency: Fully local execution within the Openclaw Skills framework ensuring privacy and high-speed response times.
- Thematic Browsing: Command-based filtering that allows agents to suggest idioms based on specific emotional or situational categories.
SKILL.md
Loading
Related Openclaw Skills
Quantum Bridge
A high-performance bridge for transpiling quantum circuits between Qiskit and OriginIR and executing them on real 72-qubit quantum hardware.
EctoClaw
EctoClaw provides an immutable, cryptographically signed audit trail and policy-based firewall to secure Openclaw Skills.
Drawing
A specialized prompt protocol and asset management system for creating high-quality children's illustrations and coloring pages.
Socket Abstraction & Multiplexing
A comprehensive skill for managing socket abstractions, kernel-level options, I/O multiplexing, and local inter-process communication.
Minimax Web Search
A high-performance web search skill leveraging the Minimax Coding Plan Search API to provide real-time data and technical search results.
YouTube Search Skill
A powerful skill that allows AI agents to search YouTube for videos, channels, and playlists using the yutu CLI.
Featured*
