Skills

pi có thể tạo ra các kỹ năng. Yêu cầu nó xây dựng một cái cho trường hợp sử dụng của bạn.

Skills là các gói khả năng độc lập mà tác nhân tải theo yêu cầu. Kỹ năng cung cấp các quy trình làm việc chuyên biệt, hướng dẫn thiết lập, tập lệnh trợ giúp và tài liệu tham khảo cho các tác vụ cụ thể.

Pi thực hiện Agent Skills standard, cảnh báo về hầu hết các hành vi vi phạm nhưng vẫn được khoan dung. Pi cho phép tên kỹ năng khác với thư mục gốc của chúng mặc dù tiêu chuẩn không cho phép điều đó; quy tắc đó là chưa tối ưu cho các thư mục kỹ năng dùng chung được sử dụng trên nhiều cơ chế khai thác tác nhân.

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

Bảo mật: Skills có thể hướng dẫn mô hình thực hiện bất kỳ hành động nào và có thể bao gồm mã thực thi mà mô hình gọi ra. Xem lại nội dung kỹ năng trước khi sử dụng.

Pi tải kỹ năng từ:

• Toàn cầu:
  • ~/.pi/agent/skills/
  • ~/.agents/skills/
• Dự án (chỉ sau khi dự án được tin cậy):
  • .pi/skills/
  • .agents/skills/ trong cwd và các thư mục tổ tiên (tối đa git repo root hoặc root hệ thống tập tin khi không có trong repo)
• Các gói: skills/ thư mục hoặc pi.skills mục trong package.json
• Cài đặt: mảng skills với các tệp hoặc thư mục
• CLI: --skill <path> (có thể lặp lại, cộng ngay cả với --no-skills)

Quy luật khám phá:

• Trong ~/.pi/agent/skills/ và .pi/skills/, các tệp gốc trực tiếp .md được phát hiện dưới dạng các kỹ năng riêng lẻ
• Ở tất cả các vị trí kỹ năng, các thư mục chứa SKILL.md được phát hiện theo cách đệ quy
• Trong ~/.agents/skills/ và dự án .agents/skills/, các tệp gốc .md bị bỏ qua

Tắt tính năng phát hiện bằng --no-skills (đường dẫn --skill rõ ràng vẫn tải).

Để sử dụng các kỹ năng từ Claude Code hoặc OpenAI Codex, hãy thêm thư mục của chúng vào cài đặt:

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

Đối với các kỹ năng Mã Claude cấp dự án, hãy thêm vào .pi/settings.json:

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

1. Khi khởi động, pi quét các vị trí kỹ năng và trích xuất tên cũng như mô tả
2. Lời nhắc hệ thống bao gồm các kỹ năng có sẵn ở định dạng XML theo specification
3. Khi một nhiệm vụ phù hợp, tác nhân sử dụng read để tải toàn bộ SKILL.md (các mô hình không phải lúc nào cũng thực hiện việc này; hãy sử dụng lời nhắc hoặc /skill:name để ép buộc)
4. Tác nhân làm theo hướng dẫn, sử dụng đường dẫn tương đối để tham chiếu tập lệnh và nội dung

Đây là sự tiết lộ tiến bộ: chỉ các mô tả luôn nằm trong ngữ cảnh, các hướng dẫn đầy đủ được tải theo yêu cầu.

Skills đăng ký dưới dạng lệnh /skill:name:

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

Các đối số sau lệnh được thêm vào nội dung kỹ năng dưới dạng User: <args>.

Chuyển đổi các lệnh kỹ năng qua /settings ở chế độ tương tác hoặc trong settings.json:

{
  "enableSkillCommands": true
}

Kỹ năng là một thư mục có tệp SKILL.md. Mọi thứ khác đều ở dạng tự do.

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/to/skill && npm cài đặt
```

## Usage

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

Sử dụng đường dẫn tương đối từ thư mục kỹ năng:

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

Theo Agent Skills specification:

• 1-64 ký tự
• Chỉ chữ cái viết thường, số, dấu gạch nối
• Không có dấu gạch nối đầu/cuối
• Không có dấu gạch nối liên tiếp Pi không yêu cầu tên phải khớp với thư mục mẹ. Tiêu chuẩn Tác nhân Skills có, nhưng yêu cầu đó chưa tối ưu cho các thư mục kỹ năng dùng chung được nhiều công cụ sử dụng.

Hợp lệ: pdf-processing, data-analysis, code-review Không hợp lệ: PDF-Processing, -pdf, pdf--processing

Mô tả xác định thời điểm tác nhân tải kỹ năng. Hãy cụ thể.

Tốt:

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

Nghèo:

description: Helps with PDFs.

Pi xác nhận các kỹ năng theo tiêu chuẩn của Đại lý Skills. Hầu hết các vấn đề đều đưa ra cảnh báo nhưng vẫn tải kỹ năng:

• Tên vượt quá 64 ký tự hoặc chứa ký tự không hợp lệ
• Tên bắt đầu/kết thúc bằng dấu gạch nối hoặc có dấu gạch nối liên tiếp
• Mô tả vượt quá 1024 ký tự

Các trường vật chất phía trước không xác định sẽ bị bỏ qua.

Ngoại lệ: Skills thiếu mô tả sẽ không được tải.

Va chạm tên (cùng tên từ các vị trí khác nhau) cảnh báo và giữ kỹ năng đầu tiên được tìm thấy.

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

KỸ NĂNG.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 cài đặt
```

## Search

```bash
./search.js "truy vấn" # Tìm kiếm cơ bản
./search.js "query" --content # Bao gồm nội dung trang
```

## Extract Page Content

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

• Anthropic Skills - Xử lý tài liệu (docx, pdf, pptx, xlsx), phát triển web
• Pi Skills - Tìm kiếm trên web, tự động hóa trình duyệt, Google APIs, phiên âm