Before You Start
You must be a Super Admin or an Admin with Competency management permissions
Make sure your Company Structure has job roles defined, Luma uses them to generate and map competencies
Your Company Profile should be complete, Luma uses it as context when generating suggestions
If you choose Reset & Regenerate, all existing competencies will be permanently deleted. This cannot be undone
Overview
Building a competency framework manually takes time. Luma can accelerate the process by generating competencies based on your job roles and industry benchmarks either filling gaps in an existing framework or building one from scratch. You review everything before anything is applied.
Step 1: Choose What You Want AI to Do
Go to Competencies → Framework from the left navigation
Click Ask Luma
A modal will appear with two options:
Add Missing Competencies with Luma Existing competencies remain untouched. Luma analyses your current framework and your company roles, then generates only the competencies that appear to be missing. Use this when you have a partial framework and want to fill the gaps.
Reset & Regenerate Competencies All existing competencies are deleted and a new set is generated from scratch based on your company structure and strategy. Use this when you want to start fresh or when your current framework is too outdated to build on.
⚠️ Warning: Reset & Regenerate permanently deletes all existing competencies and their associated data. This cannot be undone. Use Add Missing Competencies if you want to preserve your current work.
Step 2: Select the Job Roles to Generate Competencies For
After choosing your generation mode, you will be asked to select which job roles the Luma should generate competencies for.
A list of all roles from your Company Structure appears all pre-selected by default
Use the search bar to find specific roles by name
Use the Department filter to narrow the list by department
Uncheck any roles you want to exclude
Click Generate competencies
💡 Tip: You can run Luma generation for a subset of roles if you only need competencies for a specific department or team. Uncheck everything else and generate for that group only.
Step 3: Review and Select Generated Competencies
Once the AI finishes, a Luma Generated Competencies panel appears with everything it produced. Nothing is applied until you confirm.
For each competency you will see:
Name and description
Mapped roles: the job roles Luma has linked this competency to, with a suggested proficiency level for each role
A Selected checkbox: checked by default
From here you can:
Deselect any competency you do not want to add
Remove individual role mappings using the × button next to each role tag
Review the count of selected competencies in the Add competency (X) button at the bottom
When you are satisfied with your selection, click Add competency to apply.
💡 Tip: Take time to review each suggestion before adding. Luma benchmarks against industry standards but may not reflect your organization's specific context. Edit any competency after adding it if the description or indicators need adjusting.
📝 Note: You can re-run Luma generation as many times as needed. Each run produces a fresh set of suggestions based on your current structure.
FAQs
Can I re-run Luma suggestions after already applying them?
Can I re-run Luma suggestions after already applying them?
Yes. You can run Ask Luma as many times as needed. Each run gives you a fresh set of suggestions to review before applying.
Will Luma overwrite competencies I have manually created?
Will Luma overwrite competencies I have manually created?
Only if you choose Reset & Regenerate. Luma Add Missing Competencies leaves existing competencies untouched and only generates new ones.
Can I edit Luma-generated competencies after adding them?
Can I edit Luma-generated competencies after adding them?
Yes. Once added, Luma-generated competencies behave exactly like manually created ones. You can edit names, descriptions, synonyms, and behaviour indicators at any time.
What happens to roles linked to deleted competencies if I use Reset & Regenerate?
What happens to roles linked to deleted competencies if I use Reset & Regenerate?
When competencies are deleted, they are removed from any roles they were linked to. The new Luma-generated competencies will need to be linked to roles as part of the new framework.
Does Luma use my company's data to generate suggestions?
Does Luma use my company's data to generate suggestions?
Yes. Luma uses your Company Profile, your Company Structure (job roles and departments), and your existing competency framework as context, combined with industry benchmark data.




