snowtower-maintainer
Mantener documentación y archivos README de SnowTower
El desfase de documentación ocurre cuando los cambios del proyecto no se reflejan en README y docs. Esta habilidad audita la documentación, verifica enlaces y estadísticas, y asegura que CLAUDE.md y los archivos del proyecto permanezcan sincronizados con el estado real del proyecto.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "snowtower-maintainer". Check if README.md is current with the project state
النتيجة المتوقعة:
- Reporte de Salud de Documentación
- Estado de README.md: Necesita actualización
- - Badges de versión: 2 workflows tienen nuevos nombres (ci.yml → ci-pr.yml)
- - Referencias de comandos: Los 8 comandos verificados en pyproject.toml
- - Diagrama de arquitectura: Coincide con la estructura actual de snowddl/
- Estado de CLAUDE.md: Actualizado
- - Todas las referencias de agentes verificadas
- - Definiciones de patrones coinciden con la documentación
- Elementos de acción: Actualizar 2 URLs de badges en README.md
استخدام "snowtower-maintainer". Audit the .claude folder for accuracy
النتيجة المتوقعة:
- Auditoría de Configuración Claude
- Habilidades: 3 habilidades encontradas (snowtower-maintainer, snowtower-developer, snowtower-architect)
- Agentes: 12 agentes definidos
- - 2 agentes necesitan actualizaciones de descripción
- - 1 agente referencia un archivo inexistente
- Patrones: 8 patrones definidos
- - Todos los patrones referencian convenciones actuales del proyecto
- Recomendaciones: Actualizar 2 descripciones de agentes
التدقيق الأمني
آمنDocumentation-only skill providing prompts for maintaining project documentation. Static analyzer flagged bash command examples in documentation as executable code. All 61 findings are false positives - the skill contains no actual code execution, cryptographic operations, network calls, or credential access. Prior audit correctly assessed this as low risk.
عوامل الخطر
⚙️ الأوامر الخارجية (46)
🌐 الوصول إلى الشبكة (1)
📁 الوصول إلى نظام الملفات (2)
درجة الجودة
ماذا يمكنك بناءه
Auditoría de documentación pre-lanzamiento
Verificar que toda la documentación esté actualizada antes de etiquetar una nueva versión
Validación de badges CI/CD
Verificar que los badges de workflows y referencias de comandos sean precisos
Revisión de documentación de incorporación
Asegurar que la documentación refleje con precisión la estructura actual del proyecto
جرّب هذه الموجهات
Check if README.md is current by comparing the command references to pyproject.toml
Audit the .claude folder and verify CLAUDE.md reflects actual agent and pattern definitions
Find all broken links in docs/ and report which files need fixing
Perform a complete documentation audit including README, CLAUDE.md, docs/, and .claude/ folder
أفضل الممارسات
- Ejecutar auditoría de documentación después de características importantes o antes de lanzamientos
- Verificar que las referencias de comandos coincidan con los scripts reales definidos en pyproject.toml
- Verificar badges CI/CD contra los archivos de workflow reales en .github/workflows/
تجنب
- Actualizar estadísticas sin verificar los conteos reales de archivos
- Omitir verificación de enlaces después de renombrar archivos
- Olvidar actualizar documentación al agregar nuevos scripts o comandos