Skills para agentes de IA
La skill de Kombine le enseña a un agente de IA a usar tu cuenta de Kombine: qué peticiones hacer, qué significan los campos y qué hacer cuando algo falla. Cuando la tengas instalada, solo tienes que pedírselo:
- “¿Qué vence hoy?”
- “Añade una tarea para llamar al banco mañana, prioridad alta.”
- “Marca como hecha la tarea del pasaporte.”
- “Registra 45 minutos de trabajo profundo en la migración.”
- “¿Cuántas sesiones de concentración hice esta semana? ¿Cómo va mi racha?”
- “¿Hay un temporizador en marcha en mi móvil?”
Funciona en Claude Code, Codex, Cursor, GitHub Copilot y otros agentes compatibles con Agent Skills. La skill es gratuita y de código abierto: github.com/asvid/kombine-skills.
Antes de cambiar nada, el agente te muestra lo que va a crear, cambiar o eliminar y espera a que le des el OK.
1. Crea un token
Sección titulada «1. Crea un token»El agente usa un token de acceso personal. Crea uno en app.kombine.dev en Ajustes › Cuenta › Tokens de acceso personal y dale solo lo que quieras que haga el agente:
| Quieres que el agente… | Permisos |
|---|---|
| Responda preguntas sobre tus tareas y estadísticas | tasks, sessions, stats, timer: Lectura |
| Además añada, edite y complete tareas | tasks: Lectura y escritura |
| Además registre sesiones de concentración | sessions: Lectura y escritura |
| Además trabaje con tus objetivos | goals: Lectura o Lectura y escritura |
2. Dale el token a tu agente
Sección titulada «2. Dale el token a tu agente»Guarda el token en una variable de entorno llamada KOMBINE_TOKEN. Añade esta línea a tu perfil de shell (~/.zshrc en un Mac, ~/.bashrc en la mayoría de sistemas Linux):
export KOMBINE_TOKEN='kmb_pat_…'Después abre una terminal nueva y reinicia tu agente para que lea la variable.
No pegues el token en un chat con el agente. Los chats se guardan y el token acabaría en ellos.
3. Instala la skill
Sección titulada «3. Instala la skill»En Claude Code, ejecuta estos dos comandos:
/plugin marketplace add asvid/kombine-skills/plugin install kombine@kombineReinicia Claude Code. Para recibir actualizaciones más adelante, ejecuta /plugin marketplace update kombine.
Con Node.js instalado, ejecuta esto en una terminal:
npx skills add asvid/kombine-skillsTe pregunta para qué agentes instalar la skill. Para actualizarla más adelante, ejecuta npx skills update.
La skill es un solo archivo de texto. Descarga SKILL.md y guárdalo en una carpeta llamada kombine dentro de la carpeta de skills de tu agente:
| Agente | Guárdalo como |
|---|---|
| Claude Code | ~/.claude/skills/kombine/SKILL.md |
| Otros agentes | kombine/SKILL.md en la carpeta de skills que indique la documentación de tu agente |
O en una terminal:
mkdir -p ~/.claude/skills/kombinecurl -o ~/.claude/skills/kombine/SKILL.md \ https://raw.githubusercontent.com/asvid/kombine-skills/main/skills/kombine/SKILL.mdPara actualizarla, descárgala de nuevo.
La skill no necesita nada más instalado: solo usa curl, que ya viene con macOS y Linux.
4. Pruébala
Sección titulada «4. Pruébala»Pregúntale a tu agente “¿qué vence hoy en Kombine?”. Si dice que falta el token, comprueba que echo $KOMBINE_TOKEN muestra algo en una terminal nueva y luego reinicia el agente.
| El agente dice | Qué hacer |
|---|---|
Token caducado o revocado (401) |
Crea un token nuevo y actualiza KOMBINE_TOKEN |
El token no permite esto (403) |
Crea un token con el permiso que necesita (consulta el paso 1) |
Demasiadas peticiones (429) |
Espera un minuto. Un token permite 60 peticiones por minuto |
Quitarla
Sección titulada «Quitarla»Elimina el token en Ajustes › Cuenta › Tokens de acceso personal. Eso detiene al agente al instante, esté donde esté instalada la skill. Después quita la skill: /plugin uninstall kombine@kombine en Claude Code, npx skills remove kombine, o elimina la carpeta kombine que creaste.
Para tus propios scripts e importadores, consulta Flujos de trabajo.