A Practical Guide to Extending Your AI Agent — From One-Command Installs to Custom Capabilities

By James Tipton & Chief Wizard  |  Category: AI Engineering

What Are Skills?

An OpenClaw skill is a set of instructions that teaches your agent how to do something specific — call an API, run a calculation, interact with a service, or follow a specialized workflow. Skills live as markdown files in your workspace and get loaded into the agent's context at the start of each session.

Think of skills as job training. Your agent is intelligent but generalist out of the box. Skills make it a specialist. Without skills, it answers questions. With the right skills, it books calendar appointments, reads your emails, runs astrological calculations, monitors crypto prices, and posts to social media — all autonomously.

Every skill is just a SKILL.md file with instructions. No compiled code, no plugins to install, no compatibility issues. If your agent can read it, it can follow it.

Two Ways to Add Skills

Path 1 — ClawHub (The Marketplace)

ClawHub is OpenClaw's official skill marketplace at clawhub.ai. It hosts over 13,700 community-built skills as of early 2026. Think of it as npm for AI agent capabilities — browse, search, install in one command.

openclaw skills install <skill-slug>

Skills cover everything from productivity integrations to research tools to platform-specific automations.

Path 2 — Build Your Own

For capabilities specific to your use case — a custom astrology engine, your company's internal tools, a proprietary data source — you write the skill yourself. It's simpler than it sounds: create a markdown file with clear instructions for your agent, drop it in the workspace, and it's live on the next session.

ClawHub: What to Install and What to Skip

With 13,000+ skills the challenge isn't finding something — it's finding something worth installing. Here are the categories that deliver real value:

How to Search and Install

Use natural language search — ClawHub's vector search understands intent:

clawhub search "schedule twitter posts automatically"
clawhub search "read gmail and summarize"
clawhub search "crypto price alerts telegram"

Once you find a skill:

openclaw skills install author/skill-name

Skills load at the start of the next session — restart your gateway after installing.

Security: What You Must Know Before Installing Anything

This is not optional reading. ClawHub is an open registry — anyone with a GitHub account over one week old can publish skills. In early 2026, a coordinated attack called ClawHavoc distributed hundreds of malicious skills through the registry. These skills established reverse shells and quietly stole SSH keys, API tokens, and browser session cookies.

After installing, inspect the downloaded files:

ls ~/.openclaw/workspace/skills/
cat ~/.openclaw/workspace/skills/skill-name/SKILL.md

If a skill asks for permissions or access that don't match its stated purpose — delete it.

Building Custom Skills: The Better Path for Unique Capabilities

For anything specific to your use case, building your own skill is often faster and safer than hunting ClawHub for something that almost fits.

The anatomy of every skill is the same: a SKILL.md file with a frontmatter header and instructions in plain English. Your agent reads it and follows it.

The Skill File Structure

Where Skills Live

~/.openclaw/workspace/skills/your-skill-name/SKILL.md

Create the directory and file:

mkdir -p ~/.openclaw/workspace/skills/your-skill-name
nano ~/.openclaw/workspace/skills/your-skill-name/SKILL.md

No restart needed if you're starting a fresh session. The skill is live immediately on next conversation start.

10 High-Value Skills Worth Building

These are capabilities that either don't exist on ClawHub yet, require personalization, or are better built yourself for security reasons:

A Real Custom Skill: Astrology Engine

Here's the actual skill we built for Chief Wizard — a working natal chart calculator using Swiss Ephemeris that computes real planetary positions in both Western and Vedic traditions. This is what a production custom skill looks like:

---
name: astrology
description: Precise natal chart calculations using Swiss 
Ephemeris — Western tropical and Vedic sidereal traditions
version: 1.0.0
---
 
# Astrology Skill
 
You have access to a precise astronomical calculation engine 
that computes real planetary positions using Swiss Ephemeris.
 
## How to generate a chart
 
Run this command via your bash tool:
 
cd ~/openclaw_astro && source astroenv/bin/activate && 
echo '{"year":YYYY,"month":MM,"day":DD,"hour":HH.H,
"lat":LAT,"lon":LON,"system":"both"}' | python3 astro_tool.py
 
## Important notes
 
- Times must be in UTC
- Western uses tropical zodiac with Placidus houses
- Vedic uses sidereal zodiac with Lahiri ayanamsa
- Always ask for birth city if location not provided

Twenty lines of markdown. That's all it takes to give your agent a completely new capability backed by real astronomical calculations.

ClawHub vs Custom: When to Use Which

Five Rules for Writing Effective Skills

Be specific about triggers. Tell your agent exactly when to use the skill. "Use this skill whenever someone asks for a natal chart, birth chart, or planetary positions" leaves no ambiguity. Vague triggers lead to inconsistent behavior.

Include failure handling. What should your agent do when the API is down? When the user provides incomplete information? When the calculation returns an error? Skills without failure instructions produce confusing responses.

Define the output format. If you want structured output, say so explicitly. "Return results as a numbered list with planet name, sign, and degree" produces consistent, parseable output. "Tell the user the results" produces whatever the model feels like.

Keep skills focused. One skill, one capability. Don't try to build a skill that does five different things. Focused skills are easier to maintain, debug, and improve.

Test with edge cases. After writing a skill, immediately test it with incomplete input, wrong formats, and unusual requests. Skills that only work on the happy path aren't production-ready.

Resources

• ClawHub marketplace: clawhub.ai
• OpenClaw skills docs: docs.openclaw.ai/tools/skills
• Community skills list: github.com/VoltAgent/awesome-openclaw-skills
• OpenClaw GitHub: github.com/openclaw/openclaw

Power Your AI Business

Two tools we actually use — one for infrastructure, one for the builder behind the bot.

Keywords: OpenClaw skills, ClawHub marketplace, OpenClaw skill tutorial, how to add skills OpenClaw, custom OpenClaw skill, OpenClaw astrology skill, ClawHub install, OpenClaw SKILL.md, AI agent skills 2026, OpenClaw workspace skills