cat > /mnt/user-data/outputs/2026-05-18/skills-ecosystem.html << 'HTMLEOF'

Construcción de un ecosistema de Skills personalizados

Cuando un equipo ha acumulado múltiples Skills, cómo organizarlos, gestionarlos y distribuirlos de manera unificada es el problema central para construir un "ecosistema privado de Skills".


Tres niveles del ecosistema

NivelContenidoObjetivo
Biblioteca de SkillsRepositorio Git que gestiona de forma unificada todos los SkillsControl de versiones, trazabilidad
Mecanismo de distribuciónAlmacenamiento y canal de distribución de los archivos empaquetados .skillPermitir que los miembros del equipo instalen rápidamente
Centro de documentaciónInstrucciones de uso y escenarios aplicables de cada SkillReducir el costo de aprendizaje

Estructura unificada del repositorio

Se recomienda colocar todos los Skills del equipo en un mismo repositorio Git, utilizando directorios para aislar los diferentes Skills.

skills-repo/
├── README.md                  # 仓库总览,列出所有 Skill
├── .github/
│   └── workflows/
│       └── package.yml        # CI:自动打包 .skill 文件
├── skills/
│   ├── data-analyzer/         # Skill 1
│   │   ├── SKILL.md
│   │   └── scripts/
│   ├── doc-generator/         # Skill 2
│   │   ├── SKILL.md
│   │   └── scripts/
│   └── code-reviewer/         # Skill 3
│       ├── SKILL.md
│       └── scripts/
├── dist/                      # 打包好的 .skill 文件
│   ├── data-analyzer.skill
│   ├── doc-generator.skill
│   └── code-reviewer.skill
└── tools/
    └── build_all.sh           # 批量打包脚本

Script de empaquetado por lotes

Ejemplo

#!/bin/bash
# Ruta del archivo: tools/build_all.sh
# Empaqueta todos los Skills como archivos .skill y los exporta al directorio dist/

set -e  # Sale inmediatamente si se encuentra un error

SKILLS_DIR="skills"
DIST_DIR="dist"
mkdir -p "$DIST_DIR"

echo Iniciando empaquetado de todos los Skills...

for skill_dir in "$SKILLS_DIR"/*/; do
    skill_name=$(basename "$skill_dir")
    echo Empaquetando:$skill_name"

    python -m scripts.package_skill "$skill_dir" \
      --output "$DIST_DIR/${skill_name}.skill"

    echo Completado:$DIST_DIR/${skill_name}.skill"
done

echo ""
echo Empaquetado completado, un total de$(ls $DIST_DIR/*.skill | wc -l)Skills.
开始打包所有 Skill...
  正在打包:data-analyzer
  完成:dist/data-analyzer.skill
  正在打包:doc-generator
  完成:dist/doc-generator.skill
  正在打包:code-reviewer
  完成:dist/code-reviewer.skill

全部打包完成,共 3 个 Skill。

Empaquetado automatizado con GitHub Actions

Cada vez que se envía código a la rama principal, se empaquetan automáticamente todos los Skills y se publican como adjuntos de Release.

Ejemplo

# Ruta del archivo: .github/workflows/package.yml
name
: Empaquetar y publicar Skills

on
:
  push
:
    branches
: [main]      # Se activa al hacer push a la rama main
  release
:
    types
: [created]       # También se activa al crear un Release

jobs
:
  build
:
    runs-on
: ubuntu-latest
    steps
:
      - name
: Obtener el código
        uses
: actions/checkout@v4

      - name
: Instalar Python
        uses
: actions/setup-python@v5
        with
:
          python-version
: "3.11"

      - name
: Instalar dependencias de la herramienta de empaquetado
        run
: pip install -r tools/requirements.txt

      - name
: Empaquetar Skills por lotes
        run
: bash tools/build_all.sh

      - name
: Subir archivos .skill como artefactos de compilación
        uses
: actions/upload-artifact@v4
        with
:
          name
: skill-packages
          path
: dist/*.skill
          retention-days
: 30   # Conservar durante 30 días

Registro de Skills

Cuando la cantidad de Skills aumenta, se utiliza un registro JSON para gestionar la metainformación de todos los Skills, facilitando la búsqueda y la instalación bajo demanda.

Ejemplo

{
  "registry_version": "1.0",
  "updated_at": "2026-05-18",
  "skills": [
    {
      "name":        "data-analyzer",
      "version":     "1.2.0",
      "description": Analizar datos de Excel/CSV y generar informes estadísticos,
      "tags":        [Datos, "Excel", "CSV", Estadísticas],
      "file":        "dist/data-analyzer.skill",
      "requires":    ["python>=3.8", "pandas>=2.0"]
    },
    {
      "name":        "doc-generator",
      "version":     "2.0.1",
      "description": Generar documentos Word/PDF a partir de plantillas,
      "tags":        [Documentos, "Word", "PDF", Plantillas],
      "file":        "dist/doc-generator.skill",
      "requires":    ["python>=3.8", "python-docx>=1.0"]
    }
  ]
}

Lista de distribución de Skills del equipo

Prepara una lista de instalación de Skills para los nuevos miembros del equipo, para que puedan configurar rápidamente todos los Skills de uso común.

# 团队 Skills 安装指南

## 必装 Skills(所有成员)

| Skill | 用途 | 下载地址 |
|-------|------|---------|
| data-analyzer | 数据分析与报表 | dist/data-analyzer.skill |
| doc-generator | 文档自动生成 | dist/doc-generator.skill |

## 按需安装

| Skill | 适合角色 | 下载地址 |
|-------|---------|---------|
| code-reviewer | 开发人员 | dist/code-reviewer.skill |

## 安装方式
1. 下载 .skill 文件
2. 在 Claude.ai 的 Settings → Skills 中上传文件
3. 安装完成后重新开始对话即可生效
Otras extensiones