Skills de Agente

3 skills

Workflows instalables para tu agente de IA. No son prompts de chat: leen tus archivos, ejecutan comandos y generan entregables.

Ver repo

Esto no se usa en un chat

Una skill es un contrato en Markdown más sus assets. El agente la carga, lee tus archivos y ejecuta los comandos. Un chat web no tiene ese acceso.

Chat AI

Pegás texto y recibís texto.
No lee tu carpeta de skills ni tus PDFs locales.
No ejecuta los CLIs del repo ni escribe en tu disco.
No mantiene state/ entre conversaciones.

Agente con skills

Lee SKILL.md, assets y tu perfil.
Accede a archivos y ejecuta comandos.
Escribe en output/ y guarda state/.
Es el mismo agente que usás para programar.

Apps para usar las skills

No necesitás ser dev para probarlas. Estas apps cargan el formato SKILL.md; la diferencia es qué herramientas tienen: archivos, terminal, red y ejecución de código.

Claude (web y desktop)

Sin código

Chat con Skills

La forma más simple de probar una skill sin tocar una terminal. Claude la carga cuando el pedido coincide.

Cómo se usa

Customize > Skills > Add > Upload skill. Subí la carpeta de la skill y activala. Necesitás ejecución de código habilitada.

Corre en un sandbox: puede no tener bun, libreoffice ni red. Ideal para interview-prep; para job-search y export docx/pdf usá un agente local.

Claude Cowork

Sin código

Espacio de trabajo agéntico

Sesiones de trabajo con las skills habilitadas en tu cuenta de Claude. Pensado para tareas de oficina, no solo código.

Cómo se usa

Habilitá la skill en Customize y usala dentro de una sesión de Cowork.

No lee la carpeta personal de skills de tu máquina: usa las que están habilitadas en tu cuenta. Disponibilidad según plan.

Manus

Sin código

Agente generalista

Agente con interfaz web que puede importar skills desde GitHub o desde una carpeta.

Cómo se usa

Skills > + Add > Upload a skill o Import from GitHub.

Verificá que el sandbox tenga las herramientas de la skill. interview-prep es la más directa.

OpenCode Desktop

Intermedio

Agente de escritorio

La versión con interfaz de OpenCode. Detecta skills en la misma carpeta global.

Cómo se usa

Instalá OpenCode Desktop y copiá o symlinkeá las skills en ~/.config/opencode/skills/. Reiniciá.

Necesitás configurar un modelo/proveedor. Más técnico que Claude, pero sin terminal.

Goose Desktop

Intermedio

Agente de escritorio y CLI

Agente open source con app de escritorio. Lee skills desde ~/.agents/skills/.

Cómo se usa

Instalá Goose, habilitá la extensión de Skills y copiá la carpeta.

Pensado para tareas técnicas; requiere configurar el modelo.

Para empezar sin ser dev

Probá Claude (web o desktop) con interview-prep: no necesita binarios ni red. Cuando quieras el flujo completo de búsqueda o exportar docx/pdf, pasá a un agente local.

Si ya sos dev

Cursor, Windsurf, Kiro, Claude Code, Codex y Gemini CLI también leen SKILL.md y tienen acceso completo a archivos y terminal. Las rutas están en la tabla de instalación manual.

ChatGPT y Gemini web no cargan SKILL.md. Son chat, no agentes con archivos y terminal. Sirven para prompts sueltos, no para estas skills.

Instalación en 4 pasos

El instalador detecta los agentes instalados y crea symlinks. No copia los archivos: si actualizás el repo, actualizás la skill. Si usás Claude, Cowork o Manus, subí la carpeta desde la app: el instalador es para agentes locales.

1Cloná el repo

Necesitás git. El repo es público.

git clone https://github.com/Gianni03/gianni-skills.git
cd gianni-skills

2Ejecutá el instalador

Detecta OpenCode, Claude Code, Gemini CLI, Cursor, Kiro y Windsurf. Podés forzar uno y reemplazar lo existente.

chmod +x install.sh
./install.sh

Opciones

./install.sh --agent opencode
./install.sh --force

3Reiniciá el agente

Cerrá y abrí tu agente para que cargue las skills. En OpenCode quedan en ~/.config/opencode/skills/. Si no reiniciás, no las ve.

4Configurá la skill que lo necesite

job-search necesita profile.json. job-application necesita assets/profile.md. interview-prep funciona sin configuración. El detalle está en cada tab.

Instalación manual

Si preferís no usar el script, copiá o symlinkeá la carpeta de cada skill a la ruta de tu agente.

Agente	Ruta	Nota
OpenCode	~/.config/opencode/skills/<skill>/	Detectado por install.sh. Modo interactivo completo.
Claude Code	~/.claude/commands/<skill>/	Detectado por install.sh.
Gemini CLI	~/.gemini/agents/<skill>/	Detectado por install.sh.
Cursor	~/.cursor/agents/<skill>/	Detectado por install.sh.
Kiro	~/.kiro/agents/<skill>/	Detectado por install.sh.
Windsurf	~/.windsurf/workflows/<skill>/	Detectado por install.sh.
Codex	Config TOML, ruta variable	Instalación manual.

OpenCode

~/.config/opencode/skills/<skill>/

Detectado por install.sh. Modo interactivo completo.

Claude Code

~/.claude/commands/<skill>/

Detectado por install.sh.

Gemini CLI

~/.gemini/agents/<skill>/

Detectado por install.sh.

Cursor

~/.cursor/agents/<skill>/

Detectado por install.sh.

Kiro

~/.kiro/agents/<skill>/

Detectado por install.sh.

Windsurf

~/.windsurf/workflows/<skill>/

Detectado por install.sh.

Codex

Config TOML, ruta variable

Instalación manual.

Requisitos

Base

git
Un agente con soporte de skills (no un chat web)

job-search

bun
python3

job-application

python3 + python-docx
poppler-utils (pdftotext, pdfinfo)
libreoffice

interview-prep

Nada extra: solo el agente

Las tres skills

Cada una resuelve una parte distinta del proceso. Se pueden usar juntas: buscar, aplicar y preparar la entrevista.

job-search

v1.0

Activa

Busca, filtra y rankea ofertas reales.

Busca postings en LinkedIn, GetOnBoard, Computrabajo, RemoteOK, freehire y canales públicos de Telegram. Filtra por ubicación y antigüedad, deduplica entre corridas, puntúa contra tu profile.json y genera un reporte HTML interactivo. Los botones de Aplicado y Fuera de rango alimentan la próxima búsqueda.

Qué hace

Búsqueda completa

Corre todas las fuentes declaradas en profile.json y devuelve solo lo nuevo de la ventana configurada (7 días por defecto).

Un portal

Consultá GetOnBoard, Computrabajo, RemoteOK, Telegram, LinkedIn o freehire por separado.

Dedupe y scoring

Evita repetir ofertas ya vistas y puntúa el fit contra tu perfil.

Reporte interactivo

HTML autocontenido con botones para marcar aplicado o fuera de rango; el feedback entrena la próxima corrida.

Comandos

Búsqueda completa

python3 tools/run.py --posts /tmp/opencode/posts.json

Un portal

bin/portals search -q "react" -l "Rosario" -s computrabajo --jobage 7 -n 20 -f json

bin/linkedin search -q "frontend developer" -l "Rosario, Santa Fe, Argentina" --jobage 7 --limit 20 --format json

Servidor del reporte

python3 tools/serve.py

Cómo pedírsela al agente

Escribí cualquiera de estas frases en tu agente. La skill se activa por su trigger.

buscar ofertas de frontend en Rosario

qué hay nuevo

buscar remoto React

buscar trabajo

Setup

Creá tu perfil

En la carpeta de la skill, copiá el ejemplo y editalo con tus roles, stack, seniority y ubicación.

En skills/job-search

cp profile.example.json profile.json
$EDITOR profile.json

Ajustá la búsqueda

profile.json también define las búsquedas que corre run.py. La guía completa con ejemplos está en assets/profile-guide.md.

Requisitos

bun (los wrappers de portales lo usan)
python3 (dedupe, render y serve)

Salidas

ofertas/<fecha>_ofertas.html — reporte interactivo
ofertas/<fecha>_ofertas.md — misma lista, editable
state/seen_jobs.json — dedupe entre corridas

Límites

Uso personal. LinkedIn usa endpoints públicos y automatizar el acceso va contra sus ToS.
No hace crawl ni paginación profunda: una búsqueda por categoría por corrida.
Ventana de 7 días por defecto; lo más viejo no se muestra.
No hace búsquedas de personas.

Preguntas frecuentes

Lo que conviene saber antes de instalar.

¿Puedo usar esto en ChatGPT o Gemini web?

No. Un chat web no puede leer la carpeta donde está instalada la skill, no ve tus PDFs locales, no ejecuta los CLIs de job-search y no mantiene state/ entre conversaciones. Podés copiar prompts sueltos, pero perdés el workflow completo.

¿Esta página ejecuta las skills?

No. La web te documenta y te guía. La ejecución pasa en tu agente local, que es el que tiene acceso a archivos y terminal.

¿Cómo las actualizo?

Hacé git pull en el repo clonado. Como install.sh crea symlinks, el agente ve la versión nueva al reiniciarse.

¿Necesito pagar una API?

Las skills no traen una API key propia: usan el modelo y las herramientas de tu agente. Si tu agente es BYOK, esa key es la que paga el uso.

¿Dónde se guardan los archivos?

job-application escribe en output/; job-search guarda profile.json y state/ (personales y gitignoreados). Los PDFs originales no se tocan.

¿Son seguras?

Corren con los permisos de tu agente. Revisá install.sh y los scripts antes de usarlas. No pongas secretos en profile.json ni en profile.md.

Repo: github.com/Gianni03/gianni-skills — licencia Apache-2.0.