Skills para agentes de IA

Opfield es el plano de control de infraestructura para agentes de programación: trabajan sin acceso SSH directo y no tienes que enseñar a cada agente tu proceso de despliegue desde cero. Las skills públicas de Opfield explican cómo funcionan los recursos, los permisos, los Tasks, los builds, la entrega, el diagnóstico, la verificación y la reversión en Opfield: using-opfield es el punto de entrada, y hay una skill por cada área del producto que entra en los detalles. Después, el servidor MCP remoto de Opfield da al agente acceso autenticado a los recursos que su usuario puede ver.

Las dos capas tienen funciones distintas:

• Skill del agente: conocimiento operativo reutilizable que se instala en Codex, Claude Code, Cursor y otros agentes compatibles.
• Opfield MCP: herramientas en vivo de tu instalación de Opfield, protegidas por OAuth, ámbitos de recursos, derechos del plan, confirmaciones y registro de auditoría.

Instala las skills de Opfield

Desde un proyecto en el que el agente deba usar Opfield, instala el conjunto completo:

npx skills add opfield/opfield-skills --skill '*'

El instalador te deja seleccionar los agentes compatibles configurados en tu máquina. Para que las skills estén disponibles en todos los proyectos, instálalas de forma global con -g. Para instalar una sola skill, indica su nombre, por ejemplo --skill publishing-html-pages; using-opfield por sí sola dirige al agente hacia las demás skills y le dice dónde leerlas.

Skill	Cubre
using-opfield	Conexión por MCP, descubrimiento de herramientas, reglas de seguridad, Tasks y verificación; dirige a las skills siguientes
publishing-html-pages	Publicar informes HTML generados y sitios estáticos en Pages y compartir el enlace
deploying-workloads	Containers, Deployments blue/green, Compose Projects, builds desde Git, volúmenes y migración
high-availability	Ejecutar una carga de trabajo en varios nodos Docker con réplicas o conmutación por error
ingress-and-domains	Dominios, DNS, TLS, Routes, Access Lists, Secure Links y modo de mantenimiento
internal-pki	Autoridades de certificación privadas y certificados internos
databases	PostgreSQL, almacenes clave-valor y ClickHouse gestionados y externos, vinculaciones, consultas y copias de seguridad
storage	Conexiones de almacenamiento, almacenamiento de objetos gestionado, trabajos de copia y la migración desde MinIO
managing-nodes	Registrar, actualizar y reparar nodos, consola y archivos
observability	Logging, exportación a SIEM, alertas, webhooks, páginas de estado y el registro de auditoría
access-control	Usuarios, grupos, ámbitos, tokens de API y concesiones OAuth

La skill es Markdown sencillo con referencias concretas. Puedes inspeccionarla antes de instalarla en el repositorio opfield/opfield-skills y mantenerla bajo control de versiones cuando la instales a nivel de proyecto.

Instala como plugin nativo

Claude Code y Codex también pueden instalar la misma skill canónica como plugin nativo. Para un agente concreto, elige la vía del plugin o npx skills; no hace falta instalar ambas.

Para Claude Code:

claude plugin marketplace add opfield/opfield-skills
claude plugin install opfield@opfield-skills

Para Codex:

codex plugin marketplace add opfield/opfield-skills --ref main
codex plugin add opfield@opfield-skills

Inicia una sesión nueva después de instalar o actualizar el plugin. El repositorio no contiene hooks siempre activos: la instalación por sí sola no se conecta a Opfield ni cambia la infraestructura.

Los comandos completos de instalación, actualización y verificación se mantienen en el INSTALL.md del repositorio.

Skills servidas por tu Opfield

Cada instalación de Opfield sirve las mismas skills por MCP, en la versión correspondiente a su propia release: el índice es el recurso opfield://skills, cada archivo es opfield://skills/<name>/SKILL.md y cada skill es también un prompt de MCP llamado skill-<name>. Un agente conectado a Opfield puede leerlas sin instalar nada. Las skills también se publican en https://docs.opfield.dev/agent/<name>/SKILL.md, enumeradas en /agent/index.json y en llms.txt.

Conecta el agente a Opfield

Primero, un administrador activa Settings → Features → OAuth and MCP access → Enable MCP server y concede al usuario Use MCP (mcp:use) junto con los ámbitos habituales de los recursos a los que puede acceder el agente.

Para Codex:

codex mcp add opfield --url https://opfield.example.com/api/mcp
codex mcp login opfield
codex mcp list

Para Claude Code:

claude mcp add --transport http opfield --scope user https://opfield.example.com/api/mcp
claude mcp login opfield
claude mcp get opfield

Sustituye opfield.example.com por el nombre de host público canónico de tu instalación de Opfield. La autenticación se completa a través de OAuth de Opfield en un navegador. No crees ni pegues un token de API para MCP.

Para la política de callbacks, el descubrimiento compacto de herramientas y los errores de conexión, usa la guía completa de REST API y MCP.

Empieza con una tarea de solo lectura

Verifica la conexión y el límite de permisos antes de pedir al agente que haga un cambio:

Use $using-opfield. List the Opfield Nodes and workloads I can access,
summarize warnings and active Tasks, and recommend the safest next action.
Do not change anything.

Después prueba una petición de entrega con alcance limitado:

Use $using-opfield to inspect how this application is currently
published. Propose an Opfield-native update and rollback plan. Wait for my
approval before changing infrastructure.

La skill indica al agente que lea primero el estado actual, respete la propiedad de los recursos, evite cambios directos en los hosts, siga los Tasks asíncronos y verifique el recurso real o el resultado HTTPS en lugar de dar por bueno que una petición aceptada es un éxito.

Permisos y seguridad

Crea un usuario o grupo de Opfield dedicado para el acceso de los agentes y concede solo los recursos y las acciones necesarios. MCP no elude la autorización de Opfield: retirar mcp:use, cambiar la pertenencia a grupos o reducir los ámbitos de recursos afecta a las llamadas futuras que se hagan con la conexión existente.

Un agente cuyo usuario solo puede trabajar en algunas carpetas, nodos o recursos se queda dentro de ellos. Cuando la conexión está limitada, Opfield añade un resumen de ese acceso a las instrucciones del servidor MCP en el momento de conectar. Las skills using-opfield y access-control indican al agente que llame a get_my_access, o lea opfield://access, cuando una lista vuelve vacía o se rechaza una creación en la raíz, y que pase folderId al crear; una creación rechazada también indica las carpetas que puede usar. Consulta Averigua a qué puede acceder quien llama.

Usa identidades e instalaciones de Opfield separadas para desarrollo y producción. Una skill da instrucciones a un agente, no autoridad; lo que puede hacer lo determinan los ámbitos del usuario conectado y la petición explícita del usuario.