search_resumes_by_skill
Read-onlyIdempotent
Find resumes by matching one or more skills. Returns resume ID and matched skill names, with pagination support for browsing large results.
Instructions
Find which resumes list one or more given badge skills. Returns resume identity and matched skill names only — more token-efficient than list_resumes when filtering by skill. Accepts either a single skill string or a list of skills to filter by multiple at once.
Each result includes: id, first_name, last_name, matched_skills. Response includes total_count, items, has_more, next_offset, and message for pagination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Token match mode. For a single skill: 'and' (default) requires all words to appear in the skill title, 'or' requires any word to match, 'regex' treats it as a case-insensitive regular expression. For multiple skills, mode also controls whether a resume must match EACH skill in the list ('and') or ANY skill in the list ('or'); 'regex' mode combines multiple skills with OR semantics. | and |
| limit | No | Maximum number of results to return (default 100) | |
| skill | Yes | Skill title fragment, or list of fragments, to search for (case-insensitive, partial match) | |
| offset | No | Number of results to skip for pagination (default 0) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||