quiz-repo-spec

Validate MD Quiz repository structure and configuration for compliance.

7|2|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/servforce/md-quiz --skill quiz-repo-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quiz-repo-spec
Source: https://github.com/servforce/md-quiz/tree/main/skills/quiz-repo-spec
Command: npx skills add https://github.com/servforce/md-quiz --skill quiz-repo-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that quiz repositories are synchronized correctly and adhere to the MD Quiz standards, aiding in smooth quiz creation, review, and debugging processes.

Core Features & Use Cases

  • Quiz Repository Sync: Verify the synchronization of quiz repositories with MD Quiz standards.
  • Compliance Check: Ensure quiz and job description layouts comply with MD Quiz requirements.
  • Debugging Aid: Provide a step-by-step guide to troubleshoot common sync and resource path issues.
  • Use Case: When setting up a new quiz repository, use this Skill to ensure that the structure, md-quiz-repo.yaml, quizzes/<quiz_id>/quiz.md, and job-descriptions/<jd_key>/jd.md files are correctly formatted and synchronized.

Quick Start

Use the quiz-repo-spec skill to review the structure of your quiz repository and ensure compliance with MD Quiz standards.

Frequently Asked Questions about quiz-repo-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate an MD Quiz repository structure and configuration?

To validate an MD Quiz repository, you must check the `md-quiz-repo.yaml` configuration file and ensure the `quizzes/<quiz_id>/quiz.md` and `job-descriptions/<jd_key>/jd.md` file layouts comply with MD Quiz standards.

Why is my MD Quiz repository synchronization failing?

MD Quiz repository synchronization typically fails due to incorrect `md-quiz-repo.yaml` configuration, misaligned quiz and job description file layouts, or non-compliant resource paths that violate MD Quiz standards.

What is the correct file layout for MD Quiz authoring?

The correct MD Quiz authoring layout requires an `md-quiz-repo.yaml` configuration file at the root, with quiz files organized as `quizzes/<quiz_id>/quiz.md` and job descriptions as `job-descriptions/<jd_key>/jd.md`.

How do I troubleshoot resource path compliance issues in MD Quiz?

Troubleshooting MD Quiz resource path compliance involves systematically verifying that all file layouts and directory structures match the specifications defined in your `md-quiz-repo.yaml` configuration.

Do I need any dependencies to check MD Quiz standards compliance?

No external dependencies are required to check MD Quiz standards compliance, as the validation process relies solely on verifying your repository's internal file layouts and `md-quiz-repo.yaml` configuration.

Can I use this to debug job description layouts for MD Quiz?

Yes, you can debug job description layouts by verifying that your `job-descriptions/<jd_key>/jd.md` files are correctly formatted and synchronized according to MD Quiz requirements.