egutierrez
d36231d3dc
Migra todos los comandos de .claude/commands/ a .claude/skills/ siguiendo la estructura oficial de Claude Code. Skills migrados (21 total): - Configuración: init, init-jupyter, nochanges, create-skill - Git: git-branch, git-push, git-recovery - Workspace: sync-repos, list-repos, cleanup-worktrees, import-repo, create-repo - Issues: create-issue, fix-issue, auto-fix, auto-create, quick-issue, issues-status, parallel-issues, execute-parallel, sort-issues Cada skill tiene: - Carpeta propia en .claude/skills/<nombre>/ - Archivo SKILL.md con frontmatter avanzado - disable-model-invocation: true (solo usuario invoca) Incluye README.md con documentación completa de todos los skills.
121 lines
4.5 KiB
Markdown
121 lines
4.5 KiB
Markdown
# 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
|
|
├── init/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 |
|
|
|-------|-------------|-----|
|
|
| `/init` | Genera CLAUDE.md personalizado | `/init` |
|
|
| `/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/
|