{"id":"c7ad555c-e94e-436f-a416-0f5fde511660","shortId":"3JGqKN","kind":"skill","title":"find-recruiting-firm","tagline":"Use whenever the user wants to find, shortlist, vet, or enrich US recruiting and staffing firms — executive search/retained search, RPO, tech/sales/healthcare recruiting, contingent/contract staffing, and temp staffing. Triggers on \"find me an executive search firm for a CFO sear","description":"# find-recruiting-firm\n\nDrive the **ServiceGraph API** (`https://api.servicegraph.co`) to find,\nshortlist, and enrich US recruiting and staffing firms.\n\n**This skill is for procuring an external recruiting/staffing firm**\nto do hiring on the user's behalf. It is NOT for:\n- recruiting an in-house employee (the user wants to hire someone for\n  their own team — that's job-posting, not procurement),\n- candidate-side asks (an individual job-seeker looking for someone\n  to represent them).\n\nBoth cases share keyword overlap with the positive case (\"recruiter\",\n\"hire\") so the boundary matters.\n\n**Always pin `industry:hr_recruiting_staffing`.** Sub-types\n(executive search, RPO, contingent staffing, temp, vertical\nspecializations) are NOT separate tags — sub-type specialization is a\nkeyword substring search on firm text.\n\nAny HTTP client works (curl, fetch, requests). Examples below use curl.\n\n## When NOT to use this skill\n\n- \"I want to hire a [role] for my team — where should I post the job?\"\n  → that's recruiting-an-employee, not procuring a firm.\n- \"Find me a recruiter to represent me in my job search\" → candidate side.\n- \"Hire an in-house recruiter / Head of Talent\" → recruiting an employee.\n- \"Help me write a job description\" → DIY/do-the-work.\n- ATS or HR-software comparisons (Greenhouse vs Lever, Workday, etc.).\n- Career coaching for individual job-seekers.\n- Non-US firms.\n- Individual freelance recruiters.\n\nIf the user is a *business* procuring external recruiting/staffing\nservices (executive search, RPO, contingent staffing), this skill\napplies — defaults to fire on B2B procurement intent.\n\n## MCP server (preferred for authed calls)\n\nIf your agent harness has the **ServiceGraph MCP server** loaded\n(`https://mcp.servicegraph.co`), prefer its tools for the **authed**\ntier (`/search`, `/get`, `/stats`). The MCP server uses OAuth 2.1 +\nPKCE — the host harness handles credentials in its own audited\nsandbox, so there's no `.env.local`, no shell dispatch, and no token\nvalue ever enters the LLM context.\n\nFor the **anonymous** tier (`/tags`, `/check`, `/explore`), MCP is\n**not** preferred — every MCP tool requires OAuth (the server has no\nanonymous tier), so plain curl against the REST URL is the simpler\npath for discovery calls. Use the REST patterns below for those.\n\nThe MCP tools 1:1-map to the public REST endpoints — same backend,\nsame quota, same data:\n\n| MCP tool | REST endpoint | Anon? | Recommended path |\n|---|---|---|---|\n| `list_tags` | `GET /v1/tags` | yes | curl |\n| `check_filter` | `GET /v1/check` | yes | curl |\n| `explore_firms` | `GET /v1/explore` | yes | curl |\n| `search_firms` | `GET /v1/search` | no | MCP if loaded, else curl + OTP |\n| `get_firm` | `GET /v1/get/:id` | no | MCP if loaded, else curl + OTP |\n| `catalog_stats` | `GET /v1/stats` | no | MCP if loaded, else curl + OTP |\n\n**Detection**: if you see any MCP tools with `servicegraph` in the\nname (the harness-specific prefix varies — agents pattern-match the\nsubstring), the ServiceGraph MCP server is loaded. Prefer those\ntools for the authed tier; complete any auth flow the harness\ninitiates if needed. If no `servicegraph` MCP tools are present,\nfall through to the REST + OTP flow below for the authed tier.\n\n## The four-tier funnel\n\n| Tier | Auth | Cost | Use it for |\n|---|---|---|---|\n| `GET /v1/tags` | none | free | **First call of every session.** Discover legal field names, kinds, operators, values. |\n| `GET /v1/check?filter=...` | none | free | Validate a filter before spending an explore/search call. |\n| `GET /v1/explore?filter=...` | none | free, IP-throttled | Scope: count + breakdowns. Use to size the candidate pool before quota-spending. |\n| `GET /v1/search?filter=...` | bearer | 200 unique firms / month free | Brief firm cards. **No url, no contact info.** Use for ranking / shortlisting. |\n| `GET /v1/get/:id` | bearer | 50 unique firms / month free | Full bundle: url, phone, email, social, legal name, address. **Only call for shortlisted firms.** |\n| `POST /v1/research` | paid | not in MVP | Deferred — skip. |\n\n**Quota rule that matters**: `/search` and `/get` charge per *unique\nfirm viewed per calendar month*, not per call. Re-paging the same\nquery is free. Two different filters that overlap charge once for\nthe overlap. Re-fetching a firm you already pulled this month is free.\n\n## Session-start ritual\n\nBefore constructing any filter, call:\n\n```\nGET https://api.servicegraph.co/v1/tags?include_values=1\n```\n\nCache the response for the conversation. Confirm\n`hr_recruiting_staffing` is in the `industry` value list (the exact\nvalue name may vary slightly in different catalog releases).\n\nField kinds you'll use most:\n- **categorical**: `industry` (always `hr_recruiting_staffing`), `state`, `pricing_model`, `company_size_signal`, `geography_served` — op `:`\n- **numeric**: `rating`, `review_count_total`, `founded_year` — ops `= >= <= > <`\n- **presence**: `has:phone`, `has:clutch`, `has:rating`, `has:linkedin_company`, …\n- **keyword**: free-text substring across firm name / brand / title / meta / legal_name. **This is how you specialize on sub-type** (executive, retained, RPO, contingent, temp, tech, healthcare, sales, etc.).\n\n## Auth\n\n`/tags`, `/check`, and `/explore` are anonymous. `/search` and `/get`\nrequire a bearer token.\n\n**Security model — keep the token out of the LLM context.**\n\n- **Never** read `.env`, `.env.local`, or any other credential file\n  into your context. The token's literal value should never appear\n  in the conversation.\n- Use shell dispatch for every authed request so the token flows\n  directly from the user's environment / dotenv file into the\n  `Authorization` header without round-tripping through the LLM.\n- **Always ask the user once per session** before using a detected\n  token, even if it's already in their shell or `.env.local`.\n\n**Resolution rule**:\n\n1. **Detect** whether a token is available — without reading its\n   value. Run a shell check that only inspects exit codes:\n\n   ```bash\n   ( [ -n \"${SERVICEGRAPH_TOKEN:-}\" ] \\\n     || grep -qs '^SERVICEGRAPH_TOKEN=' .env.local \\\n     || grep -qs '^SERVICEGRAPH_TOKEN=' .env )\n   ```\n\n   Exit code `0` = token is available somewhere; non-zero = no token.\n\n2. **Confirm with the user** before the first authed call this session:\n\n   > \"I found a `SERVICEGRAPH_TOKEN` in your environment / `.env.local`.\n   > OK to use it for ServiceGraph API requests this session?\"\n\n   If the user says no, stay on the anonymous tiers (`/tags`, `/check`,\n   `/explore`) and skip authed calls. Don't re-ask later unless the\n   user asks for authed work.\n\n3. **Dispatch via shell** — every authed call goes through a shell\n   wrapper so the literal token never enters the conversation:\n\n   ```bash\n   # If exported in the shell environment:\n   curl -H \"Authorization: Bearer $SERVICEGRAPH_TOKEN\" \\\n        'https://api.servicegraph.co/v1/search?filter=...'\n\n   # If in .env.local — source it inside a subshell so it doesn't\n   # leak into the parent shell either:\n   ( set -a; . ./.env.local; set +a;\n     curl -H \"Authorization: Bearer $SERVICEGRAPH_TOKEN\" \\\n          'https://api.servicegraph.co/v1/search?filter=...' )\n   ```\n\n   Capture the response body to a tmp file or jq-process it, but do\n   NOT echo the request command with the token expanded.\n\n4. **OTP flow** if no token is detected — capture the new token\n   directly into `.env.local` without surfacing its value to the LLM:\n\n   ```bash\n   # 1. trigger the email — agent prompts the user for $EMAIL\n   curl -fsS -X POST 'https://api.servicegraph.co/v1/auth/request-otp' \\\n     -H 'Content-Type: application/json' \\\n     -d \"{\\\"email\\\":\\\"$EMAIL\\\"}\"\n\n   # 2. exchange the code — agent prompts the user for $CODE.\n   #    The ?format=env query param returns SERVICEGRAPH_TOKEN=<token>\n   #    as plain text appended to .env.local — no jq needed. The -f\n   #    flag makes curl exit non-zero on 4xx so a wrong code doesn't\n   #    pollute the file (the error mirror is also a `# comment` line,\n   #    safe to ignore even if it lands).\n   curl -fsS -X POST 'https://api.servicegraph.co/v1/auth/verify-otp?format=env' \\\n     -H 'Content-Type: application/json' \\\n     -d \"{\\\"email\\\":\\\"$EMAIL\\\",\\\"code\\\":\\\"$CODE\\\",\\\"name\\\":\\\"claude-cli\\\"}\" \\\n     >> .env.local\n\n   # 3. confirm capture without revealing the value\n   grep -q '^SERVICEGRAPH_TOKEN=' .env.local && echo \"OTP token captured.\"\n   ```\n\n   After a successful capture, the user has implicitly consented\n   (they just completed the flow), so proceed to dispatch (step 3).\n   The token is now persistent in `.env.local` for future sessions.\n\n5. If a `/search` or `/get` returns `401 unauthorized` mid-session,\n   the token expired or was revoked — re-run the OTP flow.\n\n## Filter DSL\n\nOne query parameter, GitHub-search-style.\n\n```\nfilter   := orExpr\norExpr   := andExpr (\"OR\" andExpr)*\nandExpr  := notExpr ((\"AND\")? notExpr)*    # whitespace = implicit AND\nnotExpr  := (\"NOT\" | \"-\") notExpr | atom\natom     := \"(\" filter \")\" | predicate\npredicate:= IDENT op valueOrList | bareword\nop       := \":\" | \"=\" | \">=\" | \"<=\" | \">\" | \"<\"\nvalueOrList := value (\",\" value)*\nvalue    := IDENT | NUMBER | tagAtEvidence\ntagAtEvidence := IDENT \"@\" (\"low\"|\"medium\"|\"high\")\nbareword := IDENT | NUMBER          # → keyword:<bareword>\n```\n\n**Four rules that bite:**\n\n1. **AND binds tighter than OR.** `a OR b c` parses as `a OR (b AND c)`.\n   Use parens.\n2. **Comma list = OR within one predicate.** `state:CA,NY,TX` matches\n   any of the three.\n3. **Negation is `-x` or `NOT x`.** Negative literals inside a comma\n   list are **not** allowed: `state:CA,-NY` is rejected. Use\n   `state:CA -state:NY`.\n4. **Bareword = keyword search.** Any IDENT or NUMBER not followed by\n   an operator becomes a free-text substring across name / brand /\n   title / meta / legal_name. Multiple barewords AND.\n\n**Recruiting-flavored examples** (validate yours with `/v1/check`):\n\n```\nindustry:hr_recruiting_staffing executive search\nindustry:hr_recruiting_staffing retained search state:NY tech\nindustry:hr_recruiting_staffing rpo state:CA\nindustry:hr_recruiting_staffing contingent staffing\nindustry:hr_recruiting_staffing healthcare state:TX,FL\nindustry:hr_recruiting_staffing sales saas\nindustry:hr_recruiting_staffing rating>=4 has:clutch\n```\n\nWhen in doubt, hit `/v1/check?filter=...` first.\n\n**Sub-type → keyword mapping**:\n\n| User asks for | Add as keyword(s) |\n|---|---|\n| Executive search / retained search | `executive`, `retained` |\n| RPO (recruitment process outsourcing) | `rpo`, `recruitment process outsourcing` |\n| Contingent / contract staffing | `contingent`, `contract` |\n| Temp / temporary staffing | `temp`, `temporary` |\n| Tech recruiting | `tech`, `technical`, `engineering` |\n| Sales recruiting | `sales` |\n| Healthcare recruiting | `healthcare`, `clinical`, `nursing` |\n| Finance / accounting recruiting | `finance`, `accounting` |\n| Legal recruiting | `legal`, `attorney` |\n\n## firm_id contract\n\n`firm_id` is a stable 12-hex-char handle:\n\n```\nfirm_id = sha256(apex.lower().rstrip(\".\")).hexdigest()[:12]\n```\n\n```python\nimport hashlib\ndef firm_id(apex):\n    return hashlib.sha256(apex.lower().rstrip(\".\").encode()).hexdigest()[:12]\n```\n\n```bash\necho -n \"korn-ferry.com\" | tr 'A-Z' 'a-z' \\\n  | openssl dgst -sha256 -hex | awk '{print substr($2,1,12)}'\n```\n\n## Recipes\n\n### A. Executive search for a CFO\n\nUser: *\"Executive search firm for a CFO search.\"*\n\n```\nGET /v1/explore?filter=industry:hr_recruiting_staffing+executive+search\nGET /v1/search?filter=industry:hr_recruiting_staffing+executive+search&limit=10\nGET /v1/get/<firm_id>     # ×3\n```\n\n### B. Retained boutique in a state, vertical\n\nUser: *\"Retained-search boutiques in NY focused on tech executives.\"*\n\n```\nGET /v1/search?filter=industry:hr_recruiting_staffing+retained+state:NY+tech+-company_size_signal:large_50plus&limit=10\n```\n\n### C. RPO for a hiring surge\n\nUser: *\"RPO support for a 50-engineer hiring push.\"*\n\n```\nGET /v1/search?filter=industry:hr_recruiting_staffing+rpo+(tech OR engineering)\n```\n\n### D. Indirect intent — \"scaling fast, need help hiring\"\n\nUser: *\"We're scaling fast and need help hiring at scale — looking for\na partner.\"*\n\nThat's RPO or volume contingent staffing:\n\n```\nGET /v1/search?filter=industry:hr_recruiting_staffing+(rpo OR contingent)\n```\n\nIf the user names a function (engineering, sales, customer success),\nadd it as a keyword.\n\n### E. Vertical: healthcare staffing\n\nUser: *\"Healthcare staffing firms in the Midwest.\"*\n\n```\nGET /v1/search?filter=industry:hr_recruiting_staffing+healthcare+state:OH,IL,MI,IN,WI,MN\n```\n\n### F. Quality threshold + tech-sector\n\nUser: *\"Three executive search firms with 4-star ratings and tech-sector\nexperience.\"*\n\n```\nGET /v1/search?filter=industry:hr_recruiting_staffing+executive+search+tech+rating>=4&limit=10\n```\n\n### G. BYO apex list — enrich domains\n\nUser pastes 8–20 staffing/recruiting firm domains. For each:\n\n1. Compute `firm_id` locally.\n2. `GET /v1/get/<firm_id>` — full bundle if in catalog, 404 if not.\n3. Aggregate, present, flag the not-found ones.\n\n## Gotchas\n\n- **Always pin `industry:hr_recruiting_staffing`.** Without it, \"recruiter\" or \"executive search\" as keywords leak into other industries.\n- **Distinguish \"find me a recruiting firm\" (procurement, fires) from \"find me a recruiter / hire a recruiter for our team\" (recruiting-an-employee, refuses).** When ambiguous, lean on context: explicit firm/agency/RPO language or volume framing → procurement; \"for our team\" / \"to post the job\" / \"I want to hire\" → in-house hire.\n- **Candidate-side asks** (\"represent me as a candidate\", \"find me a job\") are out of scope. Refuse politely.\n- **Career coaching for individuals** is a different need (and shares the executive-coaching keyword with management consulting). Refuse — this skill is firm-procurement.\n- **Sub-types are keyword-only.** Multi-word sub-types split into ANDed barewords (`executive search` = `executive` AND `search`).\n- **`looks_not_pro_services` 404 is not a bug.** A `firm_id` may exist in `/search` but 404 on `/get` if it's been flagged. Skip and continue; not charged.\n- **`/v1/explore` k=20 suppression.** When fewer than 20 firms match, the response is `{\"count\": \"<20\", \"suppressed\": true, \"breakdowns\": {}}`. Drilling further makes the count smaller. Broaden or escalate to `/v1/search`.\n- **Briefs from `/search` do NOT include `apex`, `url`, `phone_primary`, `email_primary`, `legal_name`, or address.** If the user asks for contact info, you must `/get/:id`.\n- **Quota is per-user-per-month, deduped on first view.** Re-views are free; re-pagination is free.\n\n## Errors\n\nAll errors return JSON: `{\"error\": {\"code\": \"...\", \"message\": \"...\"}}`.\n\n| Status | Code | What to do |\n|---|---|---|\n| 400 | `filter_parse_error` | Payload includes `position`. Fix the filter, re-validate with `/v1/check`. |\n| 400 | `filter_required` | Empty filter where one is required. |\n| 400 | `invalid_firm_id` | firm_id must be 12 lowercase hex chars. Re-derive. |\n| 401 | `unauthorized` | Token missing/expired. Re-run OTP. |\n| 404 | `not_found` | Firm not in catalog or flagged. Not charged. Skip and continue. |\n| 429 | `rate_limited` | Honor `Retry-After` header / `retry_after` field. |\n| 429 | `monthly_quota_exhausted` | Switch to `/v1/explore`-only mode for the rest of the month. Tell the user. |\n\n## End-to-end example\n\nUser: *\"Three retained executive search firms in NY focused on tech\nCFOs, ideally with 4-star ratings and a Clutch profile.\"*\n\n```\nGET /v1/tags?include_values=1\nGET /v1/check?filter=industry:hr_recruiting_staffing+retained+executive+state:NY+tech+rating>=4+has:clutch\nGET /v1/explore?filter=industry:hr_recruiting_staffing+retained+executive+state:NY+tech+rating>=4+has:clutch\nGET /v1/search?filter=...&limit=10\nGET /v1/get/<firm_id>     # ×3\n```\n\nEnd of session: report `X-Quota-Remaining-Month`.","tags":["find","recruiting","firm","servicegraph","nostrband","agent-skills","ai-agents","b2b-data","claude-code-marketplace","claude-code-plugins","claude-code-skills","claude-plugins"],"capabilities":["skill","source-nostrband","skill-find-recruiting-firm","topic-agent-skills","topic-ai-agents","topic-b2b-data","topic-claude-code-marketplace","topic-claude-code-plugins","topic-claude-code-skills","topic-claude-plugins","topic-claude-skills","topic-mcp-server","topic-openapi","topic-professional-services","topic-vendor-discovery"],"categories":["ServiceGraph"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/nostrband/ServiceGraph/find-recruiting-firm","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add nostrband/ServiceGraph","source_repo":"https://github.com/nostrband/ServiceGraph","install_from":"skills.sh"}},"qualityScore":"0.530","qualityRationale":"deterministic score 0.53 from registry signals: · indexed on github topic:agent-skills · 160 github stars · SKILL.md body (15,831 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:56:03.620Z","embedding":null,"createdAt":"2026-05-06T12:58:11.452Z","updatedAt":"2026-05-18T18:56:03.620Z","lastSeenAt":"2026-05-18T18:56:03.620Z","tsv":"'/.env.local':1074 '/check':360,812,999 '/explore':361,814,1000 '/get':319,658,819,1293,2045,2110 '/search':318,656,817,1291,2041,2087 '/stats':320 '/tags':359,811,998 '/v1/auth/request-otp''':1149 '/v1/auth/verify-otp?format=env''':1226 '/v1/check':431,567,1464,1519,2160,2268 '/v1/explore':437,580,1651,2056,2224,2284 '/v1/get':454,622,1671,1872,2305 '/v1/research':645 '/v1/search':443,601,1660,1692,1725,1766,1802,1837,2084,2300 '/v1/search?filter=...''':1053,1085 '/v1/stats':466 '/v1/tags':425,551,2263 '/v1/tags?include_values=1':712 '0':947 '1':401,402,911,1133,1367,1633,1865,2266 '10':1669,1708,1849,2303 '12':1588,1599,1613,1634,2178 '2':957,1158,1386,1632,1870 '2.1':326 '20':1859,2058,2063,2070 '200':604 '3':1018,1242,1277,1402,1672,1881,2306 '4':1110,1428,1512,1828,1847,2255,2280,2296 '400':2146,2161,2170 '401':1295,2185 '404':1878,2030,2043,2193 '429':2207,2218 '4xx':1195 '5':1288 '50':625,1720 '50plus':1706 '8':1858 'a-z':1619,1622 'account':1572,1575 'across':784,1447 'add':1530,1785 'address':638,2100 'agent':302,492,1137,1162 'aggreg':1882 'allow':1417 'alreadi':694,903 'also':1209 'alway':137,748,887,1891 'ambigu':1934 'and':2019 'andexpr':1324,1326,1327 'anon':419 'anonym':357,375,816,996 'apex':1606,1852,2091 'apex.lower':1596,1609 'api':51,984 'api.servicegraph.co':52,711,1052,1084,1148,1225 'api.servicegraph.co/v1/auth/request-otp''':1147 'api.servicegraph.co/v1/auth/verify-otp?format=env''':1224 'api.servicegraph.co/v1/search?filter=...''':1051,1083 'api.servicegraph.co/v1/tags?include_values=1':710 'appear':853 'append':1179 'appli':286 'application/json':1154,1231 'ask':110,888,1009,1014,1528,1963,2104 'at':244 'atom':1337,1338 'attorney':1579 'audit':336 'auth':298,316,509,513,537,545,810,862,965,1003,1016,1023 'author':878,1047,1079 'avail':917,950 'awk':1629 'b':1375,1381,1673 'b2b':291 'backend':410 'bareword':1345,1359,1429,1455,2020 'bash':931,1038,1132,1614 'bearer':603,624,822,1048,1080 'becom':1441 'behalf':79 'bind':1369 'bite':1366 'bodi':1089 'boundari':135 'boutiqu':1675,1684 'brand':787,1449 'breakdown':589,2073 'brief':609,2085 'broaden':2080 'bug':2034 'bundl':631,1874 'busi':274 'byo':1851 'c':1376,1383,1709 'ca':1394,1419,1425,1486 'cach':713 'calendar':665 'call':299,390,555,578,640,669,708,966,1004,1024 'candid':108,223,594,1961,1968 'candidate-sid':107,1960 'captur':1086,1118,1244,1257,1261 'card':611 'career':255,1979 'case':123,130 'catalog':463,738,1877,2199 'categor':746 'cfo':42,1641,1648 'cfos':2252 'char':1591,2181 'charg':659,683,2055,2203 'check':428,925 'claud':1239 'claude-c':1238 'cli':1240 'client':172 'clinic':1569 'clutch':773,1514,2260,2282,2298 'coach':256,1980,1992 'code':930,946,1161,1167,1199,1235,1236,2139,2142 'comma':1387,1413 'command':1105 'comment':1211 'compani':755,778,1702 'comparison':249 'complet':511,1269 'comput':1866 'confirm':719,958,1243 'consent':1266 'construct':705 'consult':1996 'contact':615,2106 'content':1152,1229 'content-typ':1151,1228 'context':354,833,845,1937 'conting':149,282,804,1491,1548,1551,1763,1774 'contingent/contract':27 'continu':2053,2206 'contract':1549,1552,1582 'convers':718,856,1037 'cost':546 'count':588,764,2069,2078 'credenti':332,841 'curl':174,180,379,427,433,439,449,461,472,1045,1077,1143,1189,1220 'custom':1783 'd':1155,1232,1735 'data':414 'dedup':2119 'def':1603 'default':287 'defer':650 'deriv':2184 'descript':242 'detect':474,897,912,1117 'dgst':1626 'differ':679,737,1985 'direct':868,1122 'discov':559 'discoveri':389 'dispatch':345,859,1019,1275 'distinguish':1909 'diy/do-the-work':243 'doesn':1064,1200 'domain':1855,1862 'dotenv':874 'doubt':1517 'drill':2074 'drive':48 'dsl':1313 'e':1790 'echo':1102,1254,1615 'either':1071 'els':448,460,471 'email':634,1136,1142,1156,1157,1233,1234,2095 'employe':89,207,236,1931 'empti':2164 'encod':1611 'end':2237,2239,2307 'end-to-end':2236 'endpoint':408,418 'engin':1562,1721,1734,1781 'enrich':15,57,1854 'enter':351,1035 'env':836,944,1170 'env.local':342,837,908,939,977,1056,1124,1181,1241,1253,1284 'environ':873,976,1044 'error':1206,2133,2135,2138,2149 'escal':2082 'etc':254,809 'even':899,1216 'ever':350 'everi':366,557,861,1022 'exact':730 'exampl':177,1460,2240 'exchang':1159 'execut':21,37,146,279,801,1469,1534,1538,1637,1643,1657,1666,1690,1824,1843,1901,1991,2021,2023,2244,2275,2291 'executive-coach':1990 'exhaust':2221 'exist':2039 'exit':929,945,1190 'expand':1109 'experi':1835 'expir':1302 'explicit':1938 'explor':434 'explore/search':577 'export':1040 'extern':69,276 'f':1186,1816 'fall':527 'fast':1739,1747 'fetch':175,690 'fewer':2061 'field':561,740,2217 'file':842,875,1093,1204 'filter':429,568,573,581,602,680,707,1312,1321,1339,1520,1652,1661,1693,1726,1767,1803,1838,2147,2155,2162,2165,2269,2285,2301 'financ':1571,1574 'find':2,11,34,45,54,212,1910,1918,1969 'find-recruiting-firm':1,44 'fire':289,1916 'firm':4,20,39,47,62,71,168,211,265,435,441,452,606,610,627,643,662,692,785,1580,1583,1593,1604,1645,1797,1826,1861,1867,1914,2002,2036,2064,2172,2174,2196,2246 'firm-procur':2001 'firm/agency/rpo':1939 'first':554,964,1521,2121 'fix':2153 'fl':1500 'flag':1187,1884,2050,2201 'flavor':1459 'flow':514,533,867,1112,1271,1311 'focus':1687,2249 'follow':1437 'format':1169 'found':766,970,1888,2195 'four':541,1363 'four-tier':540 'frame':1943 'free':553,570,583,608,629,677,699,781,1444,2127,2132 'free-text':780,1443 'freelanc':267 'fss':1144,1221 'full':630,1873 'function':1780 'funnel':543 'futur':1286 'g':1850 'geographi':758 'get':424,430,436,442,451,453,465,550,566,579,600,621,709,1650,1659,1670,1691,1724,1765,1801,1836,1871,2262,2267,2283,2299,2304 'github':1318 'github-search-styl':1317 'goe':1025 'gotcha':1890 'greenhous':250 'grep':935,940,1249 'h':1046,1078,1150,1227 'handl':331,1592 'har':303,330,488,516 'harness-specif':487 'hashlib':1602 'hashlib.sha256':1608 'head':231 'header':879,2214 'healthcar':807,1497,1566,1568,1792,1795,1808 'help':237,1741,1750 'hex':1590,1628,2180 'hex-char':1589 'hexdigest':1598,1612 'high':1358 'hire':74,94,132,190,225,1713,1722,1742,1751,1922,1955,1959 'hit':1518 'honor':2210 'host':329 'hous':88,229,1958 'hr':140,247,720,749,1466,1472,1481,1488,1494,1502,1508,1654,1663,1695,1728,1769,1805,1840,1894,2271,2287 'hr-softwar':246 'http':171 'id':455,623,1581,1584,1594,1605,1868,2037,2111,2173,2175 'ideal':2253 'ident':1342,1351,1355,1360,1433 'ignor':1215 'il':1811 'implicit':1265,1332 'import':1601 'in-hous':86,227,1956 'includ':2090,2151,2264 'indirect':1736 'individu':112,258,266,1982 'industri':139,726,747,1465,1471,1480,1487,1493,1501,1507,1653,1662,1694,1727,1768,1804,1839,1893,1908,2270,2286 'info':616,2107 'initi':517 'insid':1059,1411 'inspect':928 'intent':293,1737 'invalid':2171 'ip':585 'ip-throttl':584 'job':103,114,201,221,241,260,1951,1972 'job-post':102 'job-seek':113,259 'jq':1096,1183 'jq-process':1095 'json':2137 'k':2057 'keep':826 'keyword':125,164,779,1362,1430,1525,1532,1789,1904,1993,2009 'keyword-on':2008 'kind':563,741 'korn-ferry.com':1617 'land':1219 'languag':1940 'larg':1705 'later':1010 'leak':1066,1905 'lean':1935 'legal':560,636,790,1452,1576,1578,2097 'lever':252 'limit':1668,1707,1848,2209,2302 'line':1212 'linkedin':777 'list':422,728,1388,1414,1853 'liter':849,1032,1410 'll':743 'llm':353,832,886,1131 'load':309,447,459,470,503 'local':1869 'look':116,1754,2026 'low':1356 'lowercas':2179 'make':1188,2076 'manag':1995 'map':403,1526 'match':495,1397,2065 'matter':136,655 'may':733,2038 'mcp':294,307,322,362,367,399,415,445,457,468,479,500,523 'mcp.servicegraph.co':310 'medium':1357 'messag':2140 'meta':789,1451 'mi':1812 'mid':1298 'mid-sess':1297 'midwest':1800 'mirror':1207 'missing/expired':2188 'mn':1815 'mode':2226 'model':754,825 'month':607,628,666,697,2118,2219,2232,2315 'multi':2012 'multi-word':2011 'multipl':1454 'must':2109,2176 'mvp':649 'n':932,1616 'name':485,562,637,732,786,791,1237,1448,1453,1778,2098 'need':519,1184,1740,1749,1986 'negat':1403,1409 'never':834,852,1034 'new':1120 'non':263,953,1192 'non-us':262 'non-zero':952,1191 'none':552,569,582 'not-found':1886 'notexpr':1328,1330,1334,1336 'number':1352,1361,1435 'numer':761 'nurs':1570 'ny':1395,1420,1427,1478,1686,1700,2248,2277,2293 'oauth':325,370 'oh':1810 'ok':978 'one':1314,1391,1889,2167 'op':760,768,1343,1346 'openssl':1625 'oper':564,1440 'orexpr':1322,1323 'otp':450,462,473,532,1111,1255,1310,2192 'outsourc':1543,1547 'overlap':126,682,687 'page':672 'pagin':2130 'paid':646 'param':1172 'paramet':1316 'paren':1385 'parent':1069 'pars':1377,2148 'partner':1757 'past':1857 'path':387,421 'pattern':394,494 'pattern-match':493 'payload':2150 'per':660,664,668,892,2115,2117 'per-user-per-month':2114 'persist':1282 'phone':633,771,2093 'pin':138,1892 'pkce':327 'plain':378,1177 'polit':1978 'pollut':1202 'pool':595 'posit':129,2152 'post':104,199,644,1146,1223,1949 'predic':1340,1341,1392 'prefer':296,311,365,504 'prefix':490 'presenc':769 'present':526,1883 'price':753 'primari':2094,2096 'print':1630 'pro':2028 'proceed':1273 'process':1097,1542,1546 'procur':67,106,209,275,292,1915,1944,2003 'profil':2261 'prompt':1138,1163 'public':406 'pull':695 'push':1723 'python':1600 'q':1250 'qs':936,941 'qualiti':1817 'queri':675,1171,1315 'quota':412,598,652,2112,2220,2313 'quota-spend':597 'rank':619 'rate':762,775,1511,1830,1846,2208,2257,2279,2295 're':671,689,1008,1307,1745,2124,2129,2157,2183,2190 're-ask':1007 're-der':2182 're-fetch':688 're-pag':670 're-pagin':2128 're-run':1306,2189 're-valid':2156 're-view':2123 'read':835,919 'recip':1635 'recommend':420 'recruit':3,17,26,46,59,84,131,141,205,215,230,234,268,721,750,1458,1467,1473,1482,1489,1495,1503,1509,1541,1545,1559,1564,1567,1573,1577,1655,1664,1696,1729,1770,1806,1841,1895,1899,1913,1921,1924,1929,2272,2288 'recruiting-an-employe':204,1928 'recruiting-flavor':1457 'recruiting/staffing':70,277 'refus':1932,1977,1997 'reject':1422 'releas':739 'remain':2314 'report':2310 'repres':120,217,1964 'request':176,863,985,1104 'requir':369,820,2163,2169 'resolut':909 'respons':715,1088,2067 'rest':382,393,407,417,531,2229 'retain':802,1475,1536,1539,1674,1682,1698,2243,2274,2290 'retained-search':1681 'retri':2212,2215 'retry-aft':2211 'return':1173,1294,1607,2136 'reveal':1246 'review':763 'revok':1305 'ritual':703 'role':192 'round':882 'round-trip':881 'rpo':24,148,281,803,1484,1540,1544,1710,1716,1731,1760,1772 'rstrip':1597,1610 'rule':653,910,1364 'run':922,1308,2191 'saa':1506 'safe':1213 'sale':808,1505,1563,1565,1782 'sandbox':337 'say':991 'scale':1738,1746,1753 'scope':587,1976 'sear':43 'search':23,38,147,166,222,280,440,1319,1431,1470,1476,1535,1537,1638,1644,1649,1658,1667,1683,1825,1844,1902,2022,2025,2245 'search/retained':22 'sector':1821,1834 'secur':824 'see':477 'seeker':115,261 'separ':156 'serv':759 'server':295,308,323,372,501 'servic':278,2029 'servicegraph':50,306,482,499,522,933,937,942,972,983,1049,1081,1174,1251 'session':558,701,893,968,987,1287,1299,2309 'session-start':700 'set':1072,1075 'sha256':1595,1627 'share':124,1988 'shell':344,858,906,924,1021,1028,1043,1070 'shortlist':12,55,620,642 'side':109,224,1962 'signal':757,1704 'simpler':386 'size':592,756,1703 'skill':64,186,285,1999 'skill-find-recruiting-firm' 'skip':651,1002,2051,2204 'slight':735 'smaller':2079 'social':635 'softwar':248 'someon':95,118 'somewher':951 'sourc':1057 'source-nostrband' 'special':153,161,796 'specif':489 'spend':575,599 'split':2017 'stabl':1587 'staf':19,28,31,61,142,150,283,722,751,1468,1474,1483,1490,1492,1496,1504,1510,1550,1555,1656,1665,1697,1730,1764,1771,1793,1796,1807,1842,1896,2273,2289 'staffing/recruiting':1860 'star':1829,2256 'start':702 'stat':464 'state':752,1393,1418,1424,1426,1477,1485,1498,1678,1699,1809,2276,2292 'status':2141 'stay':993 'step':1276 'style':1320 'sub':144,159,799,1523,2005,2015 'sub-typ':143,158,798,1522,2004,2014 'subshel':1061 'substr':165,497,783,1446,1631 'success':1260,1784 'support':1717 'suppress':2059,2071 'surfac':1126 'surg':1714 'switch':2222 'tag':157,423 'tagatevid':1353,1354 'talent':233 'team':99,195,1927,1947 'tech':806,1479,1558,1560,1689,1701,1732,1820,1833,1845,2251,2278,2294 'tech-sector':1819,1832 'tech/sales/healthcare':25 'technic':1561 'tell':2233 'temp':30,151,805,1553,1556 'temporari':1554,1557 'text':169,782,1178,1445 'three':1401,1823,2242 'threshold':1818 'throttl':586 'tier':317,358,376,510,538,542,544,997 'tighter':1370 'titl':788,1450 'tmp':1092 'token':348,823,828,847,866,898,915,934,938,943,948,956,973,1033,1050,1082,1108,1115,1121,1175,1252,1256,1279,1301,2187 'tool':313,368,400,416,480,506,524 'topic-agent-skills' 'topic-ai-agents' 'topic-b2b-data' 'topic-claude-code-marketplace' 'topic-claude-code-plugins' 'topic-claude-code-skills' 'topic-claude-plugins' 'topic-claude-skills' 'topic-mcp-server' 'topic-openapi' 'topic-professional-services' 'topic-vendor-discovery' 'total':765 'tr':1618 'trigger':32,1134 'trip':883 'true':2072 'two':678 'tx':1396,1499 'type':145,160,800,1153,1230,1524,2006,2016 'unauthor':1296,2186 'uniqu':605,626,661 'unless':1011 'url':383,613,632,2092 'us':16,58,264 'use':5,179,184,324,391,547,590,617,744,857,895,980,1384,1423 'user':8,77,91,271,871,890,961,990,1013,1140,1165,1263,1527,1642,1680,1715,1743,1777,1794,1822,1856,2103,2116,2235,2241 'valid':571,1461,2158 'valu':349,565,727,731,850,921,1128,1248,1348,1349,1350,2265 'valueorlist':1344,1347 'vari':491,734 'vertic':152,1679,1791 'vet':13 'via':1020 'view':663,2122,2125 'volum':1762,1942 'vs':251 'want':9,92,188,1953 'whenev':6 'whether':913 'whitespac':1331 'wi':1814 'within':1390 'without':880,918,1125,1245,1897 'word':2013 'work':173,1017 'workday':253 'wrapper':1029 'write':239 'wrong':1198 'x':1145,1222,1405,1408,2312 'x-quota-remaining-month':2311 'year':767 'yes':426,432,438 'z':1621,1624 'zero':954,1193","prices":[{"id":"9693814a-aa61-475d-acf5-22efb0fe7997","listingId":"c7ad555c-e94e-436f-a416-0f5fde511660","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"nostrband","category":"ServiceGraph","install_from":"skills.sh"},"createdAt":"2026-05-06T12:58:11.452Z"}],"sources":[{"listingId":"c7ad555c-e94e-436f-a416-0f5fde511660","source":"github","sourceId":"nostrband/ServiceGraph/find-recruiting-firm","sourceUrl":"https://github.com/nostrband/ServiceGraph/tree/main/skills/find-recruiting-firm","isPrimary":false,"firstSeenAt":"2026-05-06T12:58:11.452Z","lastSeenAt":"2026-05-18T18:56:03.620Z"}],"details":{"listingId":"c7ad555c-e94e-436f-a416-0f5fde511660","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"nostrband","slug":"find-recruiting-firm","github":{"repo":"nostrband/ServiceGraph","stars":160,"topics":["agent-skills","ai-agents","b2b-data","claude-code-marketplace","claude-code-plugins","claude-code-skills","claude-plugins","claude-skills","mcp-server","openapi","professional-services","vendor-discovery"],"license":"mit","html_url":"https://github.com/nostrband/ServiceGraph","pushed_at":"2026-05-07T12:11:52Z","description":"AI Agent skills for a structured catalog of 100k+ US professional-services firms","skill_md_sha":"ed4369b6286e1dd38776a7492c1896a4da7faec1","skill_md_path":"skills/find-recruiting-firm/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/nostrband/ServiceGraph/tree/main/skills/find-recruiting-firm"},"layout":"multi","source":"github","category":"ServiceGraph","frontmatter":{"name":"find-recruiting-firm","license":"MIT","description":"Use whenever the user wants to find, shortlist, vet, or enrich US recruiting and staffing firms — executive search/retained search, RPO, tech/sales/healthcare recruiting, contingent/contract staffing, and temp staffing. Triggers on \"find me an executive search firm for a CFO search\", \"shortlist three retained-search boutiques in NY focused on tech\", \"we need RPO support for a 50-engineer hiring push\", or \"pull contact info for these 8 staffing firm domains\", even when described indirectly (need help hiring at scale, executive recruiter for senior roles). Drives the ServiceGraph API (api.servicegraph.co) — a 100k+ US firm catalog filterable by industry, services, location, size, ratings. Skip when the user wants to hire someone as their own employee (job-board questions, in-house recruiter hires, \"where should I post the role\"), individual job-seekers looking for recruiters to represent them, candidate-side career coaching, non-US firms, individual freelance recruiters."},"skills_sh_url":"https://skills.sh/nostrband/ServiceGraph/find-recruiting-firm"},"updatedAt":"2026-05-18T18:56:03.620Z"}}