Habilidades doc-coauthoring
📄

doc-coauthoring

Seguro

Co-Autoría de Documentación con IA

También disponible en: 7Spade,7Spade,davila7,AstraBit-CPT,Azeem-2,anthropics

Crear documentación de calidad es un desafío. Esta habilidad proporciona un flujo de trabajo estructurado de tres etapas que ayuda a los usuarios a recopilar contexto, refinar contenido mediante iteración y probar documentos con una instancia nueva de IA para garantizar claridad para los lectores.

Soporta: Claude Codex Code(CC)
🥉 74 Bronce
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

Pruébalo

Usando "doc-coauthoring". Necesito escribir una especificación técnica para nuestra nueva API

Resultado esperado:

Puedo ayudarte a crear una especificación técnica usando nuestro flujo de trabajo estructurado. Esto es lo que haremos:

**Etapa 1: Recopilación de Contexto** - Haré preguntas sobre tu API, su propósito, el enfoque técnico y quién la implementará.

**Etapa 2: Refinamiento y Estructura** - Construiremos la especificación sección por sección, generando opciones de contenido y refinando cada parte.

**Etapa 3: Prueba con Lectores** - Probaremos la especificación con una instancia nueva de Claude para asegurar que sea clara para los implementadores.

¿Te gustaría proceder con este flujo de trabajo, o prefieres trabajar de forma libre?

Usando "doc-coauthoring". Ayúdame a crear un documento de decisión para adoptar una nueva base de datos

Resultado esperado:

Te guiaré a través de la creación de un documento de decisión para la selección de tu base de datos. Comencemos con la **Recopilación de Contexto**:

1. ¿Qué tipo de documento es este? (Documento de decisión, RFC, etc.)
2. ¿Quién es la audiencia principal?
3. ¿Cuál es el impacto deseado cuando alguien lea esto?
4. ¿Hay una plantilla o formato específico a seguir?
5. ¿Alguna otra restricción o contexto que deba conocer?

Por favor, comparte lo que sepas sobre tus opciones de bases de datos, el equipo que las evalúa y cualquier preocupación específica que deba abordarse.

Auditoría de seguridad

Seguro
v1 • 2/24/2026

All 18 static findings are false positives. The skill is a documentation co-authoring workflow that guides users through structured document creation. Tool references like `create_file` and `str_replace` were misidentified as external shell commands. Documentation type keywords (spec, proposal, decision) were incorrectly flagged as cryptographic algorithms. The single network reference to claude.ai is legitimate for reader testing. No actual security risks identified.

1
Archivos escaneados
376
Líneas analizadas
0
hallazgos
1
Auditorías totales
No se encontraron problemas de seguridad
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
50
Comunidad
100
Seguridad
91
Cumplimiento de la especificación

Lo que puedes crear

Crear Especificaciones Técnicas

Redactar especificaciones técnicas completas con la estructura adecuada, asegurando que se capturen todos los detalles necesarios y que el documento sea claro para los equipos de implementación.

Redactar Documentos de Decisión

Desarrollar documentos de decisión que presenten claramente el problema, la solución propuesta, las alternativas consideradas y los resultados esperados para las partes interesadas.

Desarrollar Propuestas para el Equipo

Crear propuestas persuasivas que aborden las preocupaciones de las partes interesadas, presenten argumentos convincentes e incluyan el contexto necesario para su aprobación.

Prueba estos prompts

Iniciar Flujo de Trabajo de Documentación 
Quiero crear un [tipo de documento]. ¿Puedes guiarme a través de tu flujo de trabajo de co-autoría de documentación?
Comenzar con Plantilla 
Tengo una plantilla de documento en [URL/ruta]. ¿Puedes ayudarme a completarla usando tu flujo de trabajo de documentación estructurado?
Mejorar Documento Existente 
Tengo un documento existente que necesita mejoras. ¿Podemos usar tu flujo de trabajo para refinarlo y probarlo con una instancia nueva de IA?
Proyecto Completo de Documentación 
Necesito crear un [PRD/especificación técnica/documento de decisión] completo para [nombre del proyecto]. La audiencia es [descripción]. ¿Podemos pasar por tu flujo de trabajo completo de tres etapas?

Mejores prácticas

  • Proporciona contexto completo durante la Etapa 1 - cuanta más información compartas, mejor será la guía que recibas
  • Usa el ciclo de retroalimentación iterativa - indica cambios específicos en lugar de preferencias vagas para obtener mejores resultados
  • Completa la Prueba con Lectores - probar con una instancia nueva de IA detecta suposiciones y lagunas que son invisibles para el autor

Evitar

  • Omitir la Recopilación de Contexto - saltar directamente a la redacción sin compartir antecedentes conduce a contenido genérico y superficial
  • Proporcionar retroalimentación mínima - decir 'se ve bien' sin específicos impide que el flujo de trabajo aprenda tus preferencias
  • Omitir la Prueba con Lectores - publicar documentos sin probar puede dejar lagunas críticas que confunden a los lectores

Preguntas frecuentes

¿Cuánto tiempo toma el flujo de trabajo de documentación?
El flujo de trabajo toma el tiempo necesario para crear documentación de calidad. Los documentos simples pueden tomar 15-30 minutos. Las especificaciones técnicas complejas o propuestas pueden requerir múltiples sesiones.
¿Puedo omitir etapas si tengo prisa?
Puedes omitir etapas, pero la calidad del resultado se verá afectada. Si omites la Recopilación de Contexto, el contenido puede perder detalles críticos. Si omites la Prueba con Lectores, los lectores pueden encontrar el documento confuso.
¿Qué tipos de documentos funcionan mejor con este flujo de trabajo?
Este flujo de trabajo funciona bien para especificaciones técnicas, documentos de decisión, propuestas, PRD, documentos de diseño, RFC y cualquier contenido sustancial que necesite ser claro para los lectores.
¿Necesito herramientas o integraciones especiales?
No se requieren herramientas especiales. El flujo de trabajo funciona con acceso básico a Claude. Las integraciones como sub-agentes (Claude Code) permiten pruebas automatizadas con lectores, pero se proporcionan instrucciones de prueba manual para usuarios de la interfaz web.
¿Qué pasa si ya tengo una plantilla de documento?
Comparte tu plantilla durante la Recopilación de Contexto. El flujo de trabajo usará tu estructura y te ayudará a completar cada sección usando el proceso de lluvia de ideas y refinamiento.
¿Cómo funciona la Prueba con Lectores?
La Prueba con Lectores usa una instancia nueva de Claude (sin contexto de tu conversación actual) para responder preguntas sobre tu documento. Esto revela lagunas y suposiciones que los autores pasan por alto porque tienen todo el contexto.

Detalles del desarrollador

Licencia

MIT

Repositorio

https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection/tree/main/doc-coauthoring

Ref.

main

Estructura de archivos

📄 SKILL.md