OpenClaw Skills
    openclaw
    install
    skills

    How to Install Skills in OpenClaw

    Three ways to add SKILL.md skills to OpenClaw — download from Agensi, clone from GitHub, or use MCP. Step-by-step installation guide.

    April 23, 20265 min read
    Share:

    How to Install Skills in OpenClaw

    A skill is a set of instructions packaged as a SKILL.md file that an AI agent reads to learn a new workflow. OpenClaw uses the same SKILL.md standard as Claude Code, so installation follows the same pattern with slightly different paths.

    Quick Answer: Download a skill zip from Agensi, unzip to ~/.openclaw/skills/, and start a new session. OpenClaw loads skills automatically. For project-level skills, use .openclaw/skills/ in your repo root.

    What do I need before installing skills?

    Make sure OpenClaw is installed and working. Open your terminal and verify:

    openclaw --version
    

    If you get a version number, you're ready. You also need a skills directory. OpenClaw creates ~/.openclaw/skills/ automatically on first run, but you can create it manually:

    mkdir -p ~/.openclaw/skills
    

    How do I install skills from Agensi?

    The fastest method. Go to agensi.io/skills, find a skill, and download it. You get a zip file.

    # Unzip to your skills directory
    unzip code-reviewer.zip -d ~/.openclaw/skills/
    
    # Verify the file structure
    ls ~/.openclaw/skills/code-reviewer/
    # Should show: SKILL.md (and optionally scripts/, references/)
    

    Start a new OpenClaw session. The skill loads automatically based on its description. You can verify it loaded by asking OpenClaw to list available skills.

    How do I install skills from GitHub?

    Search GitHub for SKILL.md files or browse repositories that publish skills:

    # Clone the repo
    git clone https://github.com/username/my-skill.git
    
    # Copy the skill folder to your skills directory
    cp -r my-skill ~/.openclaw/skills/
    

    Make sure the SKILL.md file is at ~/.openclaw/skills/my-skill/SKILL.md, not nested deeper. A common mistake is ending up with ~/.openclaw/skills/my-skill/my-skill/SKILL.md — that won't work.

    Always read the SKILL.md before installing GitHub-sourced skills. Unlike Agensi marketplace skills, GitHub skills aren't security-scanned.

    How do I use MCP to load skills on demand?

    With Agensi Pro, your OpenClaw agent accesses the full skill catalog via MCP. No downloads, no folder management. Skills load on demand when your agent needs them.

    Skip file management entirely.

    Agensi Pro gives your agent direct MCP access to every skill. No folders, no zips, no storage questions.

    Start 3-day free trial →

    $9/mo after trial. Card required. Cancel anytime.

    How do I share skills with my team?

    Put skills in .openclaw/skills/ at the root of your project repository and commit them to git. Everyone who clones the repo gets the skills automatically.

    your-project/
    ├── .openclaw/
    │   └── skills/
    │       ├── code-reviewer/
    │       │   └── SKILL.md
    │       └── test-generator/
    │           └── SKILL.md
    ├── src/
    └── package.json
    

    Project-level skills override personal skills if they share the same name. This lets teams enforce specific workflows without affecting developers' personal skill setups.

    What are the most common installation mistakes?

    Double-nested folders. After unzipping, check that the path is ~/.openclaw/skills/skill-name/SKILL.md, not ~/.openclaw/skills/skill-name/skill-name/SKILL.md.

    Missing SKILL.md file. A folder without SKILL.md inside it is ignored. The file must be named exactly SKILL.md (case-sensitive on Linux/Mac).

    Wrong directory. OpenClaw uses ~/.openclaw/skills/, not ~/.claude/skills/. If you're switching between agents, double-check the path. Both agents use the same SKILL.md format, but they read from different directories.

    Not starting a new session. Skills load at session startup. If you install a skill mid-session, it won't be available until you start a new one.

    Can I use the same skills in Claude Code?

    Yes. SKILL.md is a cross-agent standard. The same skill file works in OpenClaw, Claude Code, Codex CLI, Cursor, and Gemini CLI. Just copy it to the appropriate skills directory for each agent:

    • OpenClaw: ~/.openclaw/skills/
    • Claude Code: ~/.claude/skills/
    • Codex CLI: ~/.codex/skills/
    • Cursor: .cursor/skills/ (project-level only)

    For a full path reference, read Where Are Claude Skills Stored?.


    Find and install security-scanned skills for OpenClaw, Claude Code, and more on Agensi.

    Find the right skill for your workflow

    Browse our marketplace of AI agent skills, ready to install in seconds.

    Browse Skills

    Related Articles