file-header-guardian
Agregar comentarios de encabezado de archivo consistentes
Los equipos pierden contexto cuando los archivos fuente carecen de notas claras sobre su propósito y dependencias. Esta skill guía a Claude, Codex y Claude Code para agregar comentarios de encabezado concisos en archivos de código compatibles.
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 "file-header-guardian" from https://skillstore.io/skills/dimon94-file-header-guardian.md and its manifest at https://skillstore.io/api/skills/dimon94-file-header-guardian/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 "file-header-guardian". Se crea un nuevo archivo de servicio de usuario sin encabezado.
Resultado esperado:
La respuesta agrega un encabezado conciso que nombra la dependencia de base de datos, las operaciones del servicio y la función del módulo.
Usando "file-header-guardian". Un módulo de Python modificado ahora llama a un helper de caché, pero el encabezado está desactualizado.
Resultado esperado:
La respuesta actualiza la nota de dependencia y mantiene el propósito del módulo alineado con la implementación.
Usando "file-header-guardian". Un conjunto de cambios incluye una hoja de estilos, un archivo de declaración generado y un script de shell.
Resultado esperado:
La respuesta omite los archivos exentos y agrega el encabezado de contrato solo al archivo de script.
Auditoría de seguridad
SeguroAll seven static findings are false positives caused by Markdown code fences in SKILL.md. The skill provides file header comment templates and exemptions, with no evidence of command execution, prompt injection, data exfiltration, or malicious intent.
Factores de riesgo
⚙️ Comandos externos (7)
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/dimon94-file-header-guardian/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportInsignia Markdown
[](https://skillstore.io/skills/dimon94-file-header-guardian?utm_source=security_passport_badge)Insignia HTML
<a href="https://skillstore.io/skills/dimon94-file-header-guardian?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/dimon94-file-header-guardian/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Tarjeta para insertar
<iframe src="https://skillstore.io/embed/skills/dimon94-file-header-guardian.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
Dimon94. (2026). file-header-guardian security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/dimon94-file-header-guardian/audits/8Cita BibTeX
@techreport{dimon94-dimon94-file-header-guardian-2026,
author = {Dimon94},
title = {file-header-guardian security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/dimon94-file-header-guardian/audits/8},
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: "file-header-guardian security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "Dimon94"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/dimon94-file-header-guardian/audits/8"
identifiers:
- type: other
value: "skillstore:dimon94-file-header-guardian:audit:8"
description: "Skillstore immutable audit report identifier"
Puntuación de Skillstore
Por qué esta puntuación Confianza de la evidencia: AltoLo que puedes crear
Estandarizar nuevos servicios
Agregar notas de propósito y dependencias al crear nuevos archivos de servicios de aplicación.
Revisar desviaciones en la documentación
Comprobar que los encabezados de archivo sigan coincidiendo con el comportamiento después de cambios en el código.
Mantener trazable el trabajo de los agentes
Ayudar a que las sesiones de programación con IA dejen contexto conciso para futuros mantenedores.
Prueba estos prompts
Crea este archivo fuente y agrega el comentario de encabezado requerido con @input, @output y @pos antes de la implementación.
Revisa este archivo modificado y actualiza su comentario de encabezado para que las dependencias, exportaciones y función en el sistema sean precisas.
Revisa estos archivos modificados y agrega encabezados solo donde se aplique la skill. Omite archivos de configuración, estilo, generados y dependencias.
Audita esta carpeta de funcionalidad, actualiza los encabezados de archivo aplicables y alinea las notas del CLAUDE.md del directorio relacionado con las funciones actuales de los archivos.
Mejores prácticas
- Escribe encabezados después de entender las dependencias reales y el comportamiento exportado.
- Mantén cada encabezado lo bastante breve como para mantenerlo durante una revisión de código normal.
- Actualiza la documentación del directorio cuando las funciones de los archivos cambien de forma significativa.
Evitar
- No agregues encabezados genéricos que solo repitan el nombre del archivo.
- No fuerces encabezados en archivos exentos generados, de configuración, de estilo o de dependencias.
- No dejes el encabezado sin cambios después de modificar dependencias o la responsabilidad del módulo.