Why are some skills not matched when matchOntologySkills is enabled?

The matchOntologySkills feature in the Match API improves skill-matching relevance by using ontology alignment.

When "matchOntologySkills": true is enabled, the API filters and matches only those skills whose ontology category aligns with the relevant Job Profile ontology in both:

• Job Descriptions
• Candidate Profiles

Skills that do not align with the relevant Job Profile ontology may not be considered for matching.

Step 1: Enable matchOntologySkills

Use the following parameter in the Match API request:

"matchOntologySkills": true

Step 2: Understand Ontology-Based Matching

When enabled, the API:

• Reviews skills from the Job Description and Candidate Profile.
• Identifies the ontology category associated with each skill.
• Compares the skill ontology with the relevant Job Profile ontology.
• Retains relevant ontology-aligned skills for matching.
• Reduces unrelated or contextually irrelevant skill matches.

Step 3: Review Missing Skills

If an expected skill is not included in the match:

• Check the skills extracted from the Job Description.
• Check the skills extracted from the Candidate Profile.
• Verify that matchOntologySkills is enabled.
• Review whether the expected skill aligns with the relevant Job Profile ontology.

Step 4: Review Match Results

Compare the Match API response with and without:

"matchOntologySkills": true

Differences in matched skills can occur because ontology-based filtering is applied when the feature is enabled.

Step 5: Contact RChilli Support

If an expected skill appears relevant but is still excluded, provide the following details for analysis:

• Match API request
• Match API response
• Sample Job Description
• Sample Candidate Profile or resume
• Expected skill
• Relevant Job Profile

Benefits of matchOntologySkills

The feature helps:

• Reduce irrelevant skill matches.
• Improve match relevance.
• Improve matching precision.
• Provide more context-aware skill matching.
• Align skill matching with the relevant Job Profile ontology.
   

Note

matchOntologySkills does not simply match every extracted skill. Matching is refined according to the ontology category and its alignment with the relevant Job Profile ontology.

This provides more meaningful and context-aware skill matching in the Search Engine.

For more information, contact RChilli Support.