PDF4me Competenze dell'agente - Guida introduttiva

PDF4me Competenze dell'agente sono pacchetti di competenze installabili dal pubblico pdf4me-skills repository su GitHubEssi insegnano AI assistenti di programmazione come usare il PDF4me REST API: endpoint corretti, forme del payload, intestazioni di autenticazione e instradamento delle funzionalità attraverso converti, unisci, dividi, OCR, estrarre, generare, Excel, Wordoperazioni relative a immagini, moduli e sicurezza.

Questo è un separare la superficie del prodotto da PDF4me MCP. MCP collega un server di strumenti live (uvx pdf4me-mcp) in modo che il client possa invocare PDF4me azioni come strumenti durante la chat. Caricamento delle competenze dell'agente strutturato API guida nell'agente in modo che possa scrivere ed eseguire REST API codificare correttamente.

	PDF4me Competenze dell'agente	PDF4me MCP
Che cos'è	Pacchetto vacanza con API regole di riferimento e di instradamento	MCP server che espone PDF4me come strumenti richiamabili
Installare	npx skills add … O Claude Code /plugin comandi	uvx pdf4me-mcp nel cliente MCP configurazione
Ideale per	Agenti che scrivono script, curl o codice app contro l' REST API	Agenti che richiamano strumenti direttamente dalla chat UI
Repository	github.com/pdf4me/pdf4me-skills	github.com/pdf4me/pdf4me-mcp

Prerequisiti

• UN PDF4me conto e API chiave
• Accesso al PDF4me REST API A https://api.pdf4me.com
• Uno sostenuto AI client (vedi i percorsi di installazione qui sotto)

Get your API KeyView pdf4me-skills on GitHub

Cosa viene spedito nel repository

La prima competenza pubblicata è pdf4me-api. Segue il Competenze dell'agente formato:

Sentiero	Scopo
skills/pdf4me-api/SKILL.md	Manifestazione delle abilità, quando utilizzarle e API instradamento di categoria
skills/pdf4me-api/references/	Note sugli endpoint raggruppate per funzione (converti, modifica, estrai, genera, …)
skills/pdf4me-api/examples/	Esempi di script di flusso comuni

Quando un utente chiede di convertire un PDF, unisci file, esegui OCR, compila un modulo o chiama qualsiasi PDF4me endpoint, l'agente dovrebbe caricare questa skill e seguire i file di riferimento per la categoria corrispondente.

Scegli il percorso di installazione

Claude Code (plugin marketplace)

Utilizza questo percorso quando lavori in Claude Code (basato sul terminale) Claude agente di codifica). L'installazione utilizza Claudecomandi del plugin integrato, non npx skills.

Passaggio 1: Aggiungi il PDF4me mercato delle competenze

Nella directory del tuo progetto, esegui:

/plugin marketplace add pdf4me/pdf4me-skills

Aggiungi il marketplace pdf4me-skills da GitHub.

Quando il marketplace si registra correttamente, Claude Code conferma:

Successfully added marketplace: pdf4me-skills

Conferma dell'aggiunta del marketplace.

Passaggio 2: Installa il plugin pdf4me-api

Avvia il comando di installazione. Puoi digitare /plugin install pdf e seleziona la corrispondenza dal completamento automatico:

/plugin install pdf4me-api@pdf4me-skills

Seleziona pdf4me-api@pdf4me-skills dall'elenco dei plugin.

Claude Code mostra i dettagli del plugin e chiede un ambito di installazione:

1. Installa per te (ambito utente): disponibile in tutti i tuoi progetti
2. Installazione per tutti i collaboratori di questo repository (ambito del progetto): condiviso tramite la configurazione del repository
3. Installa per te, solo in questo repository (ambito locale): solo questo checkout

Scegli l'ambito che meglio si adatta al tuo modo di lavorare. Per un ambiente di lavoro personale, ambito locale O ambito utente è tipico.

Selezionare l'ambito di applicazione: utente, progetto o installazione locale.

Passaggio 3: ricarica i plugin

Al termine dell'installazione:

✓ Installed pdf4me-skills. Run /reload-plugins to apply.

Correre:

/reload-plugins

Ricarica i plugin in modo che Claude Code rilevi la nuova competenza.

La competenza è ora attiva in Claude Code per questo scopo.

npx skills (Cursor, Copilot, Codex, …)

Utilizzare questo percorso per Cursor, GitHub Copilot, OpenAI Codex, Cline, Gemini CLI, Windsurf, Zed, E Oltre 70 altri agenti supportato da skills CLI.

Passaggio 1: Eseguire il comando di installazione

Dalla directory del tuo progetto:

npx skills add https://github.com/pdf4me/pdf4me-skills.git --skill pdf4me-api

Un singolo comando clona il repository e avvia il programma di installazione interattivo.

IL CLI cloni pdf4me-skills, trova il pdf4me-api abilità e apre un selettore di agenti.

Fase 2: Selezionare gli agenti target

Agenti universali (Per esempio Cursor, Cline, Codex, GitHub Copilot, Gemini CLI, Warp, Zed) sono preselezionati in .agents/skills. Utilizza l'elenco ricercabile per aggiungere o rimuovere agenti come Claude Code, OpenClaw, O IBM Bob.

Seleziona ogni agente che utilizzi quotidianamente.

Utilizzo Spazio per attivare/disattivare gli agenti, ↑↓ muovere, Inserisci per confermare.

Passaggio 3: Scegliere l'ambito di installazione

Ambito di applicazione	Quando utilizzare
Progetto	La competenza risiede nel repository corrente (ad esempio .agents/skills/pdf4me-api) e può essere impegnato per il tuo team
Globale	La skill è installata per il tuo account utente in tutti i progetti

L'ambito del progetto mantiene la competenza con il tuo repository.

Passaggio 4: Scegliere il metodo di installazione

Metodo	Comportamento
Collegamento simbolico (consigliato)	Unica fonte di verità sotto .agents/skillsfacile da aggiornare
Copia a tutti gli agenti	Duplica i file nella cartella delle competenze di ciascun agente.

Il collegamento simbolico è l'impostazione predefinita consigliata.

Passaggio 5: Conferma e termina

Rivedi il riepilogo (percorso di installazione, agenti universali, collegamenti simbolici per Claude Code se selezionato), confermare SÌe attendere Installazione completata.

L'abilità è specificata per il tuo progetto e collegata a ciascun agente selezionato.

Il programma di installazione ti ricorda di rivedere le funzionalità prima dell'uso, poiché vengono eseguite con autorizzazioni complete da agente.

Passaggio 6: Verifica con il tuo agente

Apri il tuo agente e inizia a digitare un PDF-richiesta correlata. Ad esempio, in OpenAI Codex, digitando pdf superfici pdf4me-api [Skill] suggerimento con la descrizione dell'abilità.

Codex riconosce la skill pdf4me-api installata.

Premere Inserisci per inserire il contesto della competenza, quindi descrivi il tuo compito (ad esempio "converti questo DOCX A PDF utilizzando PDF4me").

Fornisci il tuo API chiave dell'agente

I documenti sulle competenze Come per autenticarsi (Authorization: Basic <your_api_key>) ma non memorizza segreti. Quando l'agente genera codice o comandi curl, forniscigli la tua chiave in modo sicuro:

• Esportazione PDF4ME_API_KEY (oppure incolla la chiave quando l'agente richiede la configurazione di runtime)
• Non impegnarti mai API chiavi per git

Vedere Connettiti al PDF4me V2 API per il formato completo di autorizzazione e richiesta.

Esempi di messaggi di errore dopo l'installazione

Una volta installata la skill, prova a utilizzare comandi come:

• "Utilizzo PDF4me per unire questi due PDFs e restituire l'output in formato base64."
• "Converti questo Word modello per PDF con l'endpoint di generazione del documento."
• "Estrarre i dati della tabella da questo PDF con PDF4me."
• "Quale PDF4me endpoint dovrei usare per aggiungere un QR Code a PDF?"

L'agente dovrebbe caricarsi pdf4me-api, selezionare il file di riferimento corretto (ad esempio references/merge-split.md O references/barcode.md), e produrre un valido REST chiamata.

Risoluzione dei problemi

L'abilità non compare nel mio agente

• Claude Code: Correre /reload-plugins Dopo l'installazione, verifica di aver selezionato l'ambito corretto (utente, progetto o locale).
• Competenze npx: Esegui nuovamente il comando di installazione e verifica che l'agente sia stato selezionato. Controlla che .agents/skills/pdf4me-api/SKILL.md esiste nel tuo progetto.
• Riavvia il IDE o sessione agente dopo la prima installazione.

Claude Code vs. competenze npx: quale dovrei usare?

• Claude Code soltanto: Utilizzare il /plugin marketplace percorso nel Claude Code scheda sopra.
• Cursor, Copilot, Codex, Cline, o più agenti: Utilizzo npx skills add … anche se Claude Code è uno degli agenti selezionati.

In cosa si differenzia da PDF4me MCP?

MCP fili vivi PDF4me server di strumenti in client che supportano il Model Context Protocol. Competenze dell'agente insegnare REST API Utilizzo all'interno di agenti che supportano il formato delle competenze. È possibile utilizzare entrambi: MCP per le chiamate agli strumenti in chat, competenze per la generazione di codice e lo scripting.

Prossimi passi

• Sfoglia il PDF4me API riferimento per i dettagli dell'endpoint i punti abilità a
• Impostare PDF4me MCP se desideri la chiamata diretta dello strumento in MCP clienti
• Stella o forchetta pdf4me-skills SU GitHub per aggiornamenti e nuove competenze