Skills para empresas

Esta guía es para administradores y arquitectos empresariales que necesitan gobernar Agent Skills en toda una organización. Cubre cómo evaluar, examinar, implementar y gestionar Skills a escala. Para orientación sobre autoría, consulte las mejores prácticas. Para detalles de arquitectura, consulte la descripción general de Skills.

Revisión de seguridad y evaluación

Implementar Skills en una empresa requiere responder dos preguntas distintas:

1. ¿Son seguros los Skills en general? Consulte la sección de consideraciones de seguridad en la descripción general para detalles de seguridad a nivel de plataforma.
2. ¿Cómo evalúo un Skill específico? Utilice la evaluación de riesgos y la lista de verificación de revisión a continuación.

Evaluación de nivel de riesgo

Evalúe cada Skill frente a estos indicadores de riesgo antes de aprobar su implementación:

Lista de verificación de revisión

Antes de implementar cualquier Skill de un tercero o colaborador interno, complete estos pasos:

1. Lea todo el contenido del directorio del Skill. Revise SKILL.md, todos los archivos markdown referenciados y cualquier script o recurso incluido.
2. Verifique que el comportamiento del script coincida con el propósito declarado. Ejecute los scripts en un entorno aislado y confirme que los resultados se alinean con la descripción del Skill.
3. Busque instrucciones adversariales. Busque directivas que indiquen a Claude ignorar reglas de seguridad, ocultar acciones a los usuarios, exfiltrar datos a través de respuestas o alterar el comportamiento según entradas específicas.
4. Verifique si hay recuperaciones de URL externas o llamadas de red. Busque en scripts e instrucciones patrones de acceso a la red (http, requests.get, urllib, curl, fetch).
5. Verifique que no haya credenciales codificadas. Compruebe si hay claves de API, tokens o contraseñas en los archivos del Skill. Las credenciales deben usar variables de entorno o almacenes de credenciales seguros, y nunca aparecer en el contenido del Skill.
6. Enumere todos los comandos bash, operaciones de archivos y referencias de herramientas. Considere el riesgo combinado cuando un Skill usa tanto herramientas de lectura de archivos como de red juntas.

Evaluación de Skills antes de la implementación

Los Skills pueden degradar el rendimiento del agente si se activan incorrectamente, entran en conflicto con otros Skills o proporcionan instrucciones deficientes. Requiera evaluación antes de cualquier implementación en producción.

Qué evaluar

Establezca puertas de aprobación para estas dimensiones antes de implementar cualquier Skill:

Requisitos de evaluación

Requiera que los autores de Skills envíen suites de evaluación con 3-5 consultas representativas por Skill, cubriendo casos donde el Skill debería activarse, no debería activarse y casos límite ambiguos. Requiera pruebas en los modelos que usa su organización (Haiku, Sonnet, Opus), ya que la efectividad del Skill varía según el modelo.

Para orientación detallada sobre la construcción de evaluaciones, consulte evaluación e iteración en las mejores prácticas. Para metodología general de evaluación, consulte desarrollar casos de prueba.

Uso de evaluaciones para decisiones del ciclo de vida

Los resultados de evaluación indican cuándo actuar:

• Precisión de activación en declive: Actualice la descripción o instrucciones del Skill
• Conflictos de coexistencia: Consolide Skills superpuestos o reduzca las descripciones
• Calidad de salida consistentemente baja: Reescriba las instrucciones o agregue pasos de validación
• Fallos persistentes a través de actualizaciones: Deprecie el Skill

Gestión del ciclo de vida de Skills

Organización de Skills a escala

Límites de recuperación

Como guía general, limite el número de Skills cargados simultáneamente para mantener una precisión de recuperación confiable. Los metadatos de cada Skill (nombre y descripción) compiten por atención en el prompt del sistema. Con demasiados Skills activos, Claude puede fallar al seleccionar el Skill correcto o perder los relevantes por completo. Use su suite de evaluación para medir la precisión de recuperación a medida que agrega Skills, y deje de agregar cuando el rendimiento se degrade.

Tenga en cuenta que las solicitudes de API admiten un máximo de 8 Skills por solicitud (consulte Uso de Skills con la API). Si un rol requiere más Skills de los que admite una sola solicitud, considere consolidar Skills específicos en otros más amplios o enrutar solicitudes a diferentes conjuntos de Skills según el tipo de tarea.

Comenzar específico, consolidar después

Anime a los equipos a comenzar con Skills específicos y orientados a flujos de trabajo en lugar de Skills amplios y multipropósito. A medida que emergen patrones en su organización, consolide Skills relacionados en paquetes basados en roles.

Ejemplo de progresión:

• Inicio: formatting-sales-reports, querying-pipeline-data, updating-crm-records
• Consolidación: sales-operations (cuando las evaluaciones confirmen rendimiento equivalente)

Nomenclatura y catalogación

Use convenciones de nomenclatura consistentes en toda su organización. La sección de convenciones de nomenclatura en las mejores prácticas proporciona orientación de formato.

Mantenga un registro interno para cada Skill con:

• Propósito: Qué flujo de trabajo admite el Skill
• Propietario: Equipo o individuo responsable del mantenimiento
• Versión: Versión implementada actualmente
• Dependencias: Servidores MCP, paquetes o servicios externos requeridos
• Estado de evaluación: Fecha de última evaluación y resultados

Paquetes basados en roles

Agrupe Skills por rol organizacional para mantener enfocado el conjunto activo de Skills de cada usuario:

• Equipo de ventas: Operaciones de CRM, informes de pipeline, generación de propuestas
• Ingeniería: Revisión de código, flujos de trabajo de implementación, respuesta a incidentes
• Finanzas: Generación de informes, validación de datos, preparación de auditorías

Cada paquete basado en roles debe contener solo los Skills relevantes para los flujos de trabajo diarios de ese rol.

Distribución y control de versiones

Control de código fuente

Almacene los directorios de Skills en Git para el seguimiento del historial, revisión de código mediante pull requests y capacidad de reversión. Cada directorio de Skills (que contiene SKILL.md y cualquier archivo incluido) se mapea naturalmente a una carpeta rastreada por Git.

Distribución basada en API

La Skills API proporciona distribución con alcance de espacio de trabajo. Los Skills cargados a través de la API están disponibles para todos los miembros del espacio de trabajo. Consulte Uso de Skills con la API para endpoints de carga, versionado y gestión.

Estrategia de versionado

• Producción: Fije los Skills a versiones específicas. Ejecute la suite de evaluación completa antes de promover una nueva versión. Trate cada actualización como una nueva implementación que requiere revisión de seguridad completa.
• Desarrollo y pruebas: Use las versiones más recientes para validar cambios antes de la promoción a producción.
• Plan de reversión: Mantenga la versión anterior como respaldo. Si una nueva versión falla las evaluaciones en producción, revierta a la última versión conocida como buena de inmediato.
• Verificación de integridad: Calcule sumas de verificación de los Skills revisados y verifíquelas en el momento de la implementación. Use commits firmados en su repositorio de Skills para garantizar la procedencia.

Consideraciones entre superficies

Mantenga los archivos fuente de Skills en Git como la única fuente de verdad. Si su organización implementa Skills en múltiples superficies, implemente su propio proceso de sincronización para mantenerlos consistentes. Para detalles completos, consulte disponibilidad entre superficies.

Próximos pasos