docs-validator
Validar la calidad de la documentación
La documentación puede desactualizarse a medida que cambian archivos, enlaces, ejemplos y módulos. Esta skill guía a Claude, Codex y Claude Code mediante una validación estructurada.
Instalar con mi Agente
Copia esta solicitud en tu Agente. Incluye la página canónica del Skill y el manifiesto.
Review the Skillstore skill "docs-validator" from https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator.md and its manifest at https://skillstore.io/api/skills/c0ntr0lledcha0s-docs-validator/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Tu Agente debe seguir mostrando su plan y solicitar cualquier confirmación exigida por la política de seguridad.
Recursos legibles por agentes
Usa estos enlaces cuando un agente de IA, crawler o script necesite contexto limpio en vez de leer la página completa.
Pruébalo
Usando "docs-validator". Validar documentación.
Resultado esperado:
Estado general: bueno. Problemas principales: un README de módulo faltante, un enlace de instalación roto y dos bloques de código sin etiquetas de idioma.
Usando "docs-validator". Comprobar enlaces rotos.
Resultado esperado:
Se encontró un enlace externo roto y un destino interno faltante. Las correcciones sugeridas incluyen una URL de descarga de reemplazo y una ruta corregida de la guía de configuración.
Usando "docs-validator". Comprobar la cobertura de documentación de módulos.
Resultado esperado:
La cobertura de README de módulos está casi completa. La brecha de mayor prioridad es el módulo sin documentar más grande, seguida de ejemplos incompletos.
Auditoría de seguridad
Riesgo medioAll 42 static findings are false positives caused by Markdown fences, safe read-only shell examples, placeholder URLs, a relative link, and checklist prose. Semantic review identified two medium risks: unrestricted external URL testing and optional execution of documentation examples without explicit isolation controls.
Preocupaciones de seguridad confirmadas (2)
Factores de riesgo
⚙️ Comandos externos (37)
🌐 Acceso a red (3)
📁 Acceso al sistema de archivos (1)
Compartir y citar este informe
Comparte el informe de evaluación versionado, la insignia neutral, la tarjeta insertable y las citas. Skillstore presenta evidencias sin decidir si este Skill es seguro.
Copiar enlace del informe
https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportInsignia Markdown
[](https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator?utm_source=security_passport_badge)Insignia HTML
<a href="https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/c0ntr0lledcha0s-docs-validator/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Tarjeta para insertar
<iframe src="https://skillstore.io/embed/skills/c0ntr0lledcha0s-docs-validator.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Citas académicas (APA · BibTeX · CFF)
Cita APA
C0ntr0lledCha0s. (2026). docs-validator security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator/audits/9Cita BibTeX
@techreport{c0ntr0lledcha0s-c0ntr0lledcha0s-docs-validator-2026,
author = {C0ntr0lledCha0s},
title = {docs-validator security audit report (audit version 9)},
institution = {Skillstore},
year = {2026},
number = {9},
url = {https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator/audits/9},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "docs-validator security audit report (audit version 9)"
version: "unspecified"
type: report
authors:
- name: "C0ntr0lledCha0s"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator/audits/9"
identifiers:
- type: other
value: "skillstore:c0ntr0lledcha0s-docs-validator:audit:9"
description: "Skillstore immutable audit report identifier"
Puntuación de Skillstore
Por qué esta puntuación Confianza de la evidencia: AltoLo que puedes crear
Preparar la documentación de una versión
Comprueba guías, README de módulos, enlaces y ejemplos antes de finalizar una rama de versión.
Auditar la cobertura de módulos
Identifica archivos README faltantes y explicaciones débiles de módulos en todo el árbol de código fuente.
Revisar la calidad de la documentación
Encuentra problemas de formato, terminología y estados obsoletos durante el mantenimiento rutinario de la documentación.
Prueba estos prompts
Valida la documentación de este repositorio. Informa de los principales problemas, los archivos afectados y las correcciones rápidas.
Comprueba los enlaces de la documentación. Separa los enlaces internos y externos, informa de los destinos rotos y sugiere destinos corregidos.
Audita la cobertura de documentación de módulos. Enumera los módulos con archivos README faltantes o débiles y clasifica las correcciones por impacto.
Ejecuta una auditoría completa de documentación sobre integridad, precisión, formato, enlaces, cobertura y coherencia. Proporciona recomendaciones priorizadas.
Mejores prácticas
- Ejecuta comprobaciones rápidas antes de pequeñas ediciones de documentación y auditorías completas antes de los lanzamientos.
- Revisa las comprobaciones sugeridas de shell o red antes de ejecutarlas en un repositorio.
- Prioriza primero los enlaces rotos, la documentación faltante de módulos principales y los comandos incorrectos.
Evitar
- No ejecutes ejemplos de código arbitrarios de la documentación sin revisarlos primero.
- No trates los recuentos de ejemplo o los ejemplos de informes como datos verificados del proyecto.
- No publiques correcciones sin comprobar que las rutas y los anchors existen.
Preguntas frecuentes
¿Qué documentación revisa esta skill?
¿Puede encontrar enlaces rotos?
¿Requiere acceso a la red?
¿Editará la documentación automáticamente?
¿Pueden usarla Claude, Codex y Claude Code?
¿Está limitada a un solo repositorio?
Detalles del desarrollador
Autor
C0ntr0lledCha0sLicencia
MIT
Revisión de Skillstore
r2
Aviso de versión
El autor no declaró una versión.
Repositorio
https://github.com/C0ntr0lledCha0s/logseq-template-graph/tree/main/.claude/skills/docs-validatorRef.
a39a91716eadede5f4cdefd78178fed4e837a128
Actualidad del mantenimiento
25/7/2026
Uso
6 descargas · 236 vistas
Estructura de archivos
📄 SKILL.md