BlockRunBlockRun

Skills

Skills extend what Claude Code can do. They're like plugins that add specific capabilities.

Available Skills

SkillDescriptionInstall
x-growX post optimizationclaude skill add x-grow
nano-bananaImage generationclaude skill add nano-banana
agent-walletAI agent walletclaude mcp add @blockrun/agent-wallet

What Are Skills?

Skills are prompt-based extensions that teach Claude new workflows. Unlike MCP servers (which provide tools), skills provide instructions and best practices.

MCP Server: Gives Claude new tools to call Skill: Teaches Claude how to use tools effectively

Installing Skills

From BlockRun

# Add x-grow skill
claude skill add x-grow

# Add nano-banana skill
claude skill add nano-banana

Manual Installation

Skills are markdown files in your Claude Code skills directory:

# Find skills directory
ls ~/.claude/skills/

# Add a skill manually
cp my-skill.md ~/.claude/skills/

Using Skills

Skills are invoked with slash commands:

/x-grow draft "AI agents in crypto"
/x-grow review

Or by natural language when Claude recognizes the task:

Help me write a high-performing X post about AI trading

Claude will use the x-grow skill automatically.

Creating Custom Skills

Skills are markdown files with a specific format:

---
name: my-skill
description: What this skill does
triggers:
  - "create a post"
  - "write a tweet"
---

# My Skill

Instructions for Claude on how to perform this task...

## Steps

1. First, do this...
2. Then, do that...
3. Finally, check this...

## Best Practices

- Always do X
- Never do Y

Skill Metadata

FieldRequiredDescription
nameYesSkill identifier
descriptionYesBrief description
triggersNoPhrases that activate the skill

Skill Content

The body of the skill file is instructions for Claude. Write it like you're teaching someone the task.

Skills vs MCP Servers

FeatureSkillsMCP Servers
What they provideInstructionsTools
Written inMarkdownCode (JS/Python)
Installationskill addmcp add
Examplex-growblockrun-mcp

Use skills when: You want to teach Claude a workflow Use MCP when: You need Claude to call external services

Skill + MCP Combinations

Skills often work alongside MCP servers:

SkillUses MCP
x-growblockrun-mcp (for images)
nano-bananablockrun-mcp (for generation)
agent-walletagent-wallet (for trading tools)

Managing Skills

List Installed Skills

claude skill list

Remove a Skill

claude skill remove x-grow

Update a Skill

claude skill update x-grow

Troubleshooting

Skill Not Triggering

Check if the skill is installed:

claude skill list

Try explicit invocation:

/skill-name command

Skill Conflicts

If multiple skills handle similar tasks, use explicit invocation to specify which one.

Skill Not Found

# Reinstall
claude skill remove skill-name
claude skill add skill-name

Links