Before You Start
- Skills must be extracted from syllabi or job descriptions first (either manually added or AI-processed)
- You’ll need appropriate permissions to edit course sections or job data
- Consider reviewing the How Skills Extraction Works guide to understand AI-generated skills
Understanding Skill Sources
Skills in Mapademics come from two sources, each with distinct characteristics:AI-Extracted Skills
Skills automatically detected from syllabi and job descriptions appear with:- Badge: “Syllabus” or “Job Description” badge with document icon
- Rationale: Viewable explanation of why the AI identified this skill
- Evidence: Specific text from the document supporting the skill identification
Manually Added Skills
Skills you add manually are marked with:- Badge: “Manual” badge with user icon
- Full Control: No restrictions on editing or removal
- Custom Levels: You set the proficiency level (1-5)
Reviewing Skills in Course Sections
Accessing Course Section Skills
- Navigate to Academic Data → Courses
- Select the course containing your section
- Click on the specific course section you want to review
- The Skills section displays all current skills for that section
Understanding the Skills Display
Each skill row shows:- Source: Whether the skill came from AI processing or manual addition
- Name: The skill name from the standardized skills library
- Level: Proficiency level (1-5, with 5 being highest)
- Rationale: For AI-extracted skills, click “View” to see the reasoning
- Actions: Remove button to delete the skill
Managing Individual Skills
Editing Skill Levels
- Locate the skill you want to modify in the skills table
- Click the Level dropdown for that skill
- Select the new proficiency level:
- Level 1: Basic familiarity or awareness
- Level 2: Basic application with guidance
- Level 3: Independent application (default for manual skills)
- Level 4: Advanced application and analysis
- Level 5: Expert level - can teach others
Removing Skills
To remove a skill that doesn’t belong or is no longer relevant:- Find the skill in the skills table
- Click the trash icon in the Actions column
- The skill is immediately removed from the course section
Adding Skills Manually
Using the Add Skills Interface
- Click the “Add Skills” button next to the skills table
- The Add Skills panel opens with these options:
- Skill Selection: Choose from the standardized skills library
- Level Setting: Set the proficiency level for each skill
- Multiple Addition: Add several skills at once
Selecting Skills from the Library
Option 1: Dropdown Search- Use the dropdown to search and select from available skills
- Skills already added to the section won’t appear in the list
- Click “Open Library” to browse all available skills
- Search by skill name or browse by category
- Click “Select” next to any skill to add it to your current selection
Bulk Adding Skills
- In the Add Skills panel, you start with one skill row
- Configure your first skill (name and level)
- Click “Add Another Skill” to create additional rows
- Fill out each skill as needed
- Click “Add [X] Skills” to save all configured skills at once
Working with Job Skills
Accessing Job Skills
- Navigate to Job Market Data → Jobs
- Select the specific job you want to review
- The Job Skills card shows all current skills for that position
Job-Specific Considerations
Job skills work similarly to course section skills but with these differences:- Context: Skills represent job requirements rather than learning outcomes
- Source Label: AI-extracted skills show “Job Description” instead of “Syllabus”
- Processing: Use “Process Job Description” to trigger AI analysis of uploaded job descriptions
Reprocessing Content
When to Reprocess
Consider reprocessing syllabi or job descriptions when:- You’ve updated the content significantly
- Initial processing missed important skills
- You want to use updated AI models or processing settings
Triggering Reprocessing
- Ensure you have an uploaded syllabus or job description
- Click the “Process Syllabus” or “Process Job Description” button
- The system shows a processing indicator
- New skills are added while preserving your manual edits
Quality Control Best Practices
Regular Review Schedule
- After Initial Processing: Review all AI-extracted skills for accuracy
- Semester/Term Updates: Review when course content changes
- Program Reviews: Ensure skills align with program learning outcomes
- Industry Changes: Update job skills as industry demands evolve
Validation Checklist
When reviewing skills, consider:- Relevance: Does this skill actually relate to the course/job content?
- Level Appropriateness: Is the proficiency level realistic for this context?
- Completeness: Are there obvious skills missing that should be added?
- Consistency: Do similar courses/jobs have consistent skill levels?
Working with Rationale Information
For AI-extracted skills:- Click “View” in the Rationale column
- Read the specific evidence the AI found
- Evaluate whether the evidence supports the skill identification
- Keep skills with strong evidence, remove those with weak justification
Bulk Operations
Processing Multiple Sections
When working with courses that have multiple sections:- Each section maintains its own skills list
- Default sections inherit from course-level data during migration
- Use consistent skill levels across sections teaching the same content
- Consider the instructor’s expertise when setting skill levels
Skills Library Management
The skills library contains standardized skills from occupational databases:- Search Function: Find skills by name or description
- Category Browsing: Explore skills by occupational category
- Skill Details: View descriptions to ensure appropriate selection
Related Tasks
- How Skills Extraction Works - Understanding AI processing
- Managing Course Sections - Course section fundamentals
- Job Management - Working with job descriptions
- Learn about skills analysis in the Reports section (coming soon)