Skills

pi dapat menciptakan keterampilan. Mintalah untuk membuat satu untuk kasus penggunaan Anda.

Skills adalah paket kemampuan mandiri yang dimuat agen sesuai permintaan. Keterampilan menyediakan alur kerja khusus, instruksi pengaturan, skrip pembantu, dan dokumentasi referensi untuk tugas tertentu.

Pi menerapkan Agent Skills standard, memperingatkan tentang sebagian besar pelanggaran namun tetap bersikap lunak. Pi memperbolehkan nama keterampilan berbeda dari direktori induknya meskipun standar tidak mengizinkannya; aturan tersebut kurang optimal untuk direktori keterampilan bersama yang digunakan di beberapa kelompok agen.

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

Keamanan: Skills dapat memerintahkan model untuk melakukan tindakan apa pun dan mungkin menyertakan kode yang dapat dieksekusi yang dipanggil model. Tinjau konten keterampilan sebelum digunakan.

Pi memuat keterampilan dari:

• Global:
  • ~/.pi/agent/skills/
  • ~/.agents/skills/
• Proyek (hanya setelah proyek dipercaya):
  • .pi/skills/
  • .agents/skills/ di cwd dan direktori leluhur (hingga git repo root, atau root sistem file jika tidak ada dalam repo)
• Paket: skills/ direktori atau pi.skills entri di package.json
• Pengaturan: skills array dengan file atau direktori
• CLI: --skill <path> (dapat diulang, bahkan ditambah dengan --no-skills)

Aturan penemuan:

• Dalam ~/.pi/agent/skills/ dan .pi/skills/, file root langsung .md ditemukan sebagai keterampilan individu
• Di semua lokasi keterampilan, direktori yang berisi SKILL.md ditemukan secara rekursif
• Di ~/.agents/skills/ dan proyek .agents/skills/, file root .md diabaikan

Nonaktifkan penemuan dengan --no-skills (jalur eksplisit --skill masih dimuat).

Untuk menggunakan keterampilan dari Claude Code atau OpenAI Codex, tambahkan direktorinya ke pengaturan:

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

Untuk skill Claude Code tingkat proyek, tambahkan ke .pi/settings.json:

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

1. Saat startup, pi memindai lokasi keterampilan dan mengekstrak nama dan deskripsi
2. Perintah sistem mencakup keterampilan yang tersedia dalam format XML per specification
3. Ketika tugas cocok, agen menggunakan read untuk memuat SKILL.md lengkap (model tidak selalu melakukan ini; gunakan perintah atau /skill:name untuk memaksanya)
4. Agen mengikuti instruksi, menggunakan jalur relatif ke skrip referensi dan aset

Ini adalah pengungkapan progresif: hanya deskripsi yang selalu sesuai konteks, instruksi lengkap dimuat sesuai permintaan.

Skills mendaftar sebagai perintah /skill:name:

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

Argumen setelah perintah ditambahkan ke konten keterampilan sebagai User: <args>.

Alihkan perintah keterampilan melalui /settings dalam mode interaktif atau di settings.json:

{
  "enableSkillCommands": true
}

Keterampilan adalah direktori dengan file SKILL.md. Segala sesuatu yang lain berbentuk bebas.

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 /path/ke/skill && npm instal
```

## Usage

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

Gunakan jalur relatif dari direktori keterampilan:

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

Berdasarkan Agent Skills specification:

• 1-64 karakter
• Huruf kecil, angka, tanda hubung saja
• Tidak ada tanda hubung awal/akhir
• Tidak ada tanda hubung berturut-turut Pi tidak memerlukan nama yang cocok dengan direktori induk. Standar Agen Skills dapat melakukannya, namun persyaratan tersebut kurang optimal untuk direktori keterampilan bersama yang digunakan oleh banyak alat.

Sah: pdf-processing, data-analysis, code-review Tidak valid: PDF-Processing, -pdf, pdf--processing

Deskripsi menentukan kapan agen memuat keterampilannya. Bersikaplah spesifik.

Bagus:

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

Miskin:

description: Helps with PDFs.

Pi memvalidasi keterampilan terhadap standar Agen Skills. Sebagian besar masalah menghasilkan peringatan tetapi masih memuat keterampilan:

• Nama melebihi 64 karakter atau mengandung karakter tidak valid
• Nama dimulai/diakhiri dengan tanda hubung atau memiliki tanda hubung yang berurutan
• Deskripsi melebihi 1024 karakter

Bidang frontmatter yang tidak diketahui akan diabaikan.

Pengecualian: Skills dengan deskripsi yang hilang tidak dimuat.

Tabrakan nama (nama yang sama dari lokasi berbeda) memperingatkan dan menjaga agar keterampilan pertama tetap ditemukan.

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

** KETERAMPILAN.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 /path/ke/brave-search && npm instal
```

## Search

```bash
./search.js "query" # Pencarian dasar
./search.js "query" --content # Sertakan konten halaman
```

## Extract Page Content

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

• Anthropic Skills - Pemrosesan dokumen (docx, pdf, pptx, xlsx), pengembangan web
• Pi Skills - Pencarian web, otomatisasi browser, Google APIs, transkripsi