# Skills Claude disponibles

Todos los skills siguen la estructura oficial de Claude Code con archivos `SKILL.md`.

## Estructura

```
.claude/skills/
├── README.md                    # Este archivo
├── init-jupyter/SKILL.md        # Inicializar proyecto Jupyter
├── primer/SKILL.md              # Inicializar CLAUDE.md
├── nochanges/SKILL.md           # Modo read-only
├── create-skill/SKILL.md        # Crear nuevos skills
├── git-branch/SKILL.md          # Crear ramas
├── git-push/SKILL.md            # Integrar a master
├── git-recovery/SKILL.md        # Recuperar repo
├── sync-repos/SKILL.md          # Sincronizar con Gitea
├── list-repos/SKILL.md          # Listar workspaces
├── cleanup-worktrees/SKILL.md   # Limpiar worktrees
├── import-repo/SKILL.md         # Importar repos
├── create-repo/SKILL.md         # Crear workspace
├── create-issue/SKILL.md        # Crear issue
├── fix-issue/SKILL.md           # Implementar issue
├── auto-fix/SKILL.md            # Auto-implementar issue
├── auto-create/SKILL.md         # Auto-crear issue
├── quick-issue/SKILL.md         # Issue rápido (TUI)
├── issues-status/SKILL.md       # Dashboard de issues
├── parallel-issues/SKILL.md     # Plan de ejecución paralela
├── execute-parallel/SKILL.md    # Ejecutar plan paralelo
└── sort-issues/SKILL.md         # Ordenar issues por deps
```

## Skills por categoría

### Configuración

| Skill | Descripción | Uso |
|-------|-------------|-----|
| `/primer` | Genera CLAUDE.md personalizado | `/primer` |
| `/init-jupyter` | Inicializa proyecto Jupyter con MCP | `/init-jupyter [ruta]` |
| `/nochanges` | Modo read-only para conversar | `/nochanges [tema]` |
| `/create-skill` | Crea un nuevo skill | `/create-skill nombre` |

### Git

| Skill | Descripción | Uso |
|-------|-------------|-----|
| `/git-branch` | Crea rama issue/* o quick/* | `/git-branch issue 0013 hot-reload` |
| `/git-push` | Integra rama a master y publica | `/git-push` |
| `/git-recovery` | Recupera repo de estados inconsistentes | `/git-recovery [--aggressive]` |

### Workspace

| Skill | Descripción | Uso |
|-------|-------------|-----|
| `/sync-repos` | Sincroniza con Gitea | `/sync-repos [--dry-run]` |
| `/list-repos` | Lista workspaces | `/list-repos [--filter x]` |
| `/cleanup-worktrees` | Limpia worktrees | `/cleanup-worktrees NNNN` |
| `/import-repo` | Importa repo existente | `/import-repo` |
| `/create-repo` | Crea nuevo workspace | `/create-repo` |

### Issues

| Skill | Descripción | Uso |
|-------|-------------|-----|
| `/create-issue` | Crea issue con confirmación | `/create-issue` |
| `/fix-issue` | Implementa issue completo | `/fix-issue 0013` |
| `/auto-fix` | Implementa sin confirmación | `/auto-fix 0013` |
| `/auto-create` | Crea issue sin confirmación | `/auto-create` |
| `/quick-issue` | Issue rápido desde TUI | `/quick-issue --text "..."` |
| `/issues-status` | Dashboard de issues | `/issues-status [workspace]` |
| `/parallel-issues` | Genera plan paralelo | `/parallel-issues` |
| `/execute-parallel` | Ejecuta plan paralelo | `/execute-parallel` |
| `/sort-issues` | Ordena por dependencias | `/sort-issues` |

## Diferencia entre Skills y Commands

Los **skills** reemplazan a los antiguos commands:

| Aspecto | Commands (obsoleto) | Skills (actual) |
|---------|---------------------|-----------------|
| Ubicación | `.claude/commands/*.md` | `.claude/skills/*/SKILL.md` |
| Invocación "/" | Sí | Sí |
| Invocación automática | No | Sí (configurable) |
| Frontmatter | Básico | Avanzado |

## Crear nuevos skills

```bash
/create-skill nombre-del-skill
```

## Campos del frontmatter

```yaml
---
name: nombre-skill
description: Qué hace y cuándo usarlo
argument-hint: [archivo] [formato]
disable-model-invocation: true    # Solo usuario invoca
user-invocable: false             # Solo Claude invoca
allowed-tools: Read, Grep, Bash   # Sin confirmación
context: fork                     # Ejecutar en subagente
---
```

## Convenciones

- **Nombres**: minúsculas con guiones (`code-review`, no `codeReview`)
- **Descripciones**: claras para que Claude sepa cuándo invocar
- **Un skill por tarea**: mantener enfocados
- **Confirmación**: la mayoría tiene `disable-model-invocation: true`

## Trunk-based development

Todos los skills siguen:
- **Una rama por tarea**: corta (horas, no días)
- **Merge rápido**: integrar frecuentemente
- **Tests obligatorios**: siempre antes de merge
- **Pure core / Impure shell**: funciones puras en core/, I/O en shell/
