Assigning a skill ================= In this section, you will learn how to: * :ref:`Assign a skill to a topic ` * :ref:`Assign a skill to a subtopic ` * :ref:`Create a question for a skill ` Watch this video to learn how to assign skills, or if you prefer reading the instructions instead, keep scrolling down. .. raw:: html .. _assigntopic: Assigning a skill to a topic ----------------------------- When you initially create and publish a skill, it falls under the category of **Unused Skills** until you assign it to a topic. .. figure:: /images/unused_skills.png :alt: Unused skills :scale: 30 % *Fig 1.* 1. To assign a skill to a topic, click the **Assign to Topic** button next to the skill. 2. Select the Topic to which you want to assign the skill and click |savebutton|. As you assign skills, they are taken out of the **Unused Skills** tab and added to the topic. .. |savebutton| image:: /images/save_button.png :scale: 40 % 3. To merge an unused skill with a skill already assigned to a topic, click the **Merge Skill** button next to the skill, and select the skill you want to merge with. .. figure:: /images/merge_skill.png :alt: Merging Skills :scale: 30 % *Fig. 2* 4. Once a skill is assigned to a topic, it can now be added to a chapter within the topic. To add a skill to a chapter, click on the topic, then the story title. 5. To add prerequisite and acquired skills to a chapter, click on |addprereq| and |addacquired| to select from the list of assigned skills. .. |addprereq| image:: /images/add_prerequisite_skill.png :scale: 40 % .. |addacquired| image:: /images/add_acquired_skill.png :scale: 40 % .. figure:: /images/add_skills_chapter.png :alt: Adding skills to chapter :scale: 40 % *Fig. 3* 6. Skills are now added to this chapter. Save your changes when done. .. figure:: /images/skills_chapter.png :alt: Skills added to chapter :scale: 30 % *Fig. 4* .. _assignsubtopic: Assigning a skill to a subtopic -------------------------------- When you initially assign a skill to a topic, it falls under the category of **Uncategorized Skills**. This means that they have not yet been assigned to any :ref:`subtopic `. To enable learners to review the skills associated with a topic, you will need to create subtopics and then assign skills to the subtopics. When learners begin a practice session, they will choose the subtopic they want to practice and then review the skills within that subtopic. 1. To create a subtopic, click on the topic and then the **Subtopics editor** |subtopiceditor| button in the top-right corner. .. |subtopiceditor| image:: /images/subtopics_editor.png :scale: 30 % 2. To create a new subtopic, click on **+ Add Subtopic**, enter a title and click |createsubtopic|. .. |createsubtopic| image:: /images/create_subtopic.png :scale: 40 % 3. To assign skills to a subtopic, drag the skill from the list of **Uncategorized Skills** on the right side and drop it under the relevant subtopic. To remove a skill from the subtopic, drag the skill back to the Uncategorized Skills list. .. figure:: /images/subtopics_page.png :alt: Creating a subtopic :scale: 30 % *Fig. 5* 4. To unassign a skill from a topic, click the |trashcan| button next to the skill in the **Uncategorized Skills** list. This will not delete the skill, but move it back to the **Unused Skills** tab in the Topics and Skills dashboard. .. |trashcan| image:: /images/trashcan.png :alt: Delete skill button :scale: 40 % 5. To delete a subtopic, click the red **X** next to the Subtopic Title. This moves any associated skills back to the **Uncategorized Skills** list. 6. To create a high-level description for the subtopic that learners will see in the practice session, click the |pencil| button next to the Subtopic Title. Enter the description in the text box under **Subtopic Page**. This will help learners decide which subtopics to practice. .. |pencil| image:: /images/pencil.png :scale: 40 % .. important:: Ensure that each subtopic contains a unique list of skills, i.e., skills are not repeated in different subtopics. 7. When you have finished creating subtopics and assigning skills to them, click |savechanges|. .. |savechanges| image:: /images/save_changes.png :alt: Save Changes button :scale: 40 % .. _createquestion: Creating a question for a skill -------------------------------- Questions can be created either through the Topic Editor or submitted by contributors. 1. To create a question from the Topic Editor, click on the topic, and then the **Questions Editor** |questioneditor| button in the top-right corner. .. |questioneditor| image:: /images/question_editor.png :scale: 30 % 2. Click the **Create Question** button. 3. Select one or more skills for which you want to create the question and click **Next**. .. figure:: /images/select_skill_question.png :alt: Selecting skills for questions :scale: 30 % *Fig. 6* 4. Select the question's level of difficulty—Easy, Medium or Hard—and click **Done**. If there were rubrics written for these levels when the skill was created, you will see them here. 5. The **Question Editor** box opens. This works just like an :ref:`Exploration Editor ` where you can create questions, add interactions, responses and feedback. At least one of the answer groups must be marked as correct. You also have to add a hint in order to publish the question. For some interactions like **Text Input**, you will be required to add a *solution* to the hint, which must correspond with one of the correct answer groups. When you have finished creating the question, click |publishquestion|. .. |publishquestion| image:: /images/publish_question.png :scale: 40 % .. figure:: /images/questions_topic.png :alt: Questions created for a skill :scale: 30 % *Fig. 7* 6. To change the published question's level of difficulty, click the |blackpencil| button and select a different level. 7. To delete the question, click the |unlink| button. .. |blackpencil| image:: /images/black_pencil.png :scale: 40 % .. |unlink| image:: /images/unlink.png :scale: 40 %