Skiller

Repositorio híbrido de Agent Skills para Claude Code y Cursor Rules para Cursor IDE. Este proyecto centraliza skills/reglas reutilizables que pueden importarse fácilmente a cualquier proyecto.

Compatibilidad

Editor	Sistema	Formato	Directorio
Claude Code	Agent Skills	SKILL.md	skills/
Cursor IDE	Cursor Rules	.mdc	cursor-rules/

¿Qué son las Agent Skills? (Claude Code)

Las Agent Skills son módulos que extienden las capacidades de Claude Code. Cada skill es un directorio que contiene:

• SKILL.md (obligatorio): Archivo con frontmatter YAML y contenido Markdown
• Archivos de soporte (opcionales): Scripts, plantillas, documentación

Claude descubre automáticamente las skills y las usa según el contexto.

¿Qué son las Cursor Rules? (Cursor IDE)

Las Cursor Rules son reglas que proporcionan contexto al agente de Cursor. Cada regla es un archivo .mdc:

• Frontmatter YAML: Define description, globs, y alwaysApply
• Contenido Markdown: Instrucciones y documentación

Cursor aplica las reglas automáticamente según los patrones de archivo definidos.

Estructura del repositorio

Skiller/
├── README.md                           # Este archivo
├── INSTALLATION.md                     # Instrucciones de instalación
├── skills/                             # Skills para Claude Code
│   ├── markdown-to-docx/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   │   └── convert.sh
│   │   └── templates/
│   │       └── reference.docx
│   └── markdown-to-html/
│       ├── SKILL.md
│       ├── scripts/
│       │   └── convert.sh
│       └── assets/
│           └── *.png, *.jpg
├── cursor-rules/                       # Reglas para Cursor IDE
│   ├── markdown-to-docx/               # Todo en una carpeta autocontenida
│   │   ├── markdown-to-docx.mdc
│   │   ├── scripts/
│   │   │   └── convert.sh
│   │   └── templates/
│   │       └── reference.docx
│   └── markdown-to-html/               # HTML single-file
│       ├── markdown-to-html.mdc
│       ├── scripts/
│       │   └── convert.sh
│       └── assets/
│           └── *.png, *.jpg
└── ejemploFormato/                     # Ejemplos de formato de referencia

Nota: Para Cursor, toda la carpeta markdown-to-docx/ se copia a .cursor/rules/, manteniendo scripts y templates organizados dentro de .cursor/rules/markdown-to-docx/.

Skills/Reglas disponibles

Nombre	Descripción	Claude Code	Cursor
markdown-to-docx	Convierte Markdown a DOCX con pandoc	skills/	cursor-rules/
markdown-to-html	Convierte Markdown a HTML single-file con estilos corporativos	skills/	cursor-rules/

Instalación rápida

Para Claude Code

# Skill en proyecto
mkdir -p /ruta/proyecto/.claude/skills
cp -r skills/markdown-to-docx /ruta/proyecto/.claude/skills/

# Skill personal
mkdir -p ~/.claude/skills
cp -r skills/markdown-to-docx ~/.claude/skills/

Para Cursor IDE

# Regla en proyecto (con todos los recursos en subcarpeta)
mkdir -p /ruta/proyecto/.cursor/rules
cp -r cursor-rules/markdown-to-docx /ruta/proyecto/.cursor/rules/

# Regla global (usuario)
mkdir -p ~/.cursor/rules
cp -r cursor-rules/markdown-to-docx ~/.cursor/rules/

Consulta INSTALLATION.md para instrucciones detalladas.

Crear nuevas skills/reglas

Para Claude Code (SKILL.md)

---
name: nombre-de-la-skill
description: Descripción breve de qué hace y cuándo usarla.
---

# Nombre de la Skill

## Instrucciones
Pasos claros para Claude.

## Ejemplos
Ejemplos concretos de uso.

Para Cursor IDE (.mdc)

---
description: "Descripción breve de qué hace y cuándo usarla."
globs:
  - "**/*.md"
alwaysApply: false
---

# Nombre de la Regla

## Instrucciones
Pasos claros para el agente de Cursor.

## Ejemplos
Ejemplos concretos de uso.

Diferencias clave entre formatos

Campo	Claude Code (SKILL.md)	Cursor (.mdc)
Nombre	name:	No requerido (usa nombre de archivo)
Descripción	description:	description:
Patrones archivo	No aplica	globs:
Siempre activa	No aplica	alwaysApply:

Dependencias globales

Algunas skills/reglas requieren herramientas externas:

• pandoc: Para conversión de documentos (brew install pandoc)
• LibreOffice: Para manipulación avanzada de documentos (opcional)

Buenas prácticas

1. Mantén las skills enfocadas: Una skill = una capacidad específica
2. Descripciones claras: Incluye qué hace y cuándo usarla
3. Documenta dependencias: Lista herramientas externas necesarias
4. Sincroniza formatos: Si creas para un editor, considera crear para ambos
5. Prueba antes de compartir: Verifica que se active correctamente

Licencia

MIT License - Siéntete libre de usar, modificar y distribuir estas skills/reglas.

Contribuir

1. Crea un directorio en skills/ y/o cursor-rules/ con el nombre de tu skill
2. Añade SKILL.md (Claude Code) y/o *.mdc (Cursor)
3. Incluye scripts y recursos necesarios
4. Actualiza este README con la nueva skill
5. Envía un Pull Request