PDF4me Habilidades del agente: Primeros pasos
PDF4me Habilidades del agente son paquetes de habilidades instalables del público pdf4me-skills repositorio en GitHubEllos enseñan AI asistentes de codificación cómo usar el PDF4me REST API: puntos finales correctos, formas de carga útil, encabezados de autenticación y enrutamiento de características a través de convertir, fusionar, dividir, OCR, extraer, generar, Excel, Wordoperaciones de imagen, forma y seguridad.
Esto es un superficie del producto separada de PDF4me MCP. MCP conecta un servidor de herramientas en vivo (uvx pdf4me-mcp) para que el cliente pueda invocar PDF4me acciones como herramientas durante el chat. Carga de habilidades del agente estructurado API guía en el agente para que pueda escribir y ejecutar REST API codificar correctamente.
| PDF4me Habilidades del agente | PDF4me MCP | |
|---|---|---|
| Qué es | Paquete de habilidades con API Reglas de referencia y enrutamiento | MCP servidor que expone PDF4me como herramientas invocables |
| Instalar | npx skills add … o Claude Code /plugin comandos | uvx pdf4me-mcp en el cliente MCP configuración |
| Lo mejor para | Agentes que escriben scripts, curl o código de aplicación contra el REST API | Agentes que llaman a las herramientas directamente desde el chat UI |
| Repositorio | github.com/pdf4me/pdf4me-skills | github.com/pdf4me/pdf4me-mcp |
Requisitos previos
- A PDF4me cuenta y API llave
- Acceso a la PDF4me REST API en
https://api.pdf4me.com - Uno apoyó AI cliente (ver rutas de instalación a continuación)
¿Qué barcos hay en el repositorio?
La primera habilidad publicada es pdf4me-api. Sigue el Habilidades del agente formato:
| Camino | Objetivo |
|---|---|
skills/pdf4me-api/SKILL.md | Habilidad manifiesta, cuándo usarla y API enrutamiento de categorías |
skills/pdf4me-api/references/ | Notas de los puntos finales agrupadas por función (convertir, editar, extraer, generar, …) |
skills/pdf4me-api/examples/ | Pequeños ejemplos de scripts para flujos comunes |
Cuando un usuario solicita convertir un PDF, fusionar archivos, ejecutar OCR, rellene un formulario o llame a cualquiera PDF4me En el punto final, el agente debe cargar esta habilidad y seguir los archivos de referencia para la categoría correspondiente.
Elige tu ruta de instalación
- Claude Code (plugin marketplace)
- npx skills (Cursor, Copilot, Codex, …)
Utilice esta ruta cuando trabaje en Claude Code (basado en terminal) Claude agente de codificación). Usos de instalación Claudecomandos de complemento integrados de , no npx skills.
Paso 1: Añadir el PDF4me mercado de habilidades
En el directorio de tu proyecto, ejecuta:
/plugin marketplace add pdf4me/pdf4me-skills
Añade el mercado de habilidades pdf4me desde GitHub.
Cuando el mercado se registre correctamente, Claude Code confirma:
Successfully added marketplace: pdf4me-skills
Confirmación de que el mercado se ha añadido.
Paso 2: Instale el complemento pdf4me-api.
Inicie el comando de instalación. Puede escribir /plugin install pdf y seleccione la coincidencia desde la función de autocompletar:
/plugin install pdf4me-api@pdf4me-skills
Seleccione pdf4me-api@pdf4me-skills de la lista de complementos.
Claude Code muestra los detalles del complemento y solicita un alcance de la instalación:
- Instalar para ti (ámbito de usuario): disponible en todos tus proyectos
- Instalar para todos los colaboradores de este repositorio (ámbito del proyecto): compartido a través de la configuración del repositorio
- Instalación disponible solo en este repositorio (ámbito local).: solo este pago
Elige el alcance que se ajuste a tu forma de trabajar. Para un entorno de pruebas personal, alcance local o ámbito del usuario es típico.
Seleccione el ámbito de la instalación: usuario, proyecto o local.
Paso 3: Recargar los complementos
Una vez finalizada la instalación:
✓ Installed pdf4me-skills. Run /reload-plugins to apply.
Correr:
/reload-plugins
Recarga los plugins para que Claude Code adquiera la nueva habilidad.
La habilidad ahora está activa en Claude Code para este alcance.
Utilice esta ruta para Cursor, GitHub Copilot, OpenAI Codex, Cline, Gemini CLI, Windsurf, Zed, y Más de 70 agentes adicionales apoyado por el skills CLI.
Paso 1: Ejecutar el comando de instalación
Desde el directorio de tu proyecto:
npx skills add https://github.com/pdf4me/pdf4me-skills.git --skill pdf4me-api
Un comando clona el repositorio e inicia el instalador interactivo.
El CLI clones pdf4me-habilidades, encuentra el pdf4me-api habilidad, y abre un selector de agentes.
Paso 2: Seleccionar agentes objetivo
Agentes universales (Por ejemplo Cursor, Cline, Codex, GitHub Copilot, Gemini CLI, Warp, Zed) se preseleccionan en .agents/skills. Utilice la lista de búsqueda para agregar o eliminar agentes como Claude Code, OpenClaw, o IBM Bob.
Selecciona a cada agente que uses a diario.
Usar Espacio para alternar agentes, ↑↓ moverse, Ingresar para confirmar.
Paso 3: Elegir el alcance de la instalación
| Alcance | Cuándo usar |
|---|---|
| Proyecto | La habilidad reside en el repositorio actual (por ejemplo .agents/skills/pdf4me-api) y puede comprometerse con su equipo |
| Global | La habilidad está instalada en tu cuenta de usuario para todos los proyectos. |
El alcance del proyecto mantiene la habilidad con su repositorio.
Paso 4: Elija el método de instalación.
| Método | Comportamiento |
|---|---|
| Enlace simbólico (recomendado) | Fuente única de verdad según .agents/skillsFácil de actualizar |
| Copia para todos los agentes | Duplica los archivos en la carpeta de habilidades de cada agente. |
El enlace simbólico es la opción predeterminada recomendada.
Paso 5: Confirmar y finalizar
Revise el resumen (ruta de instalación, agentes universales, enlaces simbólicos para Claude Code (si se selecciona), confirmar Síy esperar a Instalación completada.
La habilidad está escrita para tu proyecto y vinculada a cada agente seleccionado.
El instalador le recuerda que revise las habilidades antes de usarlas, ya que se ejecutan con permisos de agente completos.
Paso 6: Verifica con tu agente
Abre tu agente y comienza a escribir un PDF-solicitud relacionada. Por ejemplo, en OpenAI Codex, escribiendo pdf superficies el pdf4me-api [Skill] Sugerencia con la descripción de la habilidad.
Codex reconoce la habilidad pdf4me-api instalada.
Prensa Ingresar para insertar el contexto de la habilidad, luego describa su tarea (por ejemplo, "convertir esto DOCX a PDF usando PDF4me").
Proporcione su API clave para el agente
Los documentos de habilidades cómo para autenticar (Authorization: Basic <your_api_key>) pero no almacena secretos. Cuando el agente genere código o comandos curl, proporciónele su clave de forma segura:
- Exportar
PDF4ME_API_KEY(o pegue la clave cuando el agente solicite la configuración de tiempo de ejecución) - Nunca te comprometas API claves para git
Ver Conéctate a la PDF4me V2 API para el formato completo de autenticación y solicitud.
Ejemplos de mensajes después de la instalación
Una vez instalada la habilidad, pruebe con indicaciones como las siguientes:
- "Usar PDF4me fusionar estos dos PDFs y devolver la salida en base64."
- "Convierta esto Word plantilla para PDF con el punto final de generación de documentos."
- "Extraer datos de la tabla de esta PDF con PDF4me"
- "Cual PDF4me ¿Debo usar el punto final para agregar un? QR Code a un PDF?"
El agente debería cargar pdf4me-api, seleccione el archivo de referencia correcto (por ejemplo references/merge-split.md o references/barcode.md), y producir un válido REST llamar.
Solución de problemas
La habilidad no aparece en mi agente.
- Claude Code: Correr
/reload-pluginsDespués de la instalación, confirme que ha seleccionado el ámbito correcto (usuario, proyecto o local). - Habilidades npx: Vuelva a ejecutar el comando de instalación y verifique que su agente haya sido seleccionado. Compruebe que
.agents/skills/pdf4me-api/SKILL.mdexiste en tu proyecto. - Reiniciar el IDE o sesión del agente después de la primera instalación.
Claude Code vs. npx skills: ¿cuál debería usar?
- Claude Code solo: Utilice el
/plugin marketplacecamino en el Claude Code pestaña arriba. - Cursor, Copilot, Codex, Clineo múltiples agentes: Usar
npx skills add …incluso si Claude Code es uno de los agentes seleccionados.
¿En qué se diferencia esto de PDF4me MCP?
MCP cables una vida PDF4me Servidor de herramientas para clientes que admiten el Protocolo de Contexto de Modelo. Habilidades del agente enseñar REST API uso dentro de agentes que admiten el formato de habilidades. Puedes usar ambos: MCP Para llamadas a herramientas dentro del chat, habilidades para la generación de código y la creación de scripts.
Próximos pasos
- Explorar el PDF4me API referencia para obtener detalles del punto final los puntos de habilidad para
- Configuración PDF4me MCP si desea realizar llamadas directas a herramientas en MCP clientes
- Estrella o horquilla
pdf4me-skillsen GitHub para actualizaciones y nuevas habilidades