Skills & Tools
Your agent comes with pre-installed skills that extend its capabilities. Skills are documentation files that teach your agent how to use specific tools and APIs.
Pre-installed skills
Section titled “Pre-installed skills”Skills are installed at /opt/skills/ in two directories:
pi-skills
Section titled “pi-skills”Core skills from the pi-mono project:
| Skill | Description |
|---|---|
| beads | Issue tracking with Beads CLI |
| brave-search | Web search via Brave API |
| browser | Browser automation (requires headed environment) |
| google-calendar | Google Calendar CLI (requires setup) |
| google-drive | Google Drive CLI (requires setup) |
| google-mail | Gmail CLI (requires setup) |
tiny-skills
Section titled “tiny-skills”TinyFat platform-specific skills:
| Skill | Description |
|---|---|
| email-outbox | How to send emails via the outbox pattern |
| workspace | Understanding the agent’s filesystem |
Built-in tools
Section titled “Built-in tools”Your agent has access to core tools without any additional setup:
File operations
Section titled “File operations”- Read and write files anywhere in
/data - Create directories
- List directory contents
Shell commands
Section titled “Shell commands”- Run any Linux command via bash
- Access to common utilities (git, curl, jq, etc.)
Code editing
Section titled “Code editing”- Surgical file edits (find and replace)
- Full file rewrites
Container utilities
Section titled “Container utilities”The sandbox container includes these pre-installed tools:
Core:
git— Version controlcurl,wget— HTTP requestsjq,yq— JSON/YAML processingripgrep(rg) — Fast text searchfd-find(fdfind) — Fast file findingtree,less— File browsing
Databases:
sqlite3— SQLite clientpsql— PostgreSQL client
Python:
python3— Python interpreteruv— Fast Python package managerfpdf2— PDF generation (pre-installed)
Developer:
gh— GitHub CLItmux— Terminal multiplexer- Node.js 22 LTS
Adding capabilities
Section titled “Adding capabilities”Install Python packages
Section titled “Install Python packages”uv pip install pandas matplotlibPackages persist in your agent’s storage.
Install Node packages
Section titled “Install Node packages”npm install -g some-packageAPI keys
Section titled “API keys”Some skills require API keys:
| Skill | Key needed | How to add |
|---|---|---|
| Brave Search | BRAVE_API_KEY | Dashboard → Settings → API Keys |
| Google APIs | OAuth setup | Contact support |
Skill loading
Section titled “Skill loading”Your agent automatically has access to skill documentation. When you ask about a capability, the agent reads the relevant skill file to understand how to use it.
Example prompt:
“Search the web for recent news about AI agents”
The agent will:
- Recognize this needs web search
- Load the brave-search skill
- Execute the search
- Return results
PDF generation
Section titled “PDF generation”Your agent can create PDFs using Python’s fpdf2 library:
from fpdf import FPDF
pdf = FPDF()pdf.add_page()pdf.set_font("helvetica", size=12)pdf.cell(200, 10, text="Hello World!", new_x="LMARGIN", new_y="NEXT")pdf.output("/data/output.pdf")The agent can then email you the PDF as an attachment.
Limitations
Section titled “Limitations”No browser automation
Section titled “No browser automation”The sandbox doesn’t have a display server. Browser-based skills (Puppeteer, Playwright) won’t work. Use API-based alternatives like Brave Search or Firecrawl.
No Docker
Section titled “No Docker”Can’t run Docker inside the sandbox (no nested containers).
Limited network
Section titled “Limited network”Outbound HTTP is allowed, but some services may be blocked.
Custom skills
Section titled “Custom skills”Want to add custom skills? Create markdown files in your MEMORY.md with instructions:
## My Custom Tool
When asked to do X, follow these steps:1. ...2. ...The agent will incorporate these instructions into its behavior.
Next steps
Section titled “Next steps”- Agent Workspace — Filesystem layout
- Memory Bank — Organizing knowledge
- Beads Todo System — Issue tracking