Skills

pi beceriler yaratabilir. Kullanım durumunuz için bir tane oluşturmasını isteyin.

Skills, aracının talep üzerine yüklediği bağımsız yetenek paketleridir. Beceri, belirli görevlere yönelik özel iş akışları, kurulum talimatları, yardımcı komut dosyaları ve referans belgeleri sağlar.

Pi Agent Skills standard'ı uygulayarak çoğu ihlal hakkında uyarıda bulunur ancak hoşgörülü davranır. Pi standart izin vermese bile beceri adlarının ana dizinlerinden farklı olmasına izin verir; bu kural, birden fazla aracı sistemi arasında kullanılan paylaşılan beceri dizinleri için optimalin altındadır.

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

Güvenlik: Skills modele herhangi bir eylemi gerçekleştirme talimatı verebilir ve modelin çağırdığı yürütülebilir kodu içerebilir. Kullanmadan önce beceri içeriğini gözden geçirin.

Pi becerileri şunlardan yükler:

• Küresel:
  • ~/.pi/agent/skills/
  • ~/.agents/skills/
• Proje (yalnızca projeye güvenildikten sonra):
  • .pi/skills/
  • cwd ve ata dizinlerinde .agents/skills/ (git repo köküne veya repoda olmadığında dosya sistemi köküne kadar)
• Paketler: skills/ dizinler veya package.json içindeki pi.skills girişler
• Ayarlar: skills dosya veya dizin içeren dizi
• CLI: --skill <path> (tekrarlanabilir, --no-skills ile bile toplanabilir)

Keşif kuralları:

• ~/.pi/agent/skills/ ve .pi/skills/'de, doğrudan kök .md dosyaları bireysel beceriler olarak keşfedilir
• Tüm beceri konumlarında, SKILL.md içeren dizinler yinelemeli olarak keşfedilir
• ~/.agents/skills/ ve .agents/skills/ projesinde kök .md dosyaları göz ardı edilir

--no-skills ile bulmayı devre dışı bırakın (açık --skill yolları hala yükleniyor).

Claude Code veya OpenAI Codex'teki becerileri kullanmak için dizinlerini ayarlara ekleyin:

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

Proje düzeyinde Claude Kodu becerileri için .pi/settings.json'a ekleyin:

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

1. Pi başlangıçta beceri konumlarını tarar ve adları ve açıklamaları çıkarır
2. Sistem istemi, specification uyarınca XML biçiminde mevcut becerileri içerir.
3. Bir görev eşleştiğinde aracı, SKILL.md dosyasının tamamını yüklemek için read tuşunu kullanır (modeller bunu her zaman yapmaz; zorlamak için istemi veya /skill:name tuşunu kullanın)
4. Aracı, komut dosyalarına ve varlıklara referans vermek için ilgili yolları kullanarak talimatları takip eder

Bu aşamalı bir açıklamadır: yalnızca açıklamalar her zaman bağlam içindedir, tüm talimatlar isteğe bağlı olarak yüklenir.

Skills /skill:name komutları olarak kaydolun:

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

Komuttan sonraki argümanlar beceri içeriğine User: <args> olarak eklenir.

Beceri komutlarını etkileşimli modda /settings veya settings.json ile değiştirin:

{
  "enableSkillCommands": true
}

Beceri, SKILL.md dosyasına sahip bir dizindir. Geriye kalan her şey serbest biçimlidir.

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 /yol/giden/beceri && npm kurulum
```

## Usage

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

Beceri dizinindeki göreceli yolları kullanın:

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

Agent Skills specification başına:

• 1-64 karakter
• Yalnızca küçük harfler, sayılar ve kısa çizgiler
• Başta/sonda tire yok
• Ardışık tire yok Pi ismin ana dizinle eşleşmesini gerektirmez. Agent Skills standardı bunu yapar ancak bu gereksinim, birden fazla araç tarafından kullanılan paylaşılan beceri dizinleri için optimalin altındadır.

Geçerli: pdf-processing, data-analysis, code-review Geçersiz: PDF-Processing, -pdf, pdf--processing

Açıklama, aracının beceriyi ne zaman yükleyeceğini belirler. Spesifik olun.

İyi:

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

Fakir:

description: Helps with PDFs.

Pi becerileri Temsilci Skills standardına göre doğrular. Çoğu sorun uyarı verir ancak yine de beceriyi yükler:

• Ad 64 karakteri aşıyor veya geçersiz karakterler içeriyor
• Ad kısa çizgiyle başlıyor/bitiyor veya ardışık kısa çizgiler içeriyor
• Açıklama 1024 karakteri aşıyor

Bilinmeyen ön madde alanları göz ardı edilir.

İstisna: Skills eksik açıklamalarla yüklenmez.

İsim çarpışmaları (farklı konumlardan aynı isim) bulunan ilk beceriyi uyarır ve korur.

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

SKILL.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/to/brave-search && npm kurulum
```

## Search

```bash
./search.js "sorgu" # Temel arama
./search.js "query" --content # Sayfa içeriğini dahil et
```

## Extract Page Content

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

• Anthropic Skills - Belge işleme (docx, pdf, pptx, xlsx), web geliştirme
• Pi Skills - Web araması, tarayıcı otomasyonu, Google API'ler, transkripsiyon