📦

revise

Riesgo bajo ⚙️ Comandos externos

Revisar documentos P11 a partir de comentarios de revisores

Revisar documentos p11 con varios colaboradores genera comentarios dispersos que son difíciles de aplicar manualmente. Esta skill lee los comentarios de los revisores, los clasifica según su claridad, aplica las decisiones claras al documento de origen y publica automáticamente una nueva versión.

Soporta: Claude Codex Code(CC)
📊 75 Adecuado
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Recursos legibles por agentes

Usa estos enlaces cuando un AI Agent, crawler o script necesite contexto limpio en lugar de leer toda la página.

Pruébalo

Usando "revise". Aplica los comentarios en mi documento de propuesta de diseño, donde el equipo me pidió agregar una sección de resumen y reordenar la lista de requisitos.

Resultado esperado:

Revisé los 8 hilos de comentarios en tu propuesta de diseño. Encontré 6 decisiones claras y 2 que necesitan tu intervención. Apliqué todos los cambios claros: agregué la sección de resumen después de la introducción, reordené la lista de requisitos por prioridad y actualicé la tabla de cronograma. Aquí están la URL de lectura y la URL de edición actualizadas.

Usando "revise". Actualiza la documentación de la API con los comentarios de revisión de la versión 3.

Resultado esperado:

Obtuve la versión 3 de la documentación de la API y encontré 5 hilos de comentarios. Todos los comentarios tenían decisiones claras, así que los apliqué todos: corregí las URLs de endpoints en la sección de autenticación, agregué la nueva tabla de parámetros de límite de tasa y corregí los ejemplos de formato de respuesta. El documento revisado está publicado en la nueva URL de lectura.

Auditoría de seguridad

Riesgo bajo
v1 • 5/23/2026

All 57 static findings are false positives. Weak cryptographic algorithm flags were triggered by a hex color code ("#2563EB" in openai.yaml:3), a React component name ("DefinitionDescription" in components.md:34), and YAML metadata fields (SKILL.md:3-5). Ruby/shell backtick execution flags were triggered by Markdown code block backticks in code fences across SKILL.md and components.md. The system reconnaissance flag on SKILL.md:92 is actually security-conscious guidance about bearer credentials. The skill has legitimate external command usage via the p11 CLI, which is expected and necessary for its document revision workflow. No malicious intent detected.

3
Archivos escaneados
160
Líneas analizadas
4
hallazgos
1
Auditorías totales
Problemas de riesgo bajo (3)
False Positive: Weak Cryptographic Algorithm Detection
Static scanner flagged hex color code '#2563EB' (openai.yaml:3), component name 'DefinitionDescription' (components.md:34), and YAML description fields (SKILL.md:3-5) as weak cryptographic algorithms. None of these are cryptographic material. Hex color codes and component names are false positives for crypto detection patterns.
False Positive: Markdown Backticks as Ruby Shell Execution
Static scanner misidentified Markdown code fence backticks as Ruby shell backtick execution. All 52 flagged instances across SKILL.md and components.md are standard Markdown code block formatting (triple ``` or inline ` backticks) for displaying code or bash command examples, not shell command execution.
False Positive: System Reconnaissance
Static scanner flagged SKILL.md:92 as system reconnaissance. This line instructs the AI to 'Treat edit URLs as bearer credentials and avoid exposing them unnecessarily.' This is security-conscious guidance about credential handling, not reconnaissance activity.

Patrones detectados

External Command Execution via p11 CLI
Auditado por: claude

Puntuación de calidad

41
Arquitectura
100
Mantenibilidad
87
Contenido
65
Comunidad
84
Seguridad
100
Cumplimiento de la especificación

Lo que puedes crear

Actualizar una propuesta de diseño después de la revisión del equipo

Un diseñador recibe comentarios sobre un documento de propuesta de funcionalidad. La skill aplica todas las decisiones claras de los comentarios de los revisores y publica la versión actualizada para la aprobación final.

Aplicar comentarios de revisión técnica a la documentación

Un ingeniero recopila comentarios de revisión sobre documentación técnica. La skill procesa cada comentario, realiza los cambios solicitados y comparte el documento revisado.

Procesar en lote varias rondas de revisión de documentos

Un líder de equipo gestiona revisiones iterativas de documentos en varias rondas. La skill registra qué comentarios se aplicaron y cuáles aún necesitan discusión.

Prueba estos prompts

Revisión básica de documentos
Usa p11:revise para actualizar el documento p11 más reciente con comentarios de revisores. Obtén los comentarios y aplica todas las decisiones claras.
Revisión desde una versión específica
Revisa el documento p11 en la URL de edición [url] desde la versión [number]. Obtén los comentarios de esa versión y aplica solo las decisiones claras.
Gestión de comentarios poco claros o disputados
Usa p11:revise en el documento actual. Clasifica todos los hilos de comentarios visibles. Si alguno necesita aclaración, pregúntame cómo proceder antes de publicar.
Revisión completa de documento con referencia de componentes
Revisa el documento en [url]. Primero lee la referencia de componentes y luego obtén todos los comentarios. Aplica las decisiones claras y publica. Informa qué cambios se realizaron y cuáles necesitan mi intervención.

Mejores prácticas

  • Clasifica siempre los hilos de comentarios por contenido antes de hacer cambios. No todos los comentarios sin resolver requieren acción.
  • Confirma con el usuario antes de publicar cuando algún hilo de comentarios necesite aclaración humana.
  • Lee la referencia de componentes p11 antes de editar para asegurarte de usar solo componentes de documento compatibles.

Evitar

  • Ignorar silenciosamente hilos de comentarios visibles que necesitan aclaración humana. Pregunta siempre al usuario cómo proceder.
  • Publicar revisiones sin antes obtener y revisar todos los comentarios del documento objetivo.
  • Agregar elementos de UI interactivos, como botones o formularios, a los documentos. Usa solo componentes seguros para documentos de la biblioteca p11.

Preguntas frecuentes

¿Qué tipos de documentos puede revisar esta skill?
Esta skill funciona con documentos compartibles p11. Estos son documentos basados en React creados con la plataforma p11.
¿La skill gestiona automáticamente todos los comentarios de los revisores?
No. La skill aplica automáticamente las decisiones claras, pero solicita tu intervención cuando los comentarios necesitan aclaración o están en disputa.
¿Qué sucede con los comentarios que la skill no puede entender?
Los comentarios que necesitan aclaración se marcan. La skill pregunta si quieres responder para obtener más información o saltarlos por ahora.
¿Necesito instalar algo para usar esta skill?
Sí. La CLI de p11 debe estar instalada globalmente. La skill puede instalarla con npm install -g @p11-core/cli@latest si es necesario.
¿Puedo revisar una versión específica de un documento?
Sí. Puedes proporcionar un número de versión para revisar cualquier versión histórica de un documento p11.
¿Cómo sabe la skill qué documento debe revisar?
Usa la URL o el ID del documento que proporciones. Si no especificas uno, usa el documento p11 más reciente de la conversación.

Detalles del desarrollador

Estructura de archivos