# Install Skills

Extend your agent's capabilities with skills.

## What Are Skills?

Skills are modular packages that add functionality:

* **Database access** - Query PostgreSQL, MongoDB
* **API integrations** - Connect to external services
* **File operations** - Process CSV, PDF, images
* **Automation** - Web scraping, scheduling
* **Communication** - Email, SMS, notifications

## Accessing Skills

Navigate to **Skills** in the sidebar.

## Skill Registry

Browse available skills at:

* [clawhub.com](https://clawhub.com)
* [skills.sh](https://skills.sh)

## Installing a Skill

### Method 1: Via ClawHub CLI

In agent dashboard or SSH:

```bash
clawhub install <skill-name>
```

Example:

```bash
clawhub install weather
clawhub install postgres
```

### Method 2: Via Skills CLI

```bash
npx skills add <package>
```

Example:

```bash
npx skills add vercel-labs/agent-skills@vercel-react-best-practices
```

### Method 3: Manual Installation

1. Download skill package
2. Extract to `~/.openclaw/skills/`
3. Restart agent

## Managing Installed Skills

### View Installed Skills

Go to **Skills** section:

```
Installed Skills:
├── weather (v1.2.0)
├── postgres (v2.0.1)
└── crypto-price (v0.5.3)
```

### Update Skills

```bash
# Update specific skill
clawhub update <skill-name>

# Update all skills
clawhub update --all
```

### Remove Skills

```bash
clawhub uninstall <skill-name>
```

Or delete from `~/.openclaw/skills/` directory.

## Using Skills

### Skill Discovery

Once installed, skills appear as:

* **New tools** - Agent can invoke
* **New commands** - Available in chat
* **New capabilities** - Extended functionality

### Example: Weather Skill

```
You: What's the weather in Tokyo?
Agent: [Uses weather skill]
       It's 22°C and sunny in Tokyo.
```

### Example: Database Skill

```
You: Query the users table
Agent: [Uses postgres skill]
       Found 1,234 users.
```

## Popular Skills

| Skill            | Purpose                     |
| ---------------- | --------------------------- |
| **weather**      | Get weather forecasts       |
| **postgres**     | Query PostgreSQL databases  |
| **crypto-price** | Check cryptocurrency prices |
| **web-search**   | Search the web              |
| **github**       | GitHub API integration      |
| **slack**        | Slack notifications         |
| **email**        | Send emails                 |

## Creating Custom Skills

### Skill Structure

```
my-skill/
├── SKILL.md          # Documentation
├── manifest.json     # Metadata
└── src/              # Implementation
    └── index.js
```

### Initialize New Skill

```bash
npx skills init my-skill
```

### Publishing

```bash
# To clawhub
clawhub publish ./my-skill --slug my-skill

# To npm/skills.sh
npx skills publish
```

## Skill Configuration

Some skills need configuration:

### Environment Variables

Add to agent config:

```bash
WEATHER_API_KEY=your_key
DATABASE_URL=postgres://...
```

### Skill Settings

Some skills have settings pages in dashboard:

```
Skills → weather → Settings
```

## Troubleshooting

### Skill Not Working

1. Check installation: `clawhub list`
2. Verify configuration
3. Review skill logs
4. Check dependencies

### Permission Errors

Skills may need:

* File system access
* Network access
* API credentials

Grant in agent config if needed.

### Conflicts

Multiple skills may conflict if they:

* Register same commands
* Use conflicting libraries
* Override same functions

Check skill documentation for compatibility.

## Best Practices

✅ **Do**:

* Install skills from trusted sources
* Keep skills updated
* Read skill documentation
* Test in chat after installing

❌ **Don't**:

* Install untrusted skills
* Install duplicate functionality
* Ignore skill dependencies

## Security Considerations

⚠️ **Skills have agent's permissions**:

* Can access agent's tools
* Can make network requests
* Can read environment variables

Only install skills from trusted sources.

## Next Steps

→ [Set Up Cron Jobs](/agos/agos-cloud/agent/cron-jobs.md) for automation


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agos.gitbook.io/agos/agos-cloud/agent/skills.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.