PDF4me Habilidades do Agente: Primeiros Passos

PDF4me Habilidades do Agente são pacotes de habilidades instaláveis do público pdf4me-skills repositório em GitHubEles ensinam AI assistentes de codificação como usar o PDF4me REST API: endpoints corretos, formatos de payload, cabeçalhos de autenticação e roteamento de recursos em conversão, mesclagem e divisão, OCR, extrair, gerar, Excel, Wordoperações de imagem, forma e segurança.

Isto é um superfície do produto separada de PDF4me MCP. MCP conecta um servidor de ferramentas ao vivo (uvx pdf4me-mcp) para que o cliente possa invocar PDF4me Ações como ferramentas durante o chat. Carregar habilidades do agente estruturado API orientação no agente para que ele possa escrever e executar REST API Codifique corretamente.

	PDF4me Habilidades do Agente	PDF4me MCP
O que é isso?	Pacote de habilidades com API regras de referência e roteamento	MCP servidor que expõe PDF4me como ferramentas invocáveis
Instalar	npx skills add … ou Claude Code /plugin comandos	uvx pdf4me-mcp no cliente MCP configuração
Ideal para	Agentes que escrevem scripts, curl ou código de aplicativo contra o REST API	Agentes que acessam ferramentas diretamente do chat UI
Repositório	github.com/pdf4me/pdf4me-skills	github.com/pdf4me/pdf4me-mcp

Pré-requisitos

• A PDF4me conta e API chave
• Acesso ao PDF4me REST API no https://api.pdf4me.com
• Um apoiado AI cliente (consulte os caminhos de instalação abaixo)

Get your API KeyView pdf4me-skills on GitHub

O que está incluído no repositório?

A primeira habilidade publicada é pdf4me-apiSegue-se ao Habilidades do Agente formato:

Caminho	Propósito
skills/pdf4me-api/SKILL.md	Manifestação de habilidade, quando usá-la e API roteamento de categoria
skills/pdf4me-api/references/	Notas de endpoint agrupadas por recurso (converter, editar, extrair, gerar, …)
skills/pdf4me-api/examples/	Pequenos exemplos de scripts para fluxos comuns

Quando um usuário solicita a conversão de um PDFmesclar arquivos, executar OCRpreencha um formulário ou ligue para qualquer pessoa. PDF4me No endpoint, o agente deve carregar essa habilidade e seguir os arquivos de referência para a categoria correspondente.

Escolha o seu caminho de instalação

Claude Code (plugin marketplace)

Use este caminho quando estiver trabalhando em Claude Code (o baseado em terminal) Claude agente de codificação). A instalação utiliza Claudecomandos de plugin integrados, não npx skills.

Passo 1: Adicione o PDF4me mercado de habilidades

No diretório do seu projeto, execute:

/plugin marketplace add pdf4me/pdf4me-skills

Adicione o marketplace pdf4me-skills do GitHub.

Quando o mercado se registrar com sucesso, Claude Code confirma:

Successfully added marketplace: pdf4me-skills

Confirmação de que o marketplace foi adicionado.

Passo 2: Instale o plugin pdf4me-api

Inicie o comando de instalação. Você pode digitar /plugin install pdf e selecione a partida no recurso de preenchimento automático:

/plugin install pdf4me-api@pdf4me-skills

Selecione pdf4me-api@pdf4me-skills na lista de plugins.

Claude Code Exibe os detalhes do plugin e solicita um escopo de instalação:

1. Instalar para você (escopo do usuário)Disponível em todos os seus projetos
2. Instalar para todos os colaboradores deste repositório (escopo do projeto): compartilhado via configuração do repositório
3. Instale para você, somente neste repositório (escopo local).: somente este checkout

Escolha o escopo que melhor se adapta à sua forma de trabalhar. Para um ambiente de testes pessoal, escopo local ou escopo do usuário É típico.

Selecione o escopo de instalação: usuário, projeto ou local.

Passo 3: Recarregar plugins

Após a conclusão da instalação:

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

Correr:

/reload-plugins

Recarregue os plugins para que o Claude Code adquira a nova habilidade.

A habilidade já está ativa em Claude Code para este escopo.

npx skills (Cursor, Copilot, Codex, …)

Use este caminho para Cursor, GitHub Copilot, OpenAI Codex, Cline, Gemini CLI, Windsurf, Zed, e Mais de 70 outros agentes apoiado por skills CLI.

Passo 1: Execute o comando de instalação

A partir do diretório do seu projeto:

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

Um único comando clona o repositório e inicia o instalador interativo.

O CLI clones pdf4me-habilidades, encontra o pdf4me-api habilidade, e abre um seletor de agentes.

Etapa 2: Selecionar os agentes-alvo

Agentes universais (por exemplo Cursor, Cline, Codex, GitHub Copilot, Gemini CLI, Warp, Zed) são pré-selecionados em .agents/skillsUtilize a lista pesquisável para adicionar ou remover agentes, como por exemplo: Claude Code, OpenClaw, ou IBM Bob.

Selecione cada agente que você usa diariamente.

Usar Espaço para alternar agentes, ↑↓ mover-se, Digitar Para confirmar.

Etapa 3: Escolha o escopo da instalação

Escopo	Quando usar
Projeto	A habilidade reside no repositório atual (por exemplo) .agents/skills/pdf4me-api) e podem ser comprometidos com sua equipe
Global	A habilidade está instalada para sua conta de usuário em todos os projetos.

O escopo do projeto mantém a habilidade associada ao seu repositório.

Passo 4: Escolha o método de instalação

Método	Comportamento
Link simbólico (Recomendado)	Fonte única de verdade sob .agents/skills; fácil de atualizar
Cópia para todos os agentes	Duplica os arquivos na pasta de habilidades de cada agente.

O link simbólico é a opção padrão recomendada.

Etapa 5: Confirme e finalize

Analise o resumo (caminho de instalação, agentes universais, links simbólicos para Claude Code (se selecionado), confirme Sime espere por Instalação concluída.

A habilidade é desenvolvida para o seu projeto e vinculada a cada agente selecionado.

O instalador lembra você de revisar as habilidades antes de usá-las, pois elas são executadas com permissões totais de agente.

Etapa 6: Verifique com seu agente

Abra seu agente e comece a digitar um PDF-requisição relacionada. Por exemplo, em OpenAI Codex, digitando pdf superfícies pdf4me-api [Skill] Sugestão com a descrição da habilidade.

O Codex reconhece a skill pdf4me-api instalada.

Imprensa Digitar Para inserir o contexto da habilidade, descreva sua tarefa (por exemplo, "converter isto"). DOCX para PDF usando PDF4me").

Forneça o seu API chave para o agente

Os documentos de habilidades como para autenticar (Authorization: Basic <your_api_key>) mas não armazena segredos. Quando o agente gerar código ou comandos curl, forneça sua chave de forma segura:

• Export PDF4ME_API_KEY (ou cole a chave quando o agente solicitar a configuração de tempo de execução)
• Nunca se comprometa API chaves para git

Ver Conecte-se ao PDF4me V2 API Para obter o formato completo de autenticação e solicitação.

Exemplos de mensagens exibidas após a instalação

Após a instalação da skill, tente comandos como:

• "Usar PDF4me para fundir estes dois PDFs e retornar a saída em base64."
• "Converta isto Word modelo para PDF com o endpoint de geração de documento."
• "Extrair dados da tabela a partir desta PDF com PDF4me"
• "Qual PDF4me endpoint que devo usar para adicionar um QR Code para um PDF?"

O agente deve carregar pdf4me-api, selecione o arquivo de referência correto (por exemplo references/merge-split.md ou references/barcode.md), e produzir um válido REST chamar.

Solução de problemas

A habilidade não aparece no meu agente.

• Claude Code: Correr /reload-plugins Após a instalação, confirme se você selecionou o escopo correto (usuário, projeto ou local).
• Habilidades npx: Execute novamente o comando de instalação e verifique se o seu agente foi selecionado. Verifique se .agents/skills/pdf4me-api/SKILL.md existe em seu projeto.
• Reinicie o IDE ou sessão do agente após a primeira instalação.

Claude Code vs. habilidades npx: qual devo usar?

• Claude Code apenas: Use o /plugin marketplace caminho no Claude Code aba acima.
• Cursor, Copilot, Codex, Clineou múltiplos agentes: Usar npx skills add … ainda que Claude Code é um dos agentes selecionados.

Qual a diferença entre isso e o PDF4me MCP?

MCP fios energizados PDF4me Servidor de ferramentas em clientes que suportam o Protocolo de Contexto de Modelo. Habilidades do Agente ensinar REST API Utilização em agentes que suportam o formato de habilidades. Você pode usar ambos: MCP Para chamadas de ferramentas de bate-papo, habilidades para geração de código e criação de scripts.

Próximos passos

• Navegue pelo PDF4me API referência Para detalhes do ponto final, a habilidade aponta para
• Configurar PDF4me MCP Se você deseja chamar a ferramenta diretamente em MCP clientes
• Estrela ou garfo pdf4me-skills sobre GitHub para atualizações e novas habilidades