PDF4me Keterampilan Agen: Memulai
PDF4me Keterampilan Agen adalah paket keterampilan yang dapat diinstal dari publik. pdf4me-skills repositori pada GitHubMereka mengajar AI asisten pengkodean cara menggunakan PDF4me REST API: titik akhir yang benar, bentuk muatan, header otentikasi, dan perutean fitur di seluruh konversi, penggabungan, pemisahan, OCR, ekstrak, hasilkan, Excel, Word, citra, bentuk, dan operasi keamanan.
Ini adalah pisahkan permukaan produk dari PDF4me MCP. MCP menghubungkan ke server alat langsung (uvx pdf4me-mcp) sehingga klien dapat memanggil PDF4me Tindakan sebagai alat bantu selama obrolan. Beban Keterampilan Agen terstruktur API panduan ke dalam agen agar dapat menulis dan menjalankan REST API Kode dengan benar.
| PDF4me Keterampilan Agen | PDF4me MCP | |
|---|---|---|
| Apa itu | Paket keterampilan dengan API aturan referensi dan perutean | MCP server yang mengekspos PDF4me sebagai alat yang dapat dipanggil |
| Memasang | npx skills add … atau Claude Code /plugin perintah | uvx pdf4me-mcp di klien MCP konfigurasi |
| Terbaik untuk | Agen yang menulis skrip, curl, atau kode aplikasi terhadap REST API | Agen yang memanggil alat secara langsung dari obrolan UI |
| Repositori | github.com/pdf4me/pdf4me-skills | github.com/pdf4me/pdf4me-mcp |
Prasyarat
- A PDF4me akun dan API kunci
- Akses ke PDF4me REST API pada
https://api.pdf4me.com - Satu mendukung AI klien (lihat jalur instalasi di bawah)
Kapal apa saja yang ada di repositori?
Keterampilan pertama yang dipublikasikan adalah pdf4me-apiHal ini mengikuti Keterampilan Agen format:
| Jalur | Tujuan |
|---|---|
skills/pdf4me-api/SKILL.md | Kemampuan terwujud, kapan harus menggunakannya, dan API perutean kategori |
skills/pdf4me-api/references/ | Catatan titik akhir dikelompokkan berdasarkan fitur (konversi, edit, ekstrak, hasilkan, …) |
skills/pdf4me-api/examples/ | Contoh skrip sederhana untuk alur kerja umum. |
Ketika pengguna meminta untuk mengkonversi PDFgabungkan file, jalankan OCR, isi formulir, atau hubungi siapa saja PDF4me Pada titik akhir, agen harus memuat keterampilan ini dan mengikuti file referensi untuk kategori yang sesuai.
Pilih jalur instalasi Anda
- Claude Code (plugin marketplace)
- npx skills (Cursor, Copilot, Codex, …)
Gunakan jalur ini saat Anda bekerja di Claude Code (berbasis terminal) Claude agen pengkodean). Instalasi menggunakan Claudeperintah plugin bawaan, bukan npx skills.
Langkah 1: Tambahkan PDF4me pasar keterampilan
Di direktori proyek Anda, jalankan:
/plugin marketplace add pdf4me/pdf4me-skills

Tambahkan marketplace pdf4me-skills dari GitHub.
Setelah pendaftaran marketplace berhasil, Claude Code menegaskan:
Successfully added marketplace: pdf4me-skills

Konfirmasi bahwa marketplace telah ditambahkan.
Langkah 2: Instal plugin pdf4me-api
Mulai perintah instalasi. Anda dapat mengetik /plugin install pdf lalu pilih yang cocok dari fitur pelengkapan otomatis:
/plugin install pdf4me-api@pdf4me-skills

Pilih pdf4me-api@pdf4me-skills dari daftar plugin.
Claude Code Menampilkan detail plugin dan meminta lingkup instalasi:
- Instalasi untuk Anda (cakupan pengguna): tersedia di semua proyek Anda
- Instal untuk semua kolaborator di repositori ini (lingkup proyek): dibagikan melalui konfigurasi repo
- Instalasi untuk Anda, hanya di repositori ini (cakupan lokal)hanya kasir ini
Pilih cakupan yang sesuai dengan cara kerja Anda. Untuk lingkungan uji coba pribadi, lingkup lokal atau lingkup pengguna adalah hal yang umum.

Pilih cakupan pengguna, proyek, atau instalasi lokal.
Langkah 3: Muat ulang plugin
Setelah instalasi selesai:
✓ Installed pdf4me-skills. Run /reload-plugins to apply.
Berlari:
/reload-plugins

Muat ulang plugin agar Claude Code dapat menggunakan skill baru tersebut.
Skill tersebut kini aktif di Claude Code untuk lingkup ini.
Gunakan jalur ini untuk Cursor, GitHub Copilot, OpenAI Codex, Cline, Gemini CLI, Windsurf, Zed, Dan 70+ agen lainnya didukung oleh skills CLI.
Langkah 1: Jalankan perintah instalasi
Dari direktori proyek Anda:
npx skills add https://github.com/pdf4me/pdf4me-skills.git --skill pdf4me-api

Satu perintah mengkloning repositori dan memulai penginstal interaktif.
Yang CLI klon pdf4me-keterampilan, menemukan pdf4me-api keterampilan, dan membuka pemilih agen.
Langkah 2: Pilih agen target
Agen universal (Misalnya Cursor, Cline, Codex, GitHub Copilot, Gemini CLI, Warp, Zed) dipilih terlebih dahulu menjadi .agents/skillsGunakan daftar yang dapat dicari untuk menambah atau menghapus agen seperti Claude Code, OpenClaw, atau IBM Bob.

Pilih setiap agen yang Anda gunakan setiap hari.
Menggunakan Ruang angkasa untuk mengaktifkan/menonaktifkan agen, ↑↓ untuk bergerak, Memasuki untuk mengkonfirmasi.
Langkah 3: Pilih cakupan instalasi
| Cakupan | Kapan harus digunakan? |
|---|---|
| Proyek | Skill tersebut ada di repositori saat ini (misalnya, .agents/skills/pdf4me-api) dan dapat berkomitmen untuk tim Anda |
| Global | Skill tersebut akan terpasang untuk akun pengguna Anda di semua proyek. |

Lingkup proyek menjaga agar keahlian tetap berada dalam repositori Anda.
Langkah 4: Pilih metode instalasi
| Metode | Perilaku |
|---|---|
| Tautan simbolis (Disarankan) | Satu sumber kebenaran di bawah .agents/skills; mudah diperbarui |
| Salinan ini dikirim ke semua agen. | Menduplikasi file ke dalam folder keterampilan setiap agen. |

Symlink adalah opsi default yang direkomendasikan.
Langkah 5: Konfirmasi dan selesaikan
Tinjau ringkasan (jalur instalasi, agen universal, symlink untuk Claude Code (jika terpilih), konfirmasi Ya, dan tunggu Instalasi selesai.

Skill tersebut dirancang khusus untuk proyek Anda dan terhubung dengan setiap agen yang dipilih.
Program penginstal mengingatkan Anda untuk meninjau keterampilan sebelum digunakan karena keterampilan tersebut dijalankan dengan izin agen penuh.
Langkah 6: Verifikasi di agen Anda
Buka aplikasi agen Anda dan mulailah mengetik PDF-permintaan terkait. Misalnya, dalam OpenAI Codex, mengetik pdf permukaan pdf4me-api [Skill] saran dengan deskripsi keterampilan.

Codex mengenali skill pdf4me-api yang terpasang.
Tekan Memasuki Untuk memasukkan konteks keterampilan, kemudian jelaskan tugas Anda (misalnya, "konversikan ini DOCX ke PDF menggunakan PDF4me").
Berikan milik Anda API kunci agen
Dokumen keterampilan Bagaimana untuk mengautentikasi (Authorization: Basic <your_api_key>) tetapi tidak menyimpan rahasia. Saat agen menghasilkan kode atau perintah curl, berikan kunci Anda dengan aman:
- Ekspor
PDF4ME_API_KEY(atau tempelkan kuncinya saat agen meminta konfigurasi runtime) - Jangan pernah berkomitmen API kunci untuk git
Melihat Terhubung ke PDF4me V2 API untuk format otorisasi dan permintaan lengkap.
Contoh pesan yang muncul setelah instalasi
Setelah skill terpasang, coba perintah seperti:
- "Menggunakan PDF4me untuk menggabungkan keduanya PDFs dan mengembalikan output base64."
- "Konversikan ini" Word templat untuk PDF dengan endpoint pembuatan dokumen."
- "Ekstrak data tabel dari ini" PDF dengan PDF4me."
- "Yang PDF4me Endpoint apa yang harus saya gunakan untuk menambahkan? QR Code ke sebuah PDF?"
Agen harus memuat pdf4me-api, pilih file referensi yang tepat (misalnya references/merge-split.md atau references/barcode.md), dan menghasilkan yang valid REST panggilan.
Penyelesaian Masalah
Skill tersebut tidak muncul di agen saya.
- Claude Code: Berlari
/reload-pluginsSetelah instalasi. Konfirmasikan bahwa Anda telah memilih cakupan yang benar (pengguna, proyek, atau lokal). - Keterampilan npx: Jalankan kembali perintah instalasi dan verifikasi apakah agen Anda telah dipilih. Periksa bahwa
.agents/skills/pdf4me-api/SKILL.mdada di proyek Anda. - Mulai ulang IDE atau sesi agen setelah instalasi pertama.
Claude Code vs npx skills: mana yang sebaiknya saya gunakan?
- Claude Code hanya: Gunakan
/plugin marketplacejalur di Claude Code tab di atas. - Cursor, Copilot, Codex, Cline, atau beberapa agen: Menggunakan
npx skills add …bahkan jika Claude Code adalah salah satu agen yang terpilih.
Apa perbedaannya dengan PDF4me MCP?
MCP kabel listrik PDF4me server alat ke klien yang mendukung Protokol Konteks Model. Keterampilan Agen mengajar REST API Penggunaan di dalam agen yang mendukung format keterampilan. Anda dapat menggunakan keduanya: MCP untuk panggilan alat dalam obrolan, Keterampilan untuk pembuatan kode dan pembuatan skrip.
Langkah selanjutnya
- Jelajahi PDF4me API referensi untuk detail titik akhir, poin keterampilan untuk
- Siapkan PDF4me MCP jika Anda ingin memanggil alat secara langsung MCP klien
- Bintang atau garpu
pdf4me-skillspada GitHub untuk pembaruan dan keterampilan baru