Publicación de Skills y uso compartido en equipo
Una Skill completada debe pasar por empaquetado, pruebas y documentación antes de poder distribuirse a los miembros del equipo o publicarse públicamente.
Este artículo presenta el flujo completo desde el desarrollo hasta la publicación.
Lista de verificación antes de la publicación
Antes de publicar, confirma cada elemento para evitar distribuir una Skill incompleta o con defectos.
| Elemento de verificación | Contenido de la verificación | Sección de referencia |
|---|---|---|
| Funcionalidad completa | Todas las funciones planificadas están implementadas y probadas | Artículo 22 |
| Manejo de errores | Los escenarios de error comunes tienen manejo y avisos | Artículo 16 |
| Descripción precisa | Tasa de aprobación de pruebas de activación ≥ 85% | Artículo 24 |
| Dependencias declaradas | requirements.txt o el campo compatibility está completo | Artículo 20 |
| Sin claves codificadas | Sin información sensible como claves API o contraseñas en los scripts | Artículo 28 |
| Número de versión actualizado | El campo version en SKILL.md está actualizado | Artículo 21 |
| CHANGELOG actualizado | Los cambios de esta versión están registrados | Artículo 21 |
| Código de depuración eliminado | Sin print temporales, puntos de control de depuración ni TODO | Artículo 23 |
Empaquetar como archivo .skill
Antes de publicar, se debe empaquetar el directorio de la Skill como.skillarchivo, que es el formato estándar distribuible.
Ejemplo
# Comando básico de empaquetado
python -m scripts.package_skill my-skill/
# Especificar la ruta de salida y el número de versión
python -m scripts.package_skill my-skill/ \
--output dist/my-skill-v1.2.0.skill \
--version 1.2.0
# Verificar la integridad del archivo después del empaquetado (listar los archivos dentro del paquete)
python -m scripts.package_skill --list dist/my-skill-v1.2.0.skill
python -m scripts.package_skill my-skill/
# Especificar la ruta de salida y el número de versión
python -m scripts.package_skill my-skill/ \
--output dist/my-skill-v1.2.0.skill \
--version 1.2.0
# Verificar la integridad del archivo después del empaquetado (listar los archivos dentro del paquete)
python -m scripts.package_skill --list dist/my-skill-v1.2.0.skill
打包完成：dist/my-skill-v1.2.0.skill（共 8 个文件，42KB） 包含： SKILL.md scripts/process.py scripts/requirements.txt assets/template.xlsx
Redactar documentación de usuario
Proporciona instrucciones completas de usuario al final de SKILL.md o en un README.md separado.
# 数据分析助手 v1.2.0 ## 这个 Skill 能做什么 上传 CSV o Excel 文件后，自动完成以下工作： - 统计各列的行数、均值、最大/最小值、空值比例 - 生成数据质量报告，标注需要清理的问题列 - 输出带统计图表的 Excel 报告文件 ## 快速开始 1. 在对话中上传你的数据文件（.csv o .xlsx） 2. 说："帮我分析这份数据" o "生成统计报告" 3. 等待分析完成，下载生成的 Excel 报告 ## 系统要求 - Python 3.8+ - pandas >= 2.0（首次运行时自动安装） ## 常见问题 **Q：文件太大怎么办？** 建议文件不超过 50MB。更大的文件请先筛选或抽样后上传。 **Q：支持哪些编码？** 支持 UTF-8 和 GBK。若文件乱码，请另存为 UTF-8 后重新上传。
Canales de distribución
| Canal | Escenario aplicable | Método de operación |
|---|---|---|
| Enviar archivo directamente | Uso compartido interno en equipos pequeños | Enviar el archivo .skill, la otra parte lo sube a Claude |
| Repositorio Git | Colaboración en equipo, requiere gestión de versiones | Enviar a un repositorio privado/público, descargar desde dist/ |
| GitHub Releases | Publicación oficial, uso compartido público | Crear un Release, adjuntando el archivo .skill |
| CI/CD interno | Distribución automatizada dentro de la empresa | CI empaqueta y envía al servidor de archivos interno |
Publicación mediante GitHub Releases
Ejemplo
# Crear una etiqueta Git y enviarla
git tag v1.2.0 -m "Publicar v1.2.0: nueva función de generación de gráficos"
git push origin v1.2.0
# Usar GitHub CLI para crear un Release y adjuntar el archivo .skill
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "My Skill v1.2.0" \
--notes "Nueva función de generación de gráficos, se corrigió el problema de memoria al procesar archivos grandes"
git tag v1.2.0 -m "Publicar v1.2.0: nueva función de generación de gráficos"
git push origin v1.2.0
# Usar GitHub CLI para crear un Release y adjuntar el archivo .skill
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "My Skill v1.2.0" \
--notes "Nueva función de generación de gráficos, se corrigió el problema de memoria al procesar archivos grandes"
Plantilla de página de guía de instalación
Si tu Skill está destinada a ser utilizada por varias personas, puedes escribir una guía concisa específica para los pasos de instalación.
## 安装方法 1. 前往 [Release 页面](https://github.com/yourname/skills/releases/latest) 2. 下载 `my-skill-v1.2.0.skill` 文件 3. 打开 Claude.ai → Settings（设置）→ Skills 4. 点击"上传 Skill"，选择下载的 .skill 文件 5. 安装完成后，开始新对话即可使用 安装后，在对话中发送以下内容可以验证安装成功： > "我上传了一个 CSV 文件，请帮我做数据统计分析" 若 Skill 正常工作，Claude 会按照 Skill 的流程引导你完成分析。Otras extensiones