Agent skill · writing content · bighardperson
open-lesson
Interact with openLesson tutoring API for Socratic learning: generate learning plans as directed graphs, start audio-based tutoring sessions, analyze reasoning gaps, and manage tutoring workflows. Use when users want personalized tutoring, learning plan generation, or Socratic dialogue-based education.
Why this skill is useful
Adds executable API interaction scripts for generating learning plans, starting sessions, and analyzing audio that extend the AI's tutoring capabilities.
What it needs
Requires openlesson account access. About 2k tokens when loaded. Last updated 2026-04-26. 34 stars on the source repository.
What this skill does
OPENLESSON AGENT API SKILL You are an AI agent that can interact with the openLesson tutoring platform via API. OVERVIEW openLesson is a tutoring system that uses audio-based dialogue to help users learn by asking questions rather than giving answers. The platform generates personalized learning plans as directed graphs, where each node is a session. Agents can programmatically generate learning plans, start sessions, and analyze audio chunks for reasoning gaps. IMPORTANT: NO BROWSER TOOL REQUIRED You do not need a browser tool. You only need shell tools (e.g., curl) to make API calls to openLesson. IMPORTANT: AUDIO-ONLY SYSTEM CRITICAL: The openLesson platform is audio-only. The analyze endpoint accepts ONLY audio input, NOT text. Always convert speech to base64-encoded audio before calling the analyze endpoint Supported formats: webm, mp4, ogg Do not send text to the analyze endpoint — it will be rejected AUTHENTICATION Include your API key in the Authorization header: Important: Always use https://www.openlesson.academy for API calls. The domain openlesson.academy has a redirect that loses the Authorization header. CREDENTIALS This skill requires an API key for the openLesson API: Environment variable: OPENLESSONAPIKEY How to obtain: Generate from the user's dashboard at /dashboard ENDPOINTS 1. GENERATE LEARNING PLAN Creates a directed graph of learning sessions for a given topic. Endpoint: POST /api/agent/plan Days to Sessions mapping: 7 days: 3-5 sessions 14 days: 4-7 sessions 30 days (default): 5-10 sessions 60 days: 8-14 sessions 90 days: 10-18 sessions 180 days: 15-25 sessions 2. START SESSION Starts a new Socratic session. Endpoint: POST /api/agent/session/start 3. ANALYZE AUDIO CHUNK Submits an audio chunk for Socratic analysis. Returns reasoning gap score and follow-up questions. Endpoint: POST /api/agent/session/analyze Response includes: gapScore, signals, transcript, followUpQuestion, requiresFollowUp 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills bighardperson/openLesson