Tu agente puede empezar en tres pasos
Copia el comando para Codex o Claude Code.
Créala en esta página y agrégala al archivo .env.
Usa uno de los prompts simples de esta guía.
Consejo: crea una llave distinta para cada agente. Así puedes revocar uno sin desconectar los demás.
Pídele a tu agente que instale LearnForce
Copia esta instrucción completa en Codex o Claude Code. El agente detectará su carpeta de skills, descargará LearnForce con sus scripts y comprobará que quedó instalada.
Instala y configura la skill LearnForce en este equipo. Esta instalación sólo funciona en Claude Code y Codex; no funciona en Claude Chat, Claude Cowork ni ChatGPT. Si no estás en Claude Code o Codex, detente e infórmame. Ejecuta tú todos los comandos necesarios; no me entregues instrucciones para que yo cree carpetas o archivos. No leas el portapapeles sin avisarme, explicar el alcance y recibir mi autorización explícita.
1. Detecta si estás ejecutándote como Codex o Claude Code.
2. Usa la carpeta correspondiente:
- Codex: $HOME\.codex\skills\learnforce
- Claude Code: $HOME\.claude\skills\learnforce
3. Descarga el archivo principal desde:
https://learn.techforce.cl/docs/learnforce-skill/SKILL.md
y guárdalo como SKILL.md dentro de esa carpeta.
4. Crea la subcarpeta scripts y descarga dentro de ella estos cuatro archivos:
- https://learn.techforce.cl/docs/learnforce-skill/scripts/search.ps1
- https://learn.techforce.cl/docs/learnforce-skill/scripts/lesson.ps1
- https://learn.techforce.cl/docs/learnforce-skill/scripts/module-lessons.ps1
- https://learn.techforce.cl/docs/learnforce-skill/scripts/key.ps1
5. Verifica que existan SKILL.md y los cuatro scripts.
6. Ejecuta tú mismo estos comandos para dejar preparado el archivo de configuración:
$config = [IO.Path]::Combine($HOME, '.config', 'learnforce')
New-Item -ItemType Directory -Force $config | Out-Null
$envFile = Join-Path $config '.env'
if (-not (Test-Path $envFile)) { New-Item -ItemType File $envFile | Out-Null }
7. Ejecuta tú mismo:
Copy-Item (Join-Path $skill 'scripts\key.ps1') (Join-Path $config 'lfkey.ps1') -Force
$profileFile = $PROFILE.CurrentUserAllHosts
New-Item -ItemType Directory -Force (Split-Path $profileFile) | Out-Null
if (-not (Test-Path $profileFile)) { New-Item -ItemType File $profileFile | Out-Null }
$definition = 'function lfkey { & "$HOME/.config/learnforce/lfkey.ps1" }'
if (-not (Select-String -LiteralPath $profileFile -SimpleMatch 'function lfkey' -Quiet)) { Add-Content -LiteralPath $profileFile -Value "`n$definition" }
. $profileFile
8. Verifica tú mismo que la carpeta, el .env, SKILL.md, los cuatro scripts y el comando lfkey existan.
9. Muestra de forma destacada y sin texto previo:
“ACCIÓN REQUERIDA
1. Crea tu llave en https://learn.techforce.cl/agents.html
2. Presiona copiar para dejarla en el portapapeles.
3. Responde exactamente: LISTO
Al responder LISTO permites leer una vez el portapapeles exclusivamente para validar esa key y, si funciona, guardarla en $HOME/.config/learnforce/.env. La key permite consultar tus cursos y gestionar tu progreso con tus permisos; permanece hasta eliminarla o revocarla en LearnForce. No se leerá ni guardará otro contenido.”
10. Espera. La respuesta LISTO es la única confirmación necesaria: no vuelvas a pedir autorización.
11. Tras recibirla, ejecuta `& (Join-Path $config 'lfkey.ps1') -ClipboardOnly`. El script valida la key contra la API antes de guardarla. Nunca muestres la llave. Considera éxito únicamente la salida `status: ok` y `api_verified: true`; no hagas una segunda verificación casera del texto del archivo.
12. Si la API confirma la key, informa que LearnForce está lista para usar inmediatamente. No pidas reiniciar: ya leíste SKILL.md en esta sesión.
13. Termina sugiriendo estos prompts:
- “Usando LearnForce, recomiéndame las 5 mejores clases de Imperio Agéntico para aprender agentes de WhatsApp.”
- “Usando LearnForce, dime cómo hacer [objetivo] según Imperio Agéntico.”
- “Usando LearnForce, créame una ruta para aprender [tema] desde cero.”
14. Si no autoriza el portapapeles, ofrece dos alternativas: ejecutar `lfkey` o guardar manualmente una línea `LEARN_FORCE_API_KEY=SU_LLAVE` en `$HOME/.config/learnforce/.env`. No pidas que comparta la llave en el chat.
Instala y configura la skill LearnForce en este Mac usando únicamente herramientas nativas de macOS y descargas por HTTPS. No instales PowerShell, Homebrew, jq ni ninguna dependencia. Usa `/bin/sh`, `curl`, `pbpaste` y `osascript`. Sólo funciona en Claude Code y Codex; si no estás en una de esas aplicaciones, detente e infórmame. Ejecuta tú todos los comandos. No leas el portapapeles sin explicar antes el alcance y recibir mi autorización.
1. Detecta si eres Codex o Claude Code y usa respectivamente `$HOME/.codex/skills/learnforce` o `$HOME/.claude/skills/learnforce`.
2. Crea `scripts` y usa `curl --fail --location` para descargar por HTTPS `https://learn.techforce.cl/docs/learnforce-skill/SKILL.md` como `SKILL.md`. Descarga del mismo modo `search.sh`, `lesson.sh`, `module-lessons.sh` y `key.sh` desde `https://learn.techforce.cl/docs/learnforce-skill/scripts/NOMBRE`.
3. Da permiso de ejecución a los cuatro scripts con `chmod +x` y verifica que existan.
4. Crea sin sobrescribir `$HOME/.config/learnforce/.env`. Copia `scripts/key.sh` como `$HOME/.config/learnforce/lfkey` y dale permiso de ejecución.
5. Agrega al perfil de la shell activa, sin duplicarlo, `alias lfkey="$HOME/.config/learnforce/lfkey"`. Conserva todo el perfil y cárgalo.
6. Muestra de forma destacada y sin texto previo:
“ACCIÓN REQUERIDA
1. Crea tu llave en https://learn.techforce.cl/agents.html
2. Presiona copiar para dejarla en el portapapeles.
3. Responde exactamente: LISTO
Al responder LISTO permites leer una vez el portapapeles exclusivamente para validar esa key y guardarla en $HOME/.config/learnforce/.env. No se leerá ni guardará otro contenido.”
7. Espera. LISTO es la única confirmación necesaria; no vuelvas a pedir autorización.
8. Al recibir LISTO ejecuta `$HOME/.config/learnforce/lfkey --clipboard-only`. Nunca muestres la llave. Sólo considera éxito `status: ok` y `api_verified: true`.
9. Si funciona, informa que LearnForce está lista sin reiniciar y sugiere tres prompts concretos para comenzar.
10. Si no autoriza el portapapeles, ofrece ejecutar `lfkey` o guardar manualmente `LEARN_FORCE_API_KEY=SU_LLAVE` en `$HOME/.config/learnforce/.env`. Nunca pidas la llave en el chat.
Sin reiniciar: el mismo agente puede usar LearnForce porque ya leyó su SKILL.md durante la instalación.
Instalación manual
Si prefieres hacerlo tú, copia el comando de tu herramienta en PowerShell.
$skill="$HOME\.codex\skills\learnforce"; New-Item -ItemType Directory -Force "$skill\scripts" | Out-Null
Invoke-WebRequest "https://learn.techforce.cl/docs/learnforce-skill/SKILL.md" -OutFile "$skill\SKILL.md"
"search","lesson","module-lessons","key" | ForEach-Object { Invoke-WebRequest "https://learn.techforce.cl/docs/learnforce-skill/scripts/$_.ps1" -OutFile "$skill\scripts\$_.ps1" }
$skill="$HOME\.claude\skills\learnforce"; New-Item -ItemType Directory -Force "$skill\scripts" | Out-Null
Invoke-WebRequest "https://learn.techforce.cl/docs/learnforce-skill/SKILL.md" -OutFile "$skill\SKILL.md"
"search","lesson","module-lessons","key" | ForEach-Object { Invoke-WebRequest "https://learn.techforce.cl/docs/learnforce-skill/scripts/$_.ps1" -OutFile "$skill\scripts\$_.ps1" }
Copia la llave y responde “LISTO”
Tu agente mostrará tres pasos destacados. Esa única respuesta autoriza una lectura del portapapeles, la validación contra la API y el guardado seguro. No habrá una segunda confirmación.
lfkey
Sin autorización no se lee el portapapeles. Puedes usar lfkey o guardar manualmente LEARN_FORCE_API_KEY=SU_LLAVE en $HOME/.config/learnforce/.env.
https://bipsvhxsvfzfwzufucfg.supabase.co/functions/v1/courses-api/v1X-API-Key: lf_agent_TU_LLAVE
Ahora sólo pide lo que necesitas
Con LearnForce instalada y la llave guardada, no necesitas repetir documentación, endpoints ni credenciales. Reemplaza únicamente el texto entre corchetes.
Usando la skill LearnForce, recomiéndame las 5 mejores clases de Imperio Agéntico para aprender [tema]. Primero dame una explicación general de la ruta y luego las clases ordenadas, cada una con contexto y su URL.
Usando la skill LearnForce, dime cómo hacer [objetivo] según Imperio Agéntico. Dame primero una explicación general y luego los pasos con las clases y URLs que debo consultar.
Usando la skill LearnForce, créame una ruta con clases de Imperio Agéntico para aprender [tema] desde cero. Dame una explicación general y luego las clases de lo básico a lo avanzado, con contexto y URL.
Usando la skill LearnForce, ayúdame con este problema según Imperio Agéntico: [describe el problema]. Explícame brevemente el enfoque y recomiéndame en orden las clases y recursos útiles, cada uno con su URL.
Todo lo que puede hacer tu agente
/meIdentificar la cuenta conectada
/coursesListar los cursos disponibles
/courses/{courseId}Ver información de un curso
/courses/{courseId}/modulesListar sus módulos
/courses/{courseId}/modules/{moduleId}Ver un módulo
/courses/{courseId}/modules/{moduleId}/lessonsListar sus clases
/courses/{courseId}/modules/{moduleId}/lessons/{lessonId}Obtener la clase completa
/progressConsultar el progreso
/progress/{itemId}Marcar avance o guardar una respuesta
/search/keywordBúsqueda económica por palabras
/search/semanticBúsqueda por significado
/search/hybridCombinar palabras y significado
Encuentra qué estudiar según tu intención
Los tres modos comparten la misma entrada y respuesta. La busqueda puede limitarse a un curso, cruzar varios cursos o usar todos los cursos accesibles.
curl -X POST "$BASE_URL/search/keyword" \
-H "X-API-Key: $LEARN_FORCE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"quiero aprender agentes de WhatsApp","limit":5}'
curl -X POST "$BASE_URL/search/hybrid" \
-H "X-API-Key: $LEARN_FORCE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"captar pacientes por WhatsApp","limit":10,"course_ids":["poderosa-maquina-pacientes","whatsagenda-pro"]}'
PostgreSQL Full Text Search. No ejecuta modelos.
Busca significado con embeddings OpenAI sobre clases y transcripciones.
Combina palabras y significado, incluyendo fragmentos y recursos.
Leer una clase completa
Una sola petición devuelve la descripción, video, contenido, transcripciones y recursos. Los enlaces privados de descarga duran una hora.
curl "$BASE_URL/courses/imperio-agentico/modules/MODULO/lessons/CLASE" \
-H "X-API-Key: $LEARN_FORCE_API_KEY"
body_markdownApuntes completostranscripts[]Texto y SRT descargableresources[]Plantillas y documentosvideo_urlVideo original de la claseActualizar el progreso
El agente solo puede escribir en el progreso de la cuenta que creó la llave.
curl -X PUT "$BASE_URL/progress/ID_DE_LA_CLASE" \
-H "X-API-Key: $LEARN_FORCE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"completed": true}'
Diseñada para entregar el mínimo acceso
Solo se almacena su hash SHA-256.
Hereda los permisos del usuario dueño.
Desactiva una llave inmediatamente.
120 peticiones por minuto y llave.
¿Tu herramienta acepta OpenAPI? Descargar especificación OpenAPI 3.1 →