{"slug":"skill-based-search","title":"Searching Parlel by skills","description":"How skill search works on Parlel, how to pick terms people actually list, and how to combine skills with location and availability.","cluster":"Find people","updated":"2026-09-21","url":"https://parlel.com/guides/skill-based-search","markdown":"Skills are the primary index of the [people directory](/people). Titles vary by employer, bios vary by mood, but the skills list is where a person states what they can do in the fewest words. Searching it well is a small skill of its own.\n\n## Search the vocabulary people use, not the vocabulary reqs use\n\nProfiles are self-described. People list `react`, not \"frontend framework (3+ years)\"; `media-buying`, not \"performance marketing specialist\". Before you search, translate:\n\n- Job-post language (\"rockstar\", \"ninja\", \"guru\") into tool language (the actual stack).\n- Formal discipline names (\"information retrieval\") into practitioner terms (`opensearch`, `vector-databases`) -- then also try the formal term, because senior people often list both.\n- One broad term and one narrow term. `python` finds everyone; `python` plus `airflow` finds pipeline engineers.\n\n## Combine, do not just add\n\nA single skill is a superset. The search that finds your person is almost always a combination: skill plus location, or skill plus availability. \"Rust, Berlin\" and \"Rust, open to freelance\" are different searches with different best answers, and Parlel lets you run both in seconds. Start broad, look at who comes back, then narrow with the vocabulary the good results use -- the directory teaches you its own dialect if you read the first page before filtering further.\n\n## Skills are self-reported: calibrate\n\nAnyone can list any skill, so treat the list as a claim and the rest of the profile as evidence. Strong corroboration, in order:\n\n1. The skill appears in a work-history bullet with an outcome attached.\n2. The skill appears in a public post demonstrating it.\n3. The employer is [verified](/guides/verify-company) and the tenure is real.\n\nA profile listing twelve skills with no evidence for any of them is a weaker signal than a profile listing three, each tied to a project. [Recruiters sourcing at volume](/guides/source-candidates) should make this calibration a checklist step, not a gut feel.\n\n## For machines: the same search as an API\n\nSkill search is one of the eight MCP tools: `search_people` takes the same skill filters as the directory. If you are building screening, matching or analytics on top of Parlel, see the [MCP guide](/guides/parlel-mcp-guide) -- and [how Parlel search works](/guides/how-search-works) for what each parameter matches.\n","html":"<p>Skills are the primary index of the <a href=\"/people\">people directory</a>. Titles vary by employer, bios vary by mood, but the skills list is where a person states what they can do in the fewest words. Searching it well is a small skill of its own.</p>\n<h2>Search the vocabulary people use, not the vocabulary reqs use</h2>\n<p>Profiles are self-described. People list <code>react</code>, not \"frontend framework (3+ years)\"; <code>media-buying</code>, not \"performance marketing specialist\". Before you search, translate:</p>\n<ul>\n<li>Job-post language (\"rockstar\", \"ninja\", \"guru\") into tool language (the actual stack).</li>\n<li>Formal discipline names (\"information retrieval\") into practitioner terms (<code>opensearch</code>, <code>vector-databases</code>) -- then also try the formal term, because senior people often list both.</li>\n<li>One broad term and one narrow term. <code>python</code> finds everyone; <code>python</code> plus <code>airflow</code> finds pipeline engineers.</li>\n</ul>\n<h2>Combine, do not just add</h2>\n<p>A single skill is a superset. The search that finds your person is almost always a combination: skill plus location, or skill plus availability. \"Rust, Berlin\" and \"Rust, open to freelance\" are different searches with different best answers, and Parlel lets you run both in seconds. Start broad, look at who comes back, then narrow with the vocabulary the good results use -- the directory teaches you its own dialect if you read the first page before filtering further.</p>\n<h2>Skills are self-reported: calibrate</h2>\n<p>Anyone can list any skill, so treat the list as a claim and the rest of the profile as evidence. Strong corroboration, in order:</p>\n<ol>\n<li>The skill appears in a work-history bullet with an outcome attached.</li>\n<li>The skill appears in a public post demonstrating it.</li>\n<li>The employer is <a href=\"/guides/verify-company\">verified</a> and the tenure is real.</li>\n</ol>\n<p>A profile listing twelve skills with no evidence for any of them is a weaker signal than a profile listing three, each tied to a project. <a href=\"/guides/source-candidates\">Recruiters sourcing at volume</a> should make this calibration a checklist step, not a gut feel.</p>\n<h2>For machines: the same search as an API</h2>\n<p>Skill search is one of the eight MCP tools: <code>search_people</code> takes the same skill filters as the directory. If you are building screening, matching or analytics on top of Parlel, see the <a href=\"/guides/parlel-mcp-guide\">MCP guide</a> -- and <a href=\"/guides/how-search-works\">how Parlel search works</a> for what each parameter matches.</p>","related":[{"slug":"find-people","title":"How to find people on Parlel","description":"Search published professional profiles by skill, location and availability. A practical guide to finding people on Parlel.","url":"https://parlel.com/guides/find-people"},{"slug":"source-candidates","title":"Sourcing candidates on Parlel: a recruiter's guide","description":"How recruiters source candidates from published Parlel profiles: skill search, availability filters, verification signals and outreach that works.","url":"https://parlel.com/guides/source-candidates"},{"slug":"find-freelancers","title":"Finding freelancers and contractors on Parlel","description":"How to find freelance and contract talent on Parlel: availability signals, profile markers, scoping the engagement and outreach.","url":"https://parlel.com/guides/find-freelancers"},{"slug":"how-search-works","title":"How Parlel search works","description":"What each Parlel search matches: people skills and location, company industry and hiring, job seniority, and the MCP equivalents.","url":"https://parlel.com/guides/how-search-works"}]}