.. _write_question_skill_ref:

Write a Question for a Skill
============================

Questions for Skill practice can either be created directly by Topic Managers and Admins or suggested by contributors to Oppia. This process ensures that every Skill in a Topic has high-quality, diagnostic practice material.

**In this article, you will learn how to:**

* :ref:`Write meaningful questions <meaningful_questions_ref>`
* :ref:`Create a question in the editor <create_question_ref>`
* :ref:`Edit or delete an existing question <edit_delete_question_ref>`

---

.. _meaningful_questions_ref:

Write Meaningful Questions
--------------------------

When creating questions, keep the following pedagogical standards in mind:

* **Address Misconceptions:** Ensure all misconceptions attached to the skill
  are addressed in the answer groups.
* **Include Support:** Questions must include hints and, in many cases, solutions.
* **Avoid Patterns:** Ensure questions are varied so there is no predictable
  pattern (e.g., the answer is always option "A").
* **Difficulty Balance:** Provide a higher volume of questions for harder Skills.
* **Clarity:** Frame questions simply and briefly, staying close to the specific
  Skill being taught.
* **Validation:** At least one answer must be marked as correct.

---

.. _create_question_ref:

Create a Question
-----------------

To create a question in the **Topic Editor**:

1. Select the Topic you want to add the question to.
2. In the navigation panel, select the **Question Editor** (the book icon).

   .. figure:: /images/admins/question_editor_skill_select.png
      :alt: Choosing a skill in the Question Editor
      :align: center

      *Fig. 1. Selecting a skill in the Question Editor*

3. Use the dropdown menu to select a Skill you would like to add a question to.
4. Select **Create question**.
5. Once your question is complete, select **Save and publish question**.

   .. figure:: /images/admins/question_editor_writing.png
      :alt: Writing a question in the editor interface
      :align: center

      *Fig. 2. The Question Editor interface*

The **Question Editor** works similarly to the :ref:`Exploration Editor <create_new_card_ref>`. Within this interface, you can:

* Write the question content.
* Add an interaction (e.g., Multiple Choice, Text Input).
* Define responses and provide detailed feedback.
* Add hints and solutions.

.. note::
   All questions must include at least one hint to be published. For interactions like **Text Input**, you must also provide a **Solution** (a detailed walkthrough of the correct answer) that matches one of the correct answer groups.

---

.. _edit_delete_question_ref:

Edit or Delete a Question
-------------------------

**To change the difficulty level of a published question:**

1. Select the **three vertical dots** next to the question.
2. Choose a new difficulty level (Easy, Medium, or Hard) from the dropdown menu.

**To delete a question:**

1. Select the **three vertical dots**.
2. Select **Delete**.

.. warning::
   Deleting a question is permanent. If the question was part of a published Skill's practice set, ensure you have enough remaining questions to satisfy the Skill's requirements.