Inspiration

Creating high-quality educational content requires more than AI text generation. A complete learning pack needs instructional planning, structured lessons, quizzes, text-to-speech optimization, validation, and packaging before it can be used by learners.

I wanted to build a reusable Codex Skill that automates this entire workflow while producing learning packs that are immediately usable in the Sokqa learning application.

What it does

Sokqa Pack Generator is a reusable Codex Skill that transforms a learning topic or reference material into a complete Sokqa learning pack.

The skill automatically:

  • Designs a course blueprint
  • Generates structured lesson documents
  • Creates four-choice quizzes
  • Generates Japanese TTS-ready content
  • Builds the learning pack manifest
  • Validates JSON Schema
  • Verifies quiz consistency
  • Detects duplicate content
  • Produces an import-ready Sokqa learning pack

How I built it

The project is implemented as a reusable Codex Skill powered by GPT-5.6.

Codex orchestrates the complete workflow by executing the generation pipeline, managing reusable knowledge files, invoking validation tools, and coordinating every generation step.

GPT-5.6 is responsible for educational planning, lesson generation, quiz creation, and Japanese TTS-ready content generation.

Instead of asking an LLM to generate JSON directly, the workflow follows a structured pipeline. It designs a course blueprint, generates lesson documents, creates quizzes from completed lessons, generates TTS content, builds the manifest, executes validation tools, detects duplicate content, and only completes successfully after every required quality check passes.

Custom Python validation tools verify JSON Schema compliance, quiz consistency, TTS quality, manifest integrity, duplicate detection, and fact-check evidence, making the generated learning packs reliable and reusable.

Challenges

The biggest challenge was making AI-generated educational content reliable enough for real learning.

Rather than relying only on prompting, I built deterministic validation tools that automatically detect structural problems, quiz issues, duplicate content, manifest inconsistencies, and TTS errors. This clearly separates creative AI generation from objective quality verification.

Accomplishments that I'm proud of

I'm proud that the project is more than a content generator.

It combines GPT-5.6's educational content generation with deterministic validation inside a reusable Codex Skill, producing learning packs that are ready to import into Sokqa.

The workflow is resumable, scalable, and designed for complete educational content production rather than isolated prompts.

What I learned

This project taught me that Codex Skills become much more powerful when they orchestrate an entire workflow instead of generating individual files.

I also learned that combining GPT-5.6 with deterministic validation significantly improves the reliability of AI-generated educational content.

What's next for Sokqa Pack Generator

The next step is to support multilingual language-learning packs, more advanced educational validation, collaborative authoring, cloud publishing, and deeper integration with Sokqa Studio for larger-scale educational content creation.

Built With

Share this project:

Updates