/ Directorio / Playground / skill-optimizer
● Comunidad hqhq1025 ⚡ Instantáneo

skill-optimizer

por hqhq1025 · hqhq1025/skill-optimizer

Audita un único SKILL.md usando datos reales de sesión más análisis estático — te dice exactamente qué cambiar.

skill-optimizer analiza un SKILL.md desde dos perspectivas: (1) registros de sesión — ¿se activó cuando era esperado, fue útil el resultado — y (2) análisis estático — ¿está limpio el frontmatter, está la descripción correctamente limitada por intención, están calibrados los ejemplos. Genera ediciones concretas que puedes aplicar. Combina bien con SkillCompass (que hace ranking a nivel de bundle).

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

skill-optimizer-skill.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "skill-optimizer-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/hqhq1025/skill-optimizer",
        "~/.claude/skills/skill-optimizer"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "skill-optimizer-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/hqhq1025/skill-optimizer",
        "~/.claude/skills/skill-optimizer"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "skill-optimizer-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/hqhq1025/skill-optimizer",
        "~/.claude/skills/skill-optimizer"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "skill-optimizer-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/hqhq1025/skill-optimizer",
        "~/.claude/skills/skill-optimizer"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "skill-optimizer-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/hqhq1025/skill-optimizer",
        "~/.claude/skills/skill-optimizer"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "skill-optimizer-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/hqhq1025/skill-optimizer",
          "~/.claude/skills/skill-optimizer"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add skill-optimizer-skill -- git clone https://github.com/hqhq1025/skill-optimizer ~/.claude/skills/skill-optimizer

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: skill-optimizer

Cómo diagnosticar y reparar un skill con bajo rendimiento

👤 Autores de skills iterando en un skill específico ⏱ ~30 min intermediate

Cuándo usarlo: Notas que un skill nunca se activa, o se activa incorrectamente.

Requisitos previos
  • Registros de sesión o transcripciones — Claude Code almacena trazas localmente; skill-optimizer las lee
  • Skill clonado — git clone https://github.com/hqhq1025/skill-optimizer ~/.claude/skills/skill-optimizer
Flujo
  1. Apúntalo al skill
    Analiza ~/.claude/skills/my-skill/SKILL.md usando los registros de sesión de las últimas 2 semanas.✓ Copiado
    → Hallazgos estáticos + en tiempo real
  2. Revisa el parche
    Muéstrame el diff propuesto de SKILL.md.✓ Copiado
    → Diff mínimo y revisable
  3. Aplica y valida
    Aplica el parche y dime en qué fijarme esta semana.✓ Copiado
    → Lista de validación

Resultado: Una mejora dirigida con un plan de rendición de cuentas.

Errores comunes
  • Optimizar por tasa de activación pero romper el alcance — Incluye una métrica de aceptación de 'tasa de falsos positivos'
Combinar con: skillcompass-skill

Pule tu primer SKILL.md antes de publicar

👤 Autores de skills por primera vez ⏱ ~20 min beginner

Cuándo usarlo: Escribiste un SKILL.md y quieres revisión experta antes de publicar.

Flujo
  1. Pide una revisión
    Revisa mi SKILL.md contra los chequeos estáticos de skill-optimizer.✓ Copiado
    → Lista de verificación con aprobado/reprobado + razonamiento
  2. Repara problemas
    Aplica las correcciones y muéstrame la versión final.✓ Copiado
    → SKILL.md limpio

Resultado: Un SKILL.md listo para publicar.

Errores comunes
  • Prometer demasiado en la descripción — Sé específico sobre qué hace el skill; Claude lo usa para decidir la activación

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

skill-optimizer-skill + skillcompass-skill

SkillCompass clasifica el bundle; skill-optimizer se sumerge en el peor infractor

Usa SkillCompass para elegir el skill más débil, luego optimiza su SKILL.md.✓ Copiado
skill-optimizer-skill + filesystem

Aplica parches SKILL.md directamente

Aplica el diff propuesto a ~/.claude/skills/my-skill/SKILL.md.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
static-analysis Ruta SKILL.md Antes de publicar o durante la iteración 0
log-based-analysis registros + ruta del skill Ajuste posterior al uso 0
patch-generation hallazgos Después del análisis 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
ninguno más allá de LLM
Tokens por llamada
2–10k por análisis de skill
Monetario
gratuito
Consejo
El análisis estático es prácticamente gratuito; el análisis de registros cuesta más — ejecútalo solo al iterar

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: ninguno; los registros pueden contener prompts sensibles — trata su ruta con cuidado
Salida de datos: ninguno

Resolución de problemas

Errores comunes y soluciones

No se encontraron registros

Confirma la ruta de traza de Claude Code; pasa la ruta explícitamente si es no predeterminada.

Las sugerencias entran en conflicto con el alcance previsto

Dile al optimizador tus restricciones de alcance; puede respetar objetivos negativos

Alternativas

skill-optimizer vs otros

AlternativaCuándo usarlaContrapartida
skillcompass-skillNecesitas ranking a nivel de bundle, no profundidad de un solo skillAmplitud sobre profundidad

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills