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.
Switch Skills on for the form, then click Skills to open Which skills do you want to assess?. Add one row per skill.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.
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 and contact types use text operators, and numeric, rating, and date types use comparisons. Multiple Choice and Dropdown use is one of, and File Upload uses file metadata operators. See the operator table.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.
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.
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.
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.
Criteria and Scoring judge a response rather than sorting it.
Test & Evaluate shows a bar per skill and the badges on the questions that feed them.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"HireData Docs","description":"Guides, how to's, and answers to your questions about HireData","colors":{"primary":"#7DC2CA","light":"#B1DADF","dark":"#39838B"},"logo":{"light":"https://mintcdn.com/hiredata/Pii9WVdQv6Pc1yMR/logo/light.svg?fit=max\u0026auto=format\u0026n=Pii9WVdQv6Pc1yMR\u0026q=85\u0026s=db078cfb402d8486f2a0b75131261055","dark":"https://mintcdn.com/hiredata/Pii9WVdQv6Pc1yMR/logo/dark.svg?fit=max\u0026auto=format\u0026n=Pii9WVdQv6Pc1yMR\u0026q=85\u0026s=b96e04b3cab0350c812239aed8483a1d"},"favicon":"https://mintcdn.com/hiredata/Pii9WVdQv6Pc1yMR/favicon.svg?fit=max\u0026auto=format\u0026n=Pii9WVdQv6Pc1yMR\u0026q=85\u0026s=7443bc080236de4a0bb1b66812a1a1fc","background":{"color":{"light":"#FAFAF5","dark":"#0F132F"}},"navbar":{"links":[{"href":"mailto:support@hiredata.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.mintlify.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/hiredata"}},"fonts":{"heading":{"family":"Lexend"}},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"section","latex":true},"integrations":{},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"light"},"interaction":{"drilldown":true},"navigation":{"languages":[{"language":"en","href":""},{"language":"nl","href":"nl"},{"language":"pt","href":"pt"},{"language":"de","href":"de"},{"language":"fr","href":"fr"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hiredata","hasAudioNarration":false,"actualSubdomain":"hiredata","customDomains":["help.hiredata.com"],"gitSource":{"type":"github","owner":"hiredata","repo":"documentation","deployBranch":"main","isPrivate":false,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad822be00ee183f0811e9c4","collectionId":"0e6df5ac-83a2-483e-b8b5-2d01990f27a1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad822be00ee183f0811e9c4"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ad822be00ee183f0811e9c4","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"en","tag":"Reference","count":59},{"language":"de","tag":"Referenz","count":59},{"language":"fr","tag":"Référence","count":59},{"language":"nl","tag":"Referentie","count":59},{"language":"pt","tag":"Referência","count":59},{"language":"en","tag":"Integrations","count":46},{"language":"de","tag":"Integrationen","count":46},{"language":"de","tag":"Carerix","count":46},{"language":"fr","tag":"Intégrations","count":46},{"language":"fr","tag":"Carerix","count":46},{"language":"nl","tag":"Integraties","count":46},{"language":"nl","tag":"Carerix","count":46},{"language":"pt","tag":"Integrações","count":46},{"language":"pt","tag":"Carerix","count":46},{"language":"en","tag":"Documentation","count":37},{"language":"de","tag":"Dokumentation","count":37},{"language":"fr","tag":"Documentation","count":37},{"language":"nl","tag":"Documentatie","count":37},{"language":"pt","tag":"Documentação","count":37},{"language":"de","tag":"Einrichtung","count":34},{"language":"fr","tag":"Configuration","count":34},{"language":"nl","tag":"Installatie","count":34},{"language":"pt","tag":"Configuração","count":34},{"language":"en","tag":"ATS","count":31},{"language":"en","tag":"Forms","count":26},{"language":"de","tag":"Formulare","count":26},{"language":"fr","tag":"Formulaires","count":26},{"language":"nl","tag":"Formulieren","count":26},{"language":"pt","tag":"Formulários","count":26},{"language":"en","tag":"Automations","count":19},{"language":"de","tag":"Automatisierungen","count":19},{"language":"fr","tag":"Automatisations","count":19},{"language":"nl","tag":"Automatiseringen","count":19},{"language":"en","tag":"Messaging","count":17},{"language":"en","tag":"Carerix","count":15},{"language":"en","tag":"Knowledge Base","count":15},{"language":"en","tag":"Emails","count":15},{"language":"de","tag":"Wissensdatenbank","count":15},{"language":"de","tag":"E-Mails","count":15},{"language":"de","tag":"Formularfelder","count":15},{"language":"fr","tag":"Base de connaissances","count":15},{"language":"fr","tag":"E-mails","count":15},{"language":"fr","tag":"Champs de formulaire","count":15},{"language":"nl","tag":"Kennisbank","count":15},{"language":"nl","tag":"E-mails","count":15},{"language":"nl","tag":"Formuliervelden","count":15},{"language":"pt","tag":"Base de conhecimento","count":15},{"language":"pt","tag":"Automatizações","count":15},{"language":"pt","tag":"Emails","count":15},{"language":"pt","tag":"Campos de formulário","count":15}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@hiredata.com"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"reference/forms/evaluation/skills","slug":"/reference/forms/evaluation/skills","pageMetadata":{"title":"Skills","sidebarTitle":"Skills","description":"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.","keywords":["profiling","skills assessment","primary skill","skill weighting","candidate profile"],"href":"/reference/forms/evaluation/skills"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,OptimizedImage,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`the-skills-list`,children:`The skills list`}),`\n`,_jsxs(_components.p,{children:[`Switch `,_jsx(_components.strong,{children:`Skills`}),` on for the form, then click `,_jsx(_components.strong,{children:`Skills`}),` to open `,_jsx(_components.strong,{children:`Which skills do you want to assess?`}),`. Add one row per skill.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/06-skills-list.png?fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=123f161163bd93331d7735a967c1d937`,alt:`The Skills block open with two skills, Availability and Communication, and the description popup open on the first`,width:`581`,\"data-og-width\":`1162`,\"data-og-height\":`474`,\"data-path\":`images/forms-builder/evaluation/06-skills-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/06-skills-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=51b1ac5d9a51fd81c307436b7d70b014 280w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/06-skills-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=a6dea0869259dac9d970dfd33cc4f73a 560w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/06-skills-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=0ddd02335ce4b6329425dabd9230a3dd 840w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/06-skills-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=45f56270abdd2125bd03418cbda623dd 1100w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/06-skills-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=1c370110f556200917cbfa14dbb5de77 1650w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/06-skills-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=331967e0f3caf0c22d740c8198fcd214 2500w`}),`\n`,_jsxs(_components.p,{children:[`Each row has the `,_jsx(_components.strong,{children:`Skill name`}),`, a gear, and a bin. The gear opens `,_jsx(_components.strong,{children:`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 `,_jsx(_components.strong,{children:`Evaluate with AI`}),`. `,_jsx(_components.strong,{children:`Add skill`}),` adds a row.`]}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`settings-per-question`,children:`Settings per question`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Skills`}),`, switch a question on, and its settings open.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`How to evaluate?`}),` with `,_jsx(_components.strong,{children:`Use answer rules`}),` and `,_jsx(_components.strong,{children:`Evaluate with AI`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`When should skill impact be applied?`}),`, on the rules side, holding one or more rules.`]}),`\n`,_jsxs(_components.li,{children:[`The note box, labelled `,_jsx(_components.strong,{children:`What skill signals should AI look for?`}),`.`]}),`\n`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/07-skills-rules.png?fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=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:`488`,\"data-og-width\":`976`,\"data-og-height\":`1240`,\"data-path\":`images/forms-builder/evaluation/07-skills-rules.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/07-skills-rules.png?w=280\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=e958d5bc9fa2c86338130e0685b5f60a 280w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/07-skills-rules.png?w=560\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=e8099649a3a1d919c0406a9d8adb140d 560w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/07-skills-rules.png?w=840\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=fbb2c29602e2c655d6469a6368613bae 840w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/07-skills-rules.png?w=1100\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=944c101ecfd1ee36051667833447707e 1100w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/07-skills-rules.png?w=1650\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=c0cba7d844537d0679c1e24860ef021a 1650w, https://mintcdn.com/hiredata/O0iPMTZzMYN4_Z17/images/forms-builder/evaluation/07-skills-rules.png?w=2500\u0026fit=max\u0026auto=format\u0026n=O0iPMTZzMYN4_Z17\u0026q=85\u0026s=b78d3c637b7ca8e4b329ea9a0e902905 2500w`}),`\n`,_jsx(Heading,{level:`3`,id:`rules-and-skill-impact`,children:`Rules and skill impact`}),`\n`,_jsxs(_components.p,{children:[`A rule is a set of conditions plus one or more skill impacts. A condition reads `,_jsx(_components.code,{children:`\u003cquestion> \u003coperator> \u003cvalue>`}),` and can only test this question’s answer. `,_jsx(_components.strong,{children:`Add condition`}),` adds a second one and an `,_jsx(_components.strong,{children:`All`}),` and `,_jsx(_components.strong,{children:`Any`}),` switch above it.`]}),`\n`,_jsxs(_components.p,{children:[`The operators are the same set Criteria offers, and the field type decides them. Text and contact types use text operators, and numeric, rating, and date types use comparisons. Multiple Choice and Dropdown use `,_jsx(_components.strong,{children:`is one of`}),`, and File Upload uses file metadata operators. See `,_jsx(_components.a,{href:`/reference/forms/evaluation/criteria#operators`,children:`the operator table`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Each impact has `,_jsx(_components.strong,{children:`Which skill does this answer indicate?`}),` and `,_jsx(_components.strong,{children:`How much should it contribute?`}),`. `,_jsx(_components.strong,{children:`Add skill impact`}),` points the same rule at a second skill, so one answer can count towards two. `,_jsx(_components.strong,{children:`Add rule`}),` adds another rule, which is how one question gives different weights to different answers.`]}),`\n`,_jsx(Heading,{level:`3`,id:`evaluating-with-ai`,children:`Evaluating with AI`}),`\n`,_jsxs(_components.p,{children:[`Switch to `,_jsx(_components.strong,{children:`Evaluate with AI`}),` and the rules disappear. The model reads the answer, your note, and the skill descriptions, and returns a weight per skill.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsx(Heading,{level:`2`,id:`how-the-percentages-are-worked-out`,children:`How the percentages are worked out`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.strong,{children:`strongest skill`}),` is the highest percentage.`]}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsxs(_components.p,{children:[`Automations read `,_jsx(_components.code,{children:`{{form_response.evaluation.profiling.primary_skill.key}}`}),` and `,_jsx(_components.code,{children:`{{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.`]}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/reference/forms/evaluation/overview`,children:`Form evaluation overview`}),` covers the five evaluators and the order you switch them on in.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/reference/forms/evaluation/criteria`,children:`Criteria`}),` and `,_jsx(_components.a,{href:`/reference/forms/evaluation/scoring`,children:`Scoring`}),` judge a response rather than sorting it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/reference/forms/testing/test-and-evaluate`,children:`Test \u0026 Evaluate`}),` shows a bar per skill and the badges on the questions that feed them.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Skills","sidebarTitle":"Skills","description":"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.","keywords":["profiling","skills assessment","primary skill","skill weighting","candidate profile"],"href":"/reference/forms/evaluation/skills"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The skills list","slug":"the-skills-list","depth":2,"children":[]},{"title":"Settings per question","slug":"settings-per-question","depth":2,"children":[{"title":"Rules and skill impact","slug":"rules-and-skill-impact","depth":3,"children":[]},{"title":"Evaluating with AI","slug":"evaluating-with-ai","depth":3,"children":[]}]},{"title":"How the percentages are worked out","slug":"how-the-percentages-are-worked-out","depth":2,"children":[]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"hiredata","siteName":"HireData Docs","title":"Skills - HireData Docs","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6ad80cd2d9ad4d7ad7ba62d3","deploymentId":"69e79f0ba743ec9e6eba74e4","questionText":"How do I set up skills assessment?","status":"active","generatedBy":"contextual","path":"reference/forms/evaluation/skills","createdAt":"2026-10-21T00:52:34.224Z","updatedAt":"2026-10-21T00:52:34.224Z","__v":0},{"_id":"6ad80cd2d9ad4d7ad7ba62d4","deploymentId":"69e79f0ba743ec9e6eba74e4","questionText":"How do I weight skill answers?","status":"active","generatedBy":"contextual","path":"reference/forms/evaluation/skills","createdAt":"2026-10-21T00:52:34.224Z","updatedAt":"2026-10-21T00:52:34.224Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/reference/forms/evaluation/skills","matchLevel":0},"nl":{"href":"/nl/reference/forms/evaluation/skills","matchLevel":1},"pt":{"href":"/pt/reference/forms/evaluation/skills","matchLevel":1},"de":{"href":"/de/reference/forms/evaluation/skills","matchLevel":1},"fr":{"href":"/fr/reference/forms/evaluation/skills","matchLevel":1}}},"lastModified":"2026-10-21T00:52:28.963Z","originalFileLocation":"reference/forms/evaluation/skills.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"HireData Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Skills - HireData Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"HireData Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.hiredata.com/reference/forms/evaluation/skills\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hiredata.mintlify.app/_mintlify/api/og/v2?division=Evaluation\u0026amp;title=Skills\u0026amp;description=List+the+skills+a+HireData+form+should+assess%2C+weight+the+answers+that+point+to+each+one%2C+and+read+back+the+strongest+skill+in+the+response.\u0026amp;theme=172544de576f8a6f72f29744\u0026amp;signature=7f4866ab3ae086e885bded150215c5e97c4901e09e3a73b9c89765d8a4669ecb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Skills - HireData Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hiredata.mintlify.app/_mintlify/api/og/v2?division=Evaluation\u0026amp;title=Skills\u0026amp;description=List+the+skills+a+HireData+form+should+assess%2C+weight+the+answers+that+point+to+each+one%2C+and+read+back+the+strongest+skill+in+the+response.\u0026amp;theme=172544de576f8a6f72f29744\u0026amp;signature=7f4866ab3ae086e885bded150215c5e97c4901e09e3a73b9c89765d8a4669ecb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/hiredata/0KgFb-8OXGQrkYG4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"HireData Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7DC2CA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.hiredata.com/reference/forms/evaluation/skills\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/forms/evaluation/skills.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://help.hiredata.com/reference/forms/evaluation/skills\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"nl\" href=\"https://help.hiredata.com/nl/reference/forms/evaluation/skills\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://help.hiredata.com/pt/reference/forms/evaluation/skills\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://help.hiredata.com/de/reference/forms/evaluation/skills\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://help.hiredata.com/fr/reference/forms/evaluation/skills\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://help.hiredata.com/reference/forms/evaluation/skills\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.hiredata.com/#organization\",\"name\":\"HireData Docs\",\"url\":\"https://help.hiredata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hiredata/Pii9WVdQv6Pc1yMR/logo/light.svg?fit=max\u0026auto=format\u0026n=Pii9WVdQv6Pc1yMR\u0026q=85\u0026s=db078cfb402d8486f2a0b75131261055\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.hiredata.com#website\",\"name\":\"HireData Docs\",\"url\":\"https://help.hiredata.com\",\"publisher\":{\"@id\":\"https://help.hiredata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.hiredata.com/reference/forms/evaluation/skills#webpage\",\"url\":\"https://help.hiredata.com/reference/forms/evaluation/skills\",\"name\":\"Skills\",\"description\":\"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.\",\"dateModified\":\"2026-10-21T00:52:28.963Z\",\"isPartOf\":{\"@id\":\"https://help.hiredata.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.hiredata.com/reference/forms/evaluation/skills#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.hiredata.com/reference/forms/evaluation/skills#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Forms\",\"item\":\"https://help.hiredata.com/reference/forms/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Evaluation\",\"item\":\"https://help.hiredata.com/reference/forms/evaluation/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Skills\",\"item\":\"https://help.hiredata.com/reference/forms/evaluation/skills\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://help.hiredata.com/reference/forms/evaluation/skills#article\",\"headline\":\"Skills\",\"name\":\"Skills\",\"description\":\"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.\",\"url\":\"https://help.hiredata.com/reference/forms/evaluation/skills\",\"mainEntityOfPage\":{\"@id\":\"https://help.hiredata.com/reference/forms/evaluation/skills#webpage\"},\"dateModified\":\"2026-10-21T00:52:28.963Z\",\"keywords\":\"profiling, skills assessment, primary skill, skill weighting, candidate profile\",\"publisher\":{\"@id\":\"https://help.hiredata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.hiredata.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"HireData Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"HireData Docs","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/apps/introduction"}]},{"tab":"Knowledge Base","pages":[{"title":"Knowledge Base","href":"/knowledge-base/run-cancellation-reasons"}]},{"tab":"Reference","groups":[{"group":"Automations","icon":"bolt","pages":[{"title":"Automation steps and what each does in a run","sidebarTitle":"Overview","href":"/reference/automations/overview"},{"group":"Steps","pages":[{"title":"Setup","sidebarTitle":"Setup","href":"/reference/automations/steps/setup"},{"title":"Add","sidebarTitle":"Add","href":"/reference/automations/steps/add"},{"title":"Delay","sidebarTitle":"Delay","href":"/reference/automations/steps/delay"},{"title":"Filter","sidebarTitle":"Filter","href":"/reference/automations/steps/filter"},{"title":"Find","sidebarTitle":"Find","href":"/reference/automations/steps/find"},{"title":"Loop","sidebarTitle":"Loop","href":"/reference/automations/steps/loop"},{"title":"Message","sidebarTitle":"Message","href":"/reference/automations/steps/message"},{"title":"Prompt","sidebarTitle":"Prompt","href":"/reference/automations/steps/prompt"},{"title":"Split","sidebarTitle":"Split","href":"/reference/automations/steps/split"},{"title":"Update","sidebarTitle":"Update","href":"/reference/automations/steps/update"}]},{"title":"Task catalogue","sidebarTitle":"Task catalogue","href":"/reference/automations/task-catalogue"},{"group":"Tasks","pages":[{"title":"HTTP Request task","sidebarTitle":"HTTP Request","href":"/reference/automation-tasks/http-request-task"},{"title":"Send Email task","sidebarTitle":"Send Email","href":"/reference/automations/tasks/send-email"}]},{"title":"Follow a run","sidebarTitle":"Follow a run","href":"/reference/automations/follow-a-run"}]},{"group":"Forms","icon":"list-check","pages":[{"title":"Form builder tour: tabs, field types, and shared settings","sidebarTitle":"Overview","href":"/reference/forms/overview"},{"title":"Logic","sidebarTitle":"Logic","href":"/reference/forms/logic"},{"title":"Objects","sidebarTitle":"Objects","href":"/reference/forms/objects"},{"title":"Data sources","sidebarTitle":"Data sources","href":"/reference/forms/data-sources"},{"group":"Form fields","pages":[{"title":"Short Text and Long Text","sidebarTitle":"Short and Long Text","href":"/reference/forms/fields/short-and-long-text"},{"title":"Email","sidebarTitle":"Email","href":"/reference/forms/fields/email"},{"title":"Phone Number","sidebarTitle":"Phone Number","href":"/reference/forms/fields/phone-number"},{"title":"Website","sidebarTitle":"Website","href":"/reference/forms/fields/website"},{"title":"Date","sidebarTitle":"Date","href":"/reference/forms/fields/date"},{"title":"Time","sidebarTitle":"Time","href":"/reference/forms/fields/time"},{"title":"Datetime","sidebarTitle":"Datetime","href":"/reference/forms/fields/datetime"},{"title":"Yes/No","sidebarTitle":"Yes/No","href":"/reference/forms/fields/yes-no"},{"title":"Multiple Choice and Dropdown","sidebarTitle":"Multiple Choice and Dropdown","href":"/reference/forms/fields/multiple-choice-and-dropdown"},{"title":"Number","sidebarTitle":"Number","href":"/reference/forms/fields/number"},{"title":"Currency","sidebarTitle":"Currency","href":"/reference/forms/fields/currency"},{"title":"Net Promoter Score and Opinion Scale","sidebarTitle":"NPS and Opinion Scale","href":"/reference/forms/fields/net-promoter-score-and-opinion-scale"},{"title":"File Upload","sidebarTitle":"File Upload","href":"/reference/forms/fields/file-upload"},{"title":"Ending Screen","sidebarTitle":"Ending Screen","href":"/reference/forms/fields/ending-screen"},{"title":"Redirect URL","sidebarTitle":"Redirect URL","href":"/reference/forms/fields/redirect-url"}]},{"group":"Evaluation","pages":[{"title":"Form evaluation overview","sidebarTitle":"Overview","href":"/reference/forms/evaluation/overview"},{"title":"Criteria","sidebarTitle":"Criteria","href":"/reference/forms/evaluation/criteria"},{"title":"Scoring","sidebarTitle":"Scoring","description":"Award points for form answers with rules or with AI, turn the total into a percentage, and label it with a score range such as Low, Medium, or High.","href":"/reference/forms/evaluation/scoring"},{"title":"Skills","sidebarTitle":"Skills","href":"/reference/forms/evaluation/skills"},{"title":"Generated fields","sidebarTitle":"Generated fields","description":"Define custom output fields on a HireData form and let AI fill them from the whole response, then read the generated values in an automation.","href":"/reference/forms/evaluation/generated-fields"}]},{"group":"Testing","pages":[{"title":"Previews","sidebarTitle":"Previews","href":"/reference/forms/testing/previews"},{"title":"Test \u0026 Evaluate","sidebarTitle":"Test \u0026 Evaluate","href":"/reference/forms/testing/test-and-evaluate"}]}]},{"group":"Emails","icon":"envelope","pages":[{"title":"Email builder tour: blocks, toolbar, theme, and saving","sidebarTitle":"Overview","href":"/reference/email-builder/overview"},{"title":"Template","sidebarTitle":"Template","href":"/reference/email-builder/template"},{"title":"Sections","sidebarTitle":"Sections","href":"/reference/email-builder/sections"},{"group":"Blocks","pages":[{"title":"Paragraph","sidebarTitle":"Paragraph","href":"/reference/email-builder/blocks/paragraph"},{"title":"Heading","sidebarTitle":"Heading","href":"/reference/email-builder/blocks/heading"},{"title":"Two Columns","sidebarTitle":"Two Columns","href":"/reference/email-builder/blocks/columns"},{"title":"Form","sidebarTitle":"Form","href":"/reference/email-builder/blocks/form"},{"title":"Image","sidebarTitle":"Image","href":"/reference/email-builder/blocks/image"},{"title":"Socials","sidebarTitle":"Socials","href":"/reference/email-builder/blocks/socials"},{"title":"Button","sidebarTitle":"Button","href":"/reference/email-builder/blocks/button"},{"title":"HTML","sidebarTitle":"HTML","href":"/reference/email-builder/blocks/html"},{"title":"Signature","sidebarTitle":"Signature","href":"/reference/email-builder/blocks/signature"}]},{"title":"Variables","sidebarTitle":"Variables","href":"/reference/email-builder/variables"},{"title":"Translations","sidebarTitle":"Translations","href":"/reference/email-builder/translations"},{"title":"Testing","sidebarTitle":"Testing","href":"/reference/email-builder/testing"}]},{"group":"Variables","icon":"brackets-curly","pages":[{"title":"Personalise messages and forms with variables","sidebarTitle":"Introduction","href":"/variables/introduction"},{"title":"Modifiers","sidebarTitle":"Modifiers","href":"/variables/modifiers"},{"title":"AI variables","sidebarTitle":"AI variables","href":"/variables/ai-variables"}]}]}]},{"language":"nl","pages":[{"title":"nl","href":"/nl/reference/forms/evaluation/skills"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/reference/forms/evaluation/skills"}]},{"language":"de","pages":[{"title":"de","href":"/de/reference/forms/evaluation/skills"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/reference/forms/evaluation/skills"}]}]},"basePath":"","title":"Skills - HireData Docs","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-DL4wrF0w.js","lightbox-handle-r17bVUz3.js"]}