> ## Documentation Index
> Fetch the complete documentation index at: https://help.hiredata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> List the skills a HireData form should assess, weight the answers that point to each one, and read back the strongest skill in the response.

Skills works out what a response is mostly telling you. You list the skills the role cares about, say which answers point to each one and how strongly, and HireData returns a percentage per skill and names the strongest.

Criteria and Scoring both judge. Skills sorts. It is the evaluator for a pool of candidates who all qualify, where the question is who to put in front of which client.

## The skills list

Switch **Skills** on for the form, then click **Skills** to open **Which skills do you want to assess?**. Add one row per skill.

<img src="https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/06-skills-list.png?fit=max&auto=format&n=O0iPMTZzMYN4_Z17&q=85&s=123f161163bd93331d7735a967c1d937" alt="The Skills block open with two skills, Availability and Communication, and the description popup open on the first" width="1162" height="474" data-path="images/forms-builder/evaluation/06-skills-list.png" />

Each row has the **Skill name**, a gear, and a bin. The gear opens **Description (optional)**, a sentence explaining what the skill means. The description is the AI's only guide to what counts, so write it when any question is set to **Evaluate with AI**. **Add skill** adds a row.

Removing a skill also removes it from every question that pointed to it. There is no undo, so check which questions use a skill before you delete it.

## Settings per question

Click **Skills**, switch a question on, and its settings open.

* **How to evaluate?** with **Use answer rules** and **Evaluate with AI**.
* **When should skill impact be applied?**, on the rules side, holding one or more rules.
* The note box, labelled **What skill signals should AI look for?**.

<img src="https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/07-skills-rules.png?fit=max&auto=format&n=O0iPMTZzMYN4_Z17&q=85&s=db8736827695c252c1d170b858e664d7" alt="A Yes/No question in the Skills block with a rule that adds a weight of 2 to Availability when the answer is Yes" width="976" height="1240" data-path="images/forms-builder/evaluation/07-skills-rules.png" />

### Rules and skill impact

A rule is a set of conditions plus one or more skill impacts. A condition reads `<question> <operator> <value>` and can only test this question's answer. **Add condition** adds a second one and an **All** and **Any** switch above it.

The operators are the same set Criteria offers, and the field type decides them: text operators on the text and contact types, comparisons on the numeric, rating, and date types, **is one of** on Multiple Choice and Dropdown, and file metadata on File Upload. See [the operator table](/reference/forms/evaluation/criteria#operators).

Each impact has **Which skill does this answer indicate?** and **How much should it contribute?**. **Add skill impact** points the same rule at a second skill, so one answer can count towards two. **Add rule** adds another rule, which is how one question gives different weights to different answers.

### Evaluating with AI

Switch to **Evaluate with AI** and the rules disappear. The model reads the answer, your note, and the skill descriptions, and returns a weight per skill.

<Warning>
  Add at least one skill to the form before switching a question to AI. AI skill assessment has nothing to weight without them, and the whole evaluation fails with an error.
</Warning>

## How the percentages are worked out

Weights are not scores. HireData adds up the weight each skill collected across the whole response, then gives each skill its share of that total, so the percentages add up to 100.

One answer worth 2 to Availability and one worth 1 to Communication makes Availability 66.67% and Communication 33.33%. Both numbers say where the signal came from, not how good the candidate is. The **strongest skill** is the highest percentage.

That relative maths has a consequence worth planning for. Weighting one skill heavily in many questions drowns the others out, whatever the answers say. Keep the weights comparable and spread them across the questions that genuinely indicate each skill.

Automations read `{{form_response.evaluation.profiling.primary_skill.key}}` and `{{form_response.evaluation.profiling.primary_skill.percentage}}`. Every skill you configured also gets its own percentage variable, so a rule can act on one skill without it having to win.

## Related

* [Form evaluation overview](/reference/forms/evaluation/overview) covers the five evaluators and the order you switch them on in.
* [Criteria](/reference/forms/evaluation/criteria) and [Scoring](/reference/forms/evaluation/scoring) judge a response rather than sorting it.
* [Test & Evaluate](/reference/forms/testing/test-and-evaluate) shows a bar per skill and the badges on the questions that feed them.


## Related topics

- [Create your own skill](/apps/mcp/create-your-own-skill.md)
- [Install the HireData skills with a prompt](/apps/mcp/install-hiredata-skills-with-a-prompt.md)
- [HireData skills for your AI assistant](/apps/mcp/hiredata-skills.md)
- [Keep your HireData skills up to date](/apps/mcp/keep-hiredata-skills-up-to-date.md)
- [Install the HireData plugin](/apps/mcp/install-hiredata-plugin.md)
