Getting Started
Learn the basics of OpenClaw Skill and how to install your first skill bundle. Understand the ecosystem and discover what's possible with custom automation.
Read Guide →OpenClaw Skill, the skill hub for intelligent agents.
Create custom skills tailored to your workflow with simple SKILL.md files. No fine-tuning needed—just natural language instructions that teach AI agents exactly what you need. Open source, community-driven, zero barriers.
terminal
$ npx openclawskill install soul-personality
✓ Installing skill: soul-personality@2.4.1
✓ Dependencies resolved
✓ Skill installed successfullySearch Skills
Versioned, rollback-ready, discoverable through intelligent search
Install any skill folder in one command:
npx openclawskill install soul-personality
Featured Skills
Curated excellence — highlighted for immediate trust
soul-personality
FeaturedCore personality and values system. Defines agent behavior with explicit instructions: "be genuinely helpful, have opinions, be resourceful." No fine-tuning needed—just well-crafted prompts.
memory-system
FeaturedFile-based memory architecture. Reads memory/YYYY-MM-DD.md for recent context and MEMORY.md for long-term memories. No vector database—just markdown files that update as the agent learns.
bootstrap-ritual
FeaturedFirst-run experience that creates the "coming alive" moment. Guides agents through identity discovery with "Who am I? Who are you?" prompts. Theatrical but effective for memorable first impressions.
identity-builder
FeaturedDynamic identity system where agents define their own name, creature type, vibe, and emoji during first conversation. Creates unique personalities through structured markdown templates.
telegram-adapter
FeaturedMinimal Telegram bot adapter connecting messaging platforms to Claude Code. Demonstrates core OpenClaw messaging patterns: receive message, call Claude, send response. ~100 lines of Python.
system-prompt-engine
FeaturedDeep dive into system prompt construction. Covers base identity injection, tool definitions, skill discovery, memory recall, and heartbeat systems. Essential for understanding OpenClaw behavior.
Latest Additions
Fresh uploads across the entire registry
tools-config
NewEnvironment-specific tool configuration system. Manages camera names, SSH hosts, speaker names, and other context-aware device mappings for seamless integration.
user-context
NewUser information management system. Stores name, timezone, preferences, and contextual details to personalize agent interactions and maintain conversation continuity.
workspace-behavior
NewWorkspace behavior rules and safety guidelines. Defines when to speak in group chats, memory system protocols, and interaction boundaries for Claude Code integration.
group-chat-handler
NewIntelligent group chat behavior system. Implements HEARTBEAT_OK protocol, reaction vs reply logic, and conversation dominance prevention through explicit prompt rules.
heartbeat-system
NewProactive check-in and heartbeat mechanism. Enables agents to initiate conversations, check on users, and maintain engagement without being intrusive or dominating chats.
markdown-formatter
NewPlatform-specific markdown formatting adapter. Converts markdown to platform-native formats for Telegram, WhatsApp, Discord, Signal, and other messaging channels.
How Skills Work
Natural language instructions, not rigid APIs
SKILL.md
---
metadata.openclaw:
emoji: 🍷
requires:
bins: [sqlite3]
env: [CELLAR_DB_PATH]
---
# Wine Cellar Manager
Manage your wine collection with ease.
Track vintages, regions, tasting notes...
## Usage
When the user asks about wine...
Confirm additions, validate data...
## Implementation
Uses SQLite database at...
Syncs with external services...SKILL.md Structure
Every skill lives in a folder with one essential file: SKILL.md. This Markdown file teaches the AI agent how to use your skill through natural language instructions rather than rigid API documentation. Start with the skill name, add a description, include usage examples, and provide implementation details.
Metadata Block
The metadata.openclaw YAML block configures how OpenClaw loads and manages your skill. Specify emoji icons, dependencies (bins, env, config), and installation commands. This ensures your skill works reliably across different environments.
Natural Language Power
Write instructions in plain English describing behavior, edge cases, and preferences. The AI reads these instructions and adapts its behavior accordingly. No rigid schemas. No extensive boilerplate. Just clear communication about what the skill should accomplish.
Publish Your Skill
Share your AI capabilities with the community
1
Create SKILL.md
Every skill lives in a folder with one essential file: SKILL.md. Write natural language instructions explaining what your skill does, when to use it, and how it works. No rigid schemas—just clear communication.
2
Add Metadata
Configure the metadata.openclaw block with emoji icons, dependencies (bins, env, config), and installation commands. This ensures your skill works reliably across different environments.
3
Test & Share
Test your skill thoroughly with various prompts. Verify dependency installation on clean systems. Document configuration clearly, then share with the community.
The Power of Custom Skills
Build exactly what you need, expressed in your terms
Domain-Specific Solutions
Create skills for workflows that generic tools can't handle. Wine cellar inventory, PR review automation, cross-platform publishing—specialized workflows that match your exact needs.
Productivity Multiplier
Every unique workflow you automate compounds your productivity advantage. Your personal OpenClaw instance becomes uniquely adapted to your work patterns over time.
Autonomous Workflows
Enable agent workflows that span extended timeframes. Monitor conditions, take actions, and report results over days or weeks—impossible with session-based tools.
Low Barrier to Entry
No deep machine learning knowledge required. Just clear thinking about your workflow and the ability to express it in natural language instructions. Start small, iterate, and share.
Documentation
SKILL.md Structure
Master the anatomy of SKILL.md files. Learn how to write natural language instructions that teach AI agents to use your skill effectively through plain English descriptions.
Read Guide →Metadata Configuration
Configure the metadata.openclaw block with emoji icons, dependencies, environment variables, and installation commands. Ensure cross-environment compatibility.
Read Guide →When to Build Custom Skills
Learn when to build custom skills versus using existing ones. Understand domain-specific needs, specialized behaviors, and integration depth requirements.
Read Guide →Community Examples
Study successful community skills like wine cellar management and PR review automation. Learn patterns for robust implementations and graceful edge case handling.
Read Guide →Testing & Sharing
Best practices for testing skills in isolation, verifying dependency installation, documenting configuration, and sharing with the community following guidelines.
Read Guide →