# picoclaw-ai-assistant

Get guidance for installing PicoClaw, configuring an LLM provider and running it on a Linux device or with Docker Compose.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/picoclaw-ai-assistant/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/picoclaw-ai-assistant

## What it does

This skill walks through using a release binary, compiling PicoClaw from source, or launching it with Docker Compose. For initial setup, `picoclaw onboard` creates a configuration file and workspace; model settings go in `~/.picoclaw/config.json`.

Choose a provider using the `openai/`, `anthropic/` or `volcengine/` prefix, then set the model and its API credentials. Tavily and Brave Search are available as optional web-search integrations. You need an API key for the LLM provider you choose, and web search also needs its own key. The configuration can read keys from environment variables instead of storing them directly.

The guide covers builds for ARM, MIPS and RISC-V, interactive chat, and single-message runs. Docker Compose includes gateway, web-console and one-shot agent modes. Building from source uses the project’s Go build targets, including `make deps` and `make build`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill picoclaw-ai-assistant -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/picoclaw-ai-assistant/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/picoclaw-ai-assistant/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill picoclaw-ai-assistant -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/picoclaw-ai-assistant/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill picoclaw-ai-assistant -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/picoclaw-ai-assistant/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills picoclaw-ai-assistant
```

2. **Manually: put the files in place**
- File: `.github/skills/picoclaw-ai-assistant/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill picoclaw-ai-assistant -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/picoclaw-ai-assistant
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/picoclaw-ai-assistant/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill picoclaw-ai-assistant -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/picoclaw-ai-assistant/SKILL.md

## When to use it
- install PicoClaw from a release binary
- compile PicoClaw for a Raspberry Pi
- set a model and API credentials in the config
- enable Tavily or Brave Search
- run the agent with Docker Compose

## Example prompts
- Show me how to install PicoClaw on a Raspberry Pi and initialize it.
- Configure `~/.picoclaw/config.json` for Anthropic and explain how to supply the API key.
- Explain how to enable Tavily search and start PicoClaw with Docker Compose.

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [frontend-design](https://affpapa.org/en/nevibecode/skills/frontend-design.md) — skill · 1025790 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 139 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md