Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mapademics.com/llms.txt

Use this file to discover all available pages before exploring further.

After Mapademics automatically extracts skills from your syllabi and job descriptions, you have complete control to review, edit, and manage those skills. This ensures your skills data is accurate and aligned with your educational and workforce goals.

​
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

  1. Navigate to Academic Data → Courses
  2. Select the course containing your section
  3. Click on the specific course section you want to review
  4. 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

  1. Locate the skill you want to modify in the skills table
  2. Click the Level dropdown for that skill
  3. 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:
  1. Find the skill in the skills table
  2. Click the trash icon in the Actions column
  3. The skill is immediately removed from the course section

​
Adding Skills Manually

​
Using the Add Skills Interface

  1. Click the “Add Skills” button next to the skills table
  2. 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
Option 2: Skills Library Browser
  • 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

  1. In the Add Skills panel, you start with one skill row
  2. Configure your first skill (name and level)
  3. Click “Add Another Skill” to create additional rows
  4. Fill out each skill as needed
  5. Click “Add [X] Skills” to save all configured skills at once

​
Working with Job Skills

​
Accessing Job Skills

  1. Navigate to Job Market Data → Jobs
  2. Select the specific job you want to review
  3. 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

  1. Ensure you have an uploaded syllabus or job description
  2. Click the “Process Syllabus” or “Process Job Description” button
  3. The system shows a processing indicator
  4. 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:
  1. Click “View” in the Rationale column
  2. Read the specific evidence the AI found
  3. Evaluate whether the evidence supports the skill identification
  4. 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