md-quiz

Use this skill as the default entry point when creating, editing, reviewing, migrating, or debugging md-quiz repositories, quiz.md files, and synced position files. It routes quiz content and QML syntax work to qml-authoring, and routes repository structure, md-quiz-repo.yaml, quiz paths, position paths, assets, and sync contract work to quiz-repo-spec.

Use this skill when defining, reviewing, migrating, or debugging a syncable quiz repository, especially md-quiz-repo.yaml, quizzes/<quiz_id>/quiz.md layout, job-descriptions/<jd_key>/jd.md layout, asset path rules, repo-relative source_path, and content repo sync failures.

Use this skill when authoring, reviewing, fixing, or documenting QML quiz markdown, especially question headers, answer_time, rubric and llm blocks, welcome/end images, parser edge cases, and examples that must stay consistent with the active QML parser contract.

Use this skill when designing, reviewing, or refactoring a job system, worker, scheduler, queue, retry policy, lease/heartbeat recovery, atomic claim flow, idempotency model, concurrency guardrails, observability, or parent-child task orchestration.

Use this skill when refactoring, straightening, or reviewing a messy Python web service or API project, especially FastAPI-first and Flask-compatible cases involving module boundaries, entrypoint cleanup, configuration governance, async job separation, test strategy, documentation, and platform collaboration rules.