Skills

pi puede crear habilidades. Pídale que cree uno para su caso de uso.

Skills son paquetes de capacidades independientes que el agente carga según demanda. Una habilidad proporciona flujos de trabajo especializados, instrucciones de configuración, scripts de ayuda y documentación de referencia para tareas específicas.

Pi implementa el Agent Skills standard, advirtiendo sobre la mayoría de las violaciones pero siendo indulgente. Pi permite que los nombres de las habilidades difieran de su directorio principal aunque el estándar no lo permita; esa regla no es óptima para directorios de habilidades compartidos utilizados en múltiples arneses de agentes.

• Locations
• How Skills Work
• Skill Commands
• Skill Structure
• Frontmatter
• Validation
• Example
• Skill Repositories

Seguridad: Skills puede indicarle al modelo que realice cualquier acción y puede incluir código ejecutable que invoque el modelo. Revise el contenido de las habilidades antes de usarlas.

Pi carga habilidades de:

• Global:
  • ~/.pi/agent/skills/
  • ~/.agents/skills/
• Proyecto (solo después de que se confíe en el proyecto):
  • .pi/skills/
  • .agents/skills/ en cwd y directorios ancestrales (hasta la raíz del repositorio de git o la raíz del sistema de archivos cuando no está en un repositorio)
• Paquetes: skills/ directorios o pi.skills entradas en package.json
• Configuraciones: skills matriz con archivos o directorios
• CLI: --skill <path> (repetible, aditivo incluso con --no-skills)

Reglas de descubrimiento:

• En ~/.pi/agent/skills/ y .pi/skills/, los archivos raíz directos .md se descubren como habilidades individuales
• En todas las ubicaciones de habilidades, los directorios que contienen SKILL.md se descubren de forma recursiva
• En ~/.agents/skills/ y el proyecto .agents/skills/, los archivos raíz .md se ignoran

Deshabilite el descubrimiento con --no-skills (las rutas explícitas --skill aún se cargan).

Para utilizar habilidades de Claude Code u OpenAI Codex, agregue sus directorios a la configuración:

{
  "skills": [
    "~/.claude/skills",
    "~/.codex/skills"
  ]
}

Para conocer las habilidades de Claude Code a nivel de proyecto, agregue a .pi/settings.json:

{
  "skills": ["../.claude/skills"]
}

1. Al inicio, pi escanea ubicaciones de habilidades y extrae nombres y descripciones.
2. El indicador del sistema incluye habilidades disponibles en formato XML según specification
3. Cuando una tarea coincide, el agente usa read para cargar el SKILL.md completo (los modelos no siempre hacen esto; use indicaciones o /skill:name para forzarlo)
4. El agente sigue las instrucciones y utiliza rutas relativas para hacer referencia a scripts y activos.

Esta es una divulgación progresiva: solo las descripciones están siempre en contexto, las instrucciones completas se cargan a pedido.

Skills registrarse como /skill:name comandos:

/skill:brave-search           # Load and execute the skill
/skill:pdf-tools extract      # Load skill with arguments

Los argumentos después del comando se agregan al contenido de la habilidad como User: <args>.

Alternar comandos de habilidad a través de /settings en modo interactivo o en settings.json:

{
  "enableSkillCommands": true
}

Una habilidad es un directorio con un archivo SKILL.md. Todo lo demás es de forma libre.

my-skill/
├── SKILL.md              # Required: frontmatter + instructions
├── scripts/              # Helper scripts
│   └── process.sh
├── references/           # Detailed docs loaded on-demand
│   └── api-reference.md
└── assets/
    └── template.json

---
name: my-skill
description: What this skill does and when to use it. Be specific.
---

# My Skill

## Setup

Run once before first use:
```bash
cd /ruta/a/skill && npm instalar
```

## Usage

```bash
./scripts/process.sh <input>
```

Utilice rutas relativas del directorio de habilidades:

See [the reference guide](references/REFERENCE.md) for details.

Según el Agent Skills specification:

• 1-64 caracteres
• Letras minúsculas, números y guiones únicamente.
• Sin guiones iniciales o finales
• Sin guiones consecutivos Pi no requiere que el nombre coincida con el directorio principal. El estándar Agente Skills sí lo hace, pero ese requisito no es óptimo para directorios de habilidades compartidos utilizados por múltiples herramientas.

Válido: pdf-processing, data-analysis, code-review No válido: PDF-Processing, -pdf, pdf--processing

La descripción determina cuándo el agente carga la habilidad. Sea específico.

Bien:

description: Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents.

Pobre:

description: Helps with PDFs.

Pi valida las habilidades según el estándar del Agente Skills. La mayoría de los problemas generan advertencias pero aún cargan la habilidad:

• El nombre supera los 64 caracteres o contiene caracteres no válidos
• El nombre comienza/termina con guión o tiene guiones consecutivos
• La descripción supera los 1024 caracteres.

Los campos desconocidos se ignoran.

Excepción: Skills a los que les falta una descripción no se cargan.

Las colisiones de nombres (el mismo nombre en diferentes ubicaciones) advierten y mantienen la primera habilidad encontrada.

brave-search/
├── SKILL.md
├── search.js
└── content.js

HABILIDAD.md:

---
name: brave-search
description: Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content.
---

# Brave Search

## Setup

```bash
cd /ruta/a/brave-search && npm instalar
```

## Search

```bash
./search.js "consulta" # Búsqueda básica
./search.js "query" --content # Incluir contenido de la página
```

## Extract Page Content

```bash
./content.js https://ejemplo.com
```

• Anthropic Skills - Procesamiento de documentos (docx, pdf, pptx, xlsx), desarrollo web
• Pi Skills - Búsqueda web, automatización del navegador, Google APIs, transcripción