{"id":"6875b07a-47e2-4d77-bf9d-b121e4f84ccc","shortId":"bE4pnQ","kind":"skill","title":"find-law-firm","tagline":"Use whenever the user wants to find, shortlist, vet, or enrich US B2B law firms — corporate, IP/patent, M&A and securities, employment, commercial litigation, regulatory/compliance, data privacy/cyber, real estate, and tax. Triggers on \"find three boutique IP law firms in Califor","description":"# find-law-firm\n\nDrive the **ServiceGraph API** (`https://api.servicegraph.co`) to find,\nshortlist, and enrich US **business-to-business** law firms.\n\n**The catalog is B2B-only.** A historical audit dropped over half of\nhigh-rank \"legal\" firms because they served personal/consumer matters\n(divorce, personal injury, criminal defense, family law, estate\nplanning). The remaining catalog skews toward corporate, IP, M&A,\nsecurities, employment, commercial litigation, regulatory, data\nprivacy, real-estate transactions, and corporate tax.\n\n**Always pin `industry:legal`.** Sub-areas of law are NOT separate\ntags — `industry:legal` is the most specific structured level —\nso practice-area specialization (IP, M&A, employment, securities,\netc.) is a keyword 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\nThe single biggest failure mode is firing on **consumer-personal**\nlegal asks. Refuse those — don't fall back to a partial filter.\n\nOut of scope:\n- Personal/family matters where the user is the end client: divorce,\n  child custody, family law, estate planning, wills/trusts, personal\n  injury, criminal defense, individual bankruptcy, immigration for\n  the user themselves, landlord/tenant disputes.\n- DIY legal research: \"is this enforceable?\", \"do I owe...?\", \"what\n  does this clause mean?\".\n- In-house counsel hires (GC, paralegal, contracts manager).\n- Non-US firms — the catalog is US-only.\n- Individual freelancers / contract attorneys for hire.\n\nIf the user is a *business* procuring legal services (corporate\ncounsel, fundraising, IP, regulatory), this skill applies regardless\nof whether the practice area is \"boring\" — defaults to fire on B2B\nprocurement 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 `legal` is present\nin the `industry` value list. Note that `industry:legal` is the most\nspecific structured tag for law firms — practice-area specialization\nis keyword-based.\n\nField kinds you'll use most:\n- **categorical**: `industry` (always `legal`), `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. Bareword in the filter becomes a keyword. **This is how you specialize on practice area** (IP, patent, M&A, employment, securities, etc.).\n\nNote: `service_provided` tags are not populated for `industry:legal`\nin the current catalog (see catalog notes — Clutch and similar\ndirectories don't break legal down further). Use barewords for\npractice areas instead.\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**Legal-flavored examples** (validate yours with `/v1/check`):\n\n```\nindustry:legal state:CA patent\nindustry:legal state:NY,DE m&a\nindustry:legal employment\nindustry:legal securities ipo\nindustry:legal data privacy gdpr\nindustry:legal commercial litigation state:TX\nindustry:legal -company_size_signal:solo rating>=4 review_count_total>=20\nindustry:legal corporate startup\n```\n\nWhen in doubt about whether a filter parses, hit `/v1/check?filter=...`\nfirst — it's free and returns the canonical normalized form.\n\n**Practice area → keyword mapping** (since legal sub-areas are not\nstructured tags):\n\n| User asks for | Add as keyword(s) |\n|---|---|\n| IP / patents / trademarks | `patent`, `trademark`, `ip` |\n| M&A / mergers and acquisitions | `m&a` (or `mergers`) |\n| Securities / IPO / capital markets | `securities`, `ipo` |\n| Employment law (employer-side) | `employment`, `labor` |\n| Commercial litigation / disputes | `litigation`, `commercial` |\n| Regulatory / compliance | `regulatory`, `compliance` |\n| Data privacy / cyber / GDPR / CCPA | `privacy`, `gdpr`, `ccpa`, `cyber` |\n| Real estate (commercial) | `real estate`, `commercial real estate` |\n| Tax (corporate) | `tax` |\n| Corporate / formation / governance | `corporate`, `formation`, `governance` |\n| Antitrust | `antitrust` |\n| Bankruptcy (corporate) | `bankruptcy` |\n| Immigration (corporate sponsorship) | `immigration` |\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`apex` is the registered domain (`dlapiper.com`, not\n`www.dlapiper.com/about`). Anyone with an apex list can compute\nfirm_ids locally and call `/v1/get/:id` directly — no `/search`\nneeded for BYO enrichment.\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 \"dlapiper.com\" | tr 'A-Z' 'a-z' \\\n  | openssl dgst -sha256 -hex | awk '{print substr($2,1,12)}'\n```\n\n## Recipes\n\n### A. IP / patent firm in a state\n\nUser: *\"Three boutique IP law firms in California for hardware-startup\npatent prosecution.\"*\n\n```\nGET /v1/explore?filter=industry:legal+state:CA+patent\n# → pool size + breakdowns\n\nGET /v1/search?filter=industry:legal+state:CA+patent+-company_size_signal:large_50plus&limit=10\n# → 10 brief cards (boutique ⇒ exclude large firms); user picks 3\n\nGET /v1/get/<firm_id>     # ×3\n# → urls, phones, emails for outreach\n```\n\n### B. M&A counsel for a fundraise\n\nUser: *\"M&A counsel for a Series-B fundraise — top firms in NY.\"*\n\n```\nGET /v1/search?filter=industry:legal+state:NY+m&a&limit=10&order_by=relevance\n```\n\n### C. Securities / IPO experience\n\nUser: *\"Securities law firms experienced with IPOs.\"*\n\n```\nGET /v1/search?filter=industry:legal+securities+ipo&limit=10\n```\n\n### D. Indirect intent — \"outside counsel for GDPR/SOC2\"\n\nUser: *\"Our compliance is getting complex — we need outside counsel\nfor GDPR, CCPA, and SOC2 oversight.\"*\n\nThat's a B2B legal procurement ask in regulatory/data-privacy:\n\n```\nGET /v1/search?filter=industry:legal+(gdpr OR ccpa OR privacy)+compliance&limit=10\n```\n\n### E. Employment law for a tech employer\n\nUser: *\"Mid-size firms specializing in employment law for tech\ncompanies.\"*\n\n```\nGET /v1/search?filter=industry:legal+employment+tech+company_size_signal:medium_10_50,small_2_10\n```\n\n### F. Quality threshold + commercial litigation\n\nUser: *\"Three commercial litigation firms in Texas with at least\n4-star ratings.\"*\n\n```\nGET /v1/search?filter=industry:legal+commercial+litigation+state:TX+rating>=4&limit=10\n```\n\n### G. BYO apex list — enrich domains the user already has\n\nUser pastes 8–20 law-firm domains. For each:\n\n1. Compute `firm_id` locally (see contract above).\n2. `GET /v1/get/<firm_id>` — full bundle if in catalog, 404 (not\n   charged) if not.\n3. Aggregate, present, flag the not-found ones to the user. A 404\n   often means the firm is consumer-focused (divorce, PI) and was\n   filtered out of the B2B catalog.\n\n## Gotchas\n\n- **Always pin `industry:legal`.** Without it, \"patent\" or \"m&a\" as keywords would also match marketing/IT firm meta tags.\n- **Refuse consumer-personal legal asks.** Divorce, personal injury, criminal defense, family law, estate planning, wills, individual immigration, personal bankruptcy — these are NOT in the catalog. Tell the user the catalog is B2B-only and suggest they look elsewhere (state bar referral services, Avvo, etc.). Do NOT return a partial result hoping it's close enough.\n- **`industry:legal` is the only structured handle.** Practice areas (IP, M&A, employment, securities, etc.) are keyword-only. Multi-word areas split into ANDed barewords (`commercial litigation` = `commercial` AND `litigation`).\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`. Do not pretend to have it from the brief.\n- **Catalog skews toward mid/large B2B firms.** Solo practitioners and very small (<5 attorney) shops are under-represented after the audit. If the user wants a \"boutique\" firm, exclude `company_size_signal:large_50plus` rather than requiring solo.\n- **DIY/legal-research questions** (\"is this NDA enforceable?\", \"explain fair use\") are NOT procurement. Refuse and offer to find a firm if the user wants advice rather than research.\n- **Software-product comparisons** (Ironclad vs DocuSign, etc.) are NOT procurement either.\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\nAuthed responses carry `X-RateLimit-*` and `X-Quota-*` headers. Surface\nthe remaining-month value to the user when it gets low so they can\nbudget.\n\n## End-to-end example\n\nUser: *\"Three boutique IP law firms in California that handle patent\nprosecution for hardware startups, ideally with at least a 4-star\nrating.\"*\n\n```\n# 1. Discover fields (once per session)\nGET /v1/tags?include_values=1\n# Confirms 'legal' is a valid industry value, 'rating' is numeric.\n\n# 2. Validate the filter and scope the pool (free, no auth)\nGET /v1/check?filter=industry:legal+state:CA+patent+rating>=4+-company_size_signal:large_50plus\n# → {\"valid\": true, \"normalized\": \"...\"}\n\nGET /v1/explore?filter=industry:legal+state:CA+patent+rating>=4+-company_size_signal:large_50plus\n# → {\"count\": 27, \"breakdowns\": {...}}\n\n# 3. Search briefs\nGET /v1/search?filter=...&limit=10\n# Header: Authorization: Bearer $SERVICEGRAPH_TOKEN\n# → 10 brief cards.\n\n# 4. Present briefs to user, get their pick of 3.\n\n# 5. Pull full bundles for the 3 picks\nGET /v1/get/<firm_id>     # ×3\n# → urls, phones, emails for outreach\n```\n\nEnd of session: report `X-Quota-Remaining-Month` so the user knows how\nmuch budget is left.","tags":["find","law","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-law-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-law-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 (18,080 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.114Z","embedding":null,"createdAt":"2026-05-06T12:58:10.993Z","updatedAt":"2026-05-18T18:56:03.114Z","lastSeenAt":"2026-05-18T18:56:03.114Z","tsv":"'/.env.local':1130 '/about':1709 '/check':372,868,1055 '/explore':373,870,1056 '/get':331,670,875,1349,2199,2264 '/search':330,668,873,1347,1726,2195,2241 '/stats':332 '/tags':371,867,1054 '/v1/auth/request-otp''':1205 '/v1/auth/verify-otp?format=env''':1282 '/v1/check':443,579,1520,1576,2400,2565 '/v1/explore':449,592,1789,2210,2464,2583 '/v1/get':466,634,1722,1825,2028,2635 '/v1/research':657 '/v1/search':455,613,1800,1854,1879,1920,1952,1986,2238,2604 '/v1/search?filter=...''':1109,1141 '/v1/stats':478 '/v1/tags':437,563,2539 '/v1/tags?include_values=1':724 '0':1003 '1':413,414,967,1189,1423,1764,2018,2532,2542 '10':1813,1814,1863,1886,1931,1962,1966,1997,2607,2613 '12':1688,1699,1744,1765,2418 '2':1013,1214,1442,1763,1965,2026,2553 '2.1':338 '20':1562,2011,2212,2217,2224 '200':616 '27':2598 '3':1074,1298,1333,1458,1823,1826,2039,2600,2625,2632,2636 '4':1166,1484,1558,1982,1995,2529,2573,2591,2616 '400':2386,2401,2410 '401':1351,2425 '404':2034,2052,2184,2197,2433 '429':2447,2458 '4xx':1251 '5':1344,2286,2626 '50':637,1963 '50plus':1811,2308,2578,2596 '8':2010 'a-z':1750,1753 'acquisit':1618 'across':803,1503 'add':1604 'address':650,2254 'advic':2336 'agent':314,504,1193,1218 'aggreg':2040 'allow':1473 'alreadi':706,959,2006 'also':1265,2085 'alway':122,769,943,2072 'and':2173 'andexpr':1380,1382,1383 'anon':431 'anonym':369,387,872,1052 'antitrust':1671,1672 'anyon':1710 'apex':1700,1713,1737,2000,2245 'apex.lower':1696,1740 'api':53,1040 'api.servicegraph.co':54,723,1108,1140,1204,1281 'api.servicegraph.co/v1/auth/request-otp''':1203 'api.servicegraph.co/v1/auth/verify-otp?format=env''':1280 'api.servicegraph.co/v1/search?filter=...''':1107,1139 'api.servicegraph.co/v1/tags?include_values=1':722 'appear':909 'append':1235 'appli':290 'application/json':1210,1287 'area':128,146,296,755,825,864,1589,1596,2156,2170 'ask':191,944,1065,1070,1602,1916,2096,2258 'atom':1393,1394 'attorney':271,2287 'audit':75,348,2295 'auth':310,328,521,525,549,557,866,918,1021,1059,1072,1079,2476,2563 'author':934,1103,1135,2609 'avail':973,1006 'avvo':2135 'awk':1760 'b':1431,1437,1832,1847 'b2b':17,71,303,1913,2069,2124,2279 'b2b-only':70,2123 'back':197 'backend':422 'bankruptci':227,1673,1675,2110 'bar':2132 'bareword':811,861,1401,1415,1485,1511,2174 'base':760 'bash':987,1094,1188,1745 'bearer':615,636,878,1104,1136,2610 'becom':815,1497 'biggest':181 'bind':1425 'bite':1422 'bodi':1145 'bore':298 'boutiqu':40,1776,1817,2301,2511 'brand':806,1505 'break':856 'breakdown':601,1798,2227,2599 'brief':621,1815,2239,2274,2602,2614,2618 'broaden':2234 'budget':2503,2657 'bug':2188 'bundl':643,2030,2629 'busi':62,64,279 'business-to-busi':61 'byo':1729,1999 'c':1432,1439,1867 'ca':1450,1475,1481,1524,1794,1805,2570,2588 'cach':725 'calendar':677 'califor':45 'california':1781,2516 'call':311,402,567,590,652,681,720,1022,1060,1080,1721 'candid':606 'canon':1585 'capit':1625 'captur':1142,1174,1300,1313,1317 'card':623,1816,2615 'carri':2478 'catalog':68,101,263,475,846,848,2033,2070,2116,2121,2275,2439 'categor':767 'ccpa':1649,1652,1906,1926 'char':1691,2421 'charg':671,695,2036,2209,2443 'check':440,981 'child':215 'claud':1295 'claude-c':1294 'claus':247 'cli':1296 'client':164,213 'close':2146 'clutch':792,850 'code':986,1002,1217,1223,1255,1291,1292,2379,2382 'comma':1443,1469 'command':1161 'comment':1267 'commerci':27,110,1547,1636,1640,1656,1659,1970,1974,1990,2175,2177 'compani':774,797,1553,1807,1950,1958,2304,2574,2592 'comparison':2343 'complet':523,1325 'complex':1899 'complianc':1642,1644,1896,1929 'comput':1716,2019 'confirm':731,1014,1299,2543 'consent':1322 'construct':717 'consum':188,2059,2093 'consumer-focus':2058 'consumer-person':187,2092 'contact':627,2260 'content':1208,1285 'content-typ':1207,1284 'context':366,889,901 'continu':2207,2446 'contract':256,270,1682,2024 'convers':730,912,1093 'corpor':20,104,120,283,1565,1663,1665,1668,1674,1677 'cost':558 'counsel':252,284,1835,1842,1891,1903 'count':600,783,1560,2223,2232,2597 'credenti':344,897 'crimin':93,224,2100 'curl':166,172,391,439,445,451,461,473,484,1101,1133,1199,1245,1276 'current':845 'custodi':216 'cyber':1647,1653 'd':1211,1288,1887 'data':30,113,426,1542,1645 'de':1530 'dedup':2359 'def':1734 'default':299 'defens':94,225,2101 'defer':662 'deriv':2424 'detect':486,953,968,1173 'dgst':1757 'differ':691 'direct':924,1178,1724 'directori':853 'discov':571,2533 'discoveri':401 'dispatch':357,915,1075,1331 'disput':234,1638 'divorc':90,214,2061,2097 'diy':235 'diy/legal-research':2313 'dlapiper.com':1705,1748 'docusign':2346 'doesn':1120,1256 'domain':1704,2003,2015 'dotenv':930 'doubt':1569 'drill':2228 'drive':50 'drop':76 'dsl':1369 'e':1932 'echo':1158,1310,1746 'either':1127,2351 'els':460,472,483 'elsewher':2130 'email':646,1192,1198,1212,1213,1289,1290,1829,2249,2639 'employ':26,109,151,830,1535,1629,1632,1634,1933,1938,1946,1956,2160 'employer-sid':1631 'empti':2404 'encod':1742 'end':212,2505,2507,2642 'end-to-end':2504 'endpoint':420,430 'enforc':240,2318 'enough':2147 'enrich':15,59,1730,2002 'enter':363,1091 'env':892,1000,1226 'env.local':354,893,964,995,1033,1112,1180,1237,1297,1309,1340 'environ':929,1032,1100 'error':1262,2373,2375,2378,2389 'escal':2236 'estat':33,97,117,219,1655,1658,1661,2104 'etc':153,832,2136,2162,2347 'even':955,1272 'ever':362 'everi':378,569,917,1078 'exampl':169,1516,2508 'exchang':1215 'exclud':1818,2303 'exhaust':2461 'exist':2193 'exit':985,1001,1246 'expand':1165 'experi':1870 'experienc':1875 'expir':1358 'explain':2319 'explor':446 'explore/search':589 'export':1096 'f':1242,1967 'failur':182 'fair':2320 'fall':196,539 'famili':95,217,2102 'fetch':167,702 'fewer':2215 'field':573,761,2457,2534 'file':898,931,1149,1260 'filter':201,441,580,585,593,614,692,719,814,1368,1377,1395,1573,1577,1790,1801,1855,1880,1921,1953,1987,2065,2387,2395,2402,2405,2556,2566,2584,2605 'find':2,11,38,47,56,2329 'find-law-firm':1,46 'fire':185,301 'firm':4,19,43,49,66,84,160,261,447,453,464,618,622,639,655,674,704,752,804,1680,1683,1693,1717,1735,1770,1779,1820,1850,1874,1943,1976,2014,2020,2056,2088,2190,2218,2280,2302,2331,2412,2414,2436,2514 'first':566,1020,1578,2361 'fix':2393 'flag':1243,2042,2204,2441 'flavor':1515 'flow':526,545,923,1168,1327,1367 'focus':2060 'follow':1493 'form':1587 'format':1225,1666,1669 'found':785,1026,2046,2435 'four':553,1419 'four-tier':552 'free':565,582,595,620,641,689,711,800,1500,1581,2367,2372,2561 'free-text':799,1499 'freelanc':269 'fss':1200,1277 'full':642,2029,2628 'fundrais':285,1838,1848 'funnel':555 'futur':1342 'g':1998 'gc':254 'gdpr':1544,1648,1651,1905,1924 'gdpr/soc2':1893 'geographi':777 'get':436,442,448,454,463,465,477,562,578,591,612,633,721,1788,1799,1824,1853,1878,1898,1919,1951,1985,2027,2498,2538,2564,2582,2603,2621,2634 'github':1374 'github-search-styl':1373 'goe':1081 'gotcha':2071 'govern':1667,1670 'grep':991,996,1305 'h':1102,1134,1206,1283 'half':78 'handl':343,1692,2154,2518 'har':315,342,500,528 'hardwar':1784,2522 'hardware-startup':1783 'harness-specif':499 'hashlib':1733 'hashlib.sha256':1739 'header':935,2454,2486,2608 'hex':1690,1759,2420 'hex-char':1689 'hexdigest':1698,1743 'high':81,1414 'high-rank':80 'hire':253,273 'histor':74 'hit':1575 'honor':2450 'hope':2143 'host':341 'hous':251 'http':163 'id':467,635,1681,1684,1694,1718,1723,1736,2021,2191,2265,2413,2415 'ideal':2524 'ident':1398,1407,1411,1416,1489 'ignor':1271 'immigr':228,1676,1679,2108 'implicit':1321,1388 'import':1732 'in-hous':249 'includ':2244,2391,2540 'indirect':1888 'individu':226,268,2107 'industri':124,135,737,742,768,841,1521,1526,1533,1536,1540,1545,1551,1563,1791,1802,1856,1881,1922,1954,1988,2074,2148,2548,2567,2585 'info':628,2261 'initi':529 'injuri':92,223,2099 'insid':1115,1467 'inspect':984 'instead':865 'intent':305,1889 'invalid':2411 'ip':41,105,148,286,597,826,1608,1613,1768,1777,2157,2512 'ip-throttl':596 'ip/patent':21 'ipo':1539,1624,1628,1869,1877,1884 'ironclad':2344 'jq':1152,1239 'jq-process':1151 'json':2377 'k':2211 'keep':882 'keyword':156,759,798,817,1418,1486,1590,1606,2083,2165 'keyword-bas':758 'keyword-on':2164 'kind':575,762 'know':2654 'labor':1635 'land':1275 'landlord/tenant':233 'larg':1810,1819,2307,2577,2595 'later':1066 'law':3,18,42,48,65,96,130,218,751,1630,1778,1873,1934,1947,2013,2103,2513 'law-firm':2012 'leak':1122 'least':1981,2527 'left':2659 'legal':83,125,136,190,236,281,572,648,732,743,770,809,842,857,1508,1514,1522,1527,1534,1537,1541,1546,1552,1564,1593,1792,1803,1857,1882,1914,1923,1955,1989,2075,2095,2149,2251,2544,2568,2586 'legal-flavor':1513 'level':142 'limit':1812,1862,1885,1930,1996,2449,2606 'line':1268 'linkedin':796 'list':434,739,1444,1470,1714,2001 'liter':905,1088,1466 'litig':28,111,1548,1637,1639,1971,1975,1991,2176,2179 'll':764 'llm':365,888,942,1187 'load':321,459,471,482,515 'local':1719,2022 'look':2129,2180 'low':1412,2499 'lowercas':2419 'm':22,106,149,828,1531,1614,1619,1833,1840,1860,2080,2158 'make':1244,2230 'manag':257 'map':415,1591 'market':1626 'marketing/it':2087 'match':507,1453,2086,2219 'matter':89,206,667 'may':2192 'mcp':306,319,334,374,379,411,427,457,469,480,491,512,535 'mcp.servicegraph.co':322 'mean':248,2054 'medium':1413,1961 'merger':1616,1622 'messag':2380 'meta':808,1507,2089 'mid':1354,1941 'mid-sess':1353 'mid-siz':1940 'mid/large':2278 'mirror':1263 'missing/expired':2428 'mode':183,2466 'model':773,881 'month':619,640,678,709,2358,2459,2472,2491,2650 'much':2656 'multi':2168 'multi-word':2167 'multipl':1510 'must':2263,2416 'mvp':661 'n':988,1747 'name':497,574,649,805,810,1293,1504,1509,2252 'nda':2317 'need':531,1240,1727,1901 'negat':1459,1465 'never':890,908,1090 'new':1176 'non':259,1009,1248 'non-us':258 'non-zero':1008,1247 'none':564,581,594 'normal':1586,2581 'not-found':2044 'note':740,833,849 'notexpr':1384,1386,1390,1392 'number':1408,1417,1491 'numer':780,2552 'ny':1451,1476,1483,1529,1852,1859 'oauth':337,382 'offer':2327 'often':2053 'ok':1034 'one':1370,1447,2047,2407 'op':779,787,1399,1402 'openssl':1756 'oper':576,1496 'order':1864 'orexpr':1378,1379 'otp':462,474,485,544,1167,1311,1366,2432 'outreach':1831,2641 'outsid':1890,1902 'overlap':694,699 'oversight':1909 'owe':243 'page':684 'pagin':2370 'paid':658 'paraleg':255 'param':1228 'paramet':1372 'paren':1441 'parent':1125 'pars':1433,1574,2388 'partial':200,2141 'past':2009 'patent':827,1525,1609,1611,1769,1786,1795,1806,2078,2519,2571,2589 'path':399,433 'pattern':406,506 'pattern-match':505 'payload':2390 'per':672,676,680,948,2355,2357,2536 'per-user-per-month':2354 'persist':1338 'person':91,189,222,2094,2098,2109 'personal/consumer':88 'personal/family':205 'phone':645,790,1828,2247,2638 'pi':2062 'pick':1822,2623,2633 'pin':123,2073 'pkce':339 'plain':390,1233 'plan':98,220,2105 'pollut':1258 'pool':607,1796,2560 'popul':839 'posit':2392 'post':656,1202,1279 'practic':145,295,754,824,863,1588,2155 'practice-area':144,753 'practition':2282 'predic':1396,1397,1448 'prefer':308,323,377,516 'prefix':502 'presenc':788 'present':538,734,2041,2617 'pretend':2268 'price':772 'primari':2248,2250 'print':1761 'privaci':114,1543,1646,1650,1928 'privacy/cyber':31 'pro':2182 'proceed':1329 'process':1153 'procur':280,304,1915,2324,2350 'product':2342 'prompt':1194,1219 'prosecut':1787,2520 'provid':835 'public':418 'pull':707,2627 'python':1731 'q':1306 'qs':992,997 'qualiti':1968 'queri':687,1227,1371 'question':2314 'quota':424,610,664,2352,2460,2485,2648 'quota-spend':609 'rank':82,631 'rate':781,794,1557,1984,1994,2448,2531,2550,2572,2590 'ratelimit':2481 'rather':2309,2337 're':683,701,1064,1363,2364,2369,2397,2423,2430 're-ask':1063 're-der':2422 're-fetch':700 're-pag':682 're-pagin':2368 're-run':1362,2429 're-valid':2396 're-view':2363 'read':891,975 'real':32,116,1654,1657,1660 'real-est':115 'recip':1766 'recommend':432 'referr':2133 'refus':192,2091,2325 'regardless':291 'regist':1703 'regulatori':112,287,1641,1643 'regulatory/compliance':29 'regulatory/data-privacy':1918 'reject':1478 'relev':1866 'remain':100,2490,2649 'remaining-month':2489 'report':2645 'repres':2292 'request':168,919,1041,1160 'requir':381,876,2311,2403,2409 'research':237,2339 'resolut':965 'respons':727,1144,2221,2477 'rest':394,405,419,429,543,2469 'result':2142 'retri':2452,2455 'retry-aft':2451 'return':1229,1350,1583,1738,2139,2376 'reveal':1302 'review':782,1559 'revok':1361 'ritual':715 'round':938 'round-trip':937 'rstrip':1697,1741 'rule':665,966,1420 'run':978,1364,2431 'safe':1269 'sandbox':349 'say':1047 'scope':204,599,2558 'search':158,452,1375,1487,2601 'secur':25,108,152,831,880,1538,1623,1627,1868,1872,1883,2161 'see':489,847,2023 'separ':133 'seri':1846 'series-b':1845 'serv':87,778 'server':307,320,335,384,513 'servic':282,834,2134,2183 'servicegraph':52,318,494,511,534,989,993,998,1028,1039,1105,1137,1230,1307,2611 'session':570,713,949,1024,1043,1343,1355,2537,2644 'session-start':712 'set':1128,1131 'sha256':1695,1758 'shell':356,914,962,980,1077,1084,1099,1126 'shop':2288 'shortlist':12,57,632,654 'side':1633 'signal':776,1555,1809,1960,2306,2576,2594 'similar':852 'simpler':398 'sinc':1592 'singl':180 'size':604,775,1554,1797,1808,1942,1959,2305,2575,2593 'skew':102,2276 'skill':178,289 'skill-find-law-firm' 'skip':663,1058,2205,2444 'small':1964,2285 'smaller':2233 'soc2':1908 'social':647 'softwar':2341 'software-product':2340 'solo':1556,2281,2312 'somewher':1007 'sourc':1113 'source-nostrband' 'special':147,756,822,1944 'specif':140,501,747 'spend':587,611 'split':2171 'sponsorship':1678 'stabl':1687 'star':1983,2530 'start':714 'startup':1566,1785,2523 'stat':476 'state':771,1449,1474,1480,1482,1523,1528,1549,1773,1793,1804,1858,1992,2131,2569,2587 'status':2381 'stay':1049 'step':1332 'structur':141,748,1599,2153 'style':1376 'sub':127,1595 'sub-area':126,1594 'subshel':1117 'substr':157,509,802,1502,1762 'success':1316 'suggest':2127 'suppress':2213,2225 'surfac':1182,2487 'switch':2462 'tag':134,435,749,836,1600,2090 'tagatevid':1409,1410 'tax':35,121,1662,1664 'tech':1937,1949,1957 'tell':2117,2473 'texa':1978 'text':161,801,1234,1501 'three':39,1457,1775,1973,2510 'threshold':1969 'throttl':598 'tier':329,370,388,522,550,554,556,1053 'tighter':1426 'titl':807,1506 'tmp':1148 'token':360,879,884,903,922,954,971,990,994,999,1004,1012,1029,1089,1106,1138,1164,1171,1177,1231,1308,1312,1335,1357,2427,2612 'tool':325,380,412,428,492,518,536 'top':1849 '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':784,1561 'toward':103,2277 'tr':1749 'trademark':1610,1612 'transact':118 'trigger':36,1190 'trip':939 'true':2226,2580 'two':690 'tx':1452,1550,1993 'type':1209,1286 'unauthor':1352,2426 'under-repres':2290 'uniqu':617,638,673 'unless':1067 'url':395,625,644,1827,2246,2637 'us':16,60,260,266 'us-on':265 'use':5,171,176,336,403,559,602,629,765,860,913,951,1036,1440,1479,2321 'user':8,209,231,276,927,946,1017,1046,1069,1196,1221,1319,1601,1774,1821,1839,1871,1894,1939,1972,2005,2008,2050,2119,2257,2298,2334,2356,2475,2495,2509,2620,2653 'valid':583,1517,2398,2547,2554,2579 'valu':361,577,738,906,977,1184,1304,1404,1405,1406,2492,2541,2549 'valueorlist':1400,1403 'vari':503 'vet':13 'via':1076 'view':675,2362,2365 'vs':2345 'want':9,2299,2335 'whenev':6 'whether':293,969,1571 'whitespac':1387 'will':2106 'wills/trusts':221 'within':1446 'without':936,974,1181,1301,2076 'word':2169 'work':165,1073 'would':2084 'wrapper':1085 'wrong':1254 'www.dlapiper.com':1708 'www.dlapiper.com/about':1707 'x':1201,1278,1461,1464,2480,2484,2647 'x-quota':2483 'x-quota-remaining-month':2646 'x-ratelimit':2479 'year':786 'yes':438,444,450 'z':1752,1755 'zero':1010,1249","prices":[{"id":"33124cc2-fe1b-4409-bde2-072eb0b3e52e","listingId":"6875b07a-47e2-4d77-bf9d-b121e4f84ccc","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:10.993Z"}],"sources":[{"listingId":"6875b07a-47e2-4d77-bf9d-b121e4f84ccc","source":"github","sourceId":"nostrband/ServiceGraph/find-law-firm","sourceUrl":"https://github.com/nostrband/ServiceGraph/tree/main/skills/find-law-firm","isPrimary":false,"firstSeenAt":"2026-05-06T12:58:10.993Z","lastSeenAt":"2026-05-18T18:56:03.114Z"}],"details":{"listingId":"6875b07a-47e2-4d77-bf9d-b121e4f84ccc","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"nostrband","slug":"find-law-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":"84c093ebaa93fddca6f84565258f62b8f203c0fb","skill_md_path":"skills/find-law-firm/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/nostrband/ServiceGraph/tree/main/skills/find-law-firm"},"layout":"multi","source":"github","category":"ServiceGraph","frontmatter":{"name":"find-law-firm","license":"MIT","description":"Use whenever the user wants to find, shortlist, vet, or enrich US B2B law firms — corporate, IP/patent, M&A and securities, employment, commercial litigation, regulatory/compliance, data privacy/cyber, real estate, and tax. Triggers on \"find three boutique IP law firms in California\", \"shortlist M&A counsel for a Series-B fundraise\", \"patent prosecution for our hardware startup\", or \"pull contact info for these 10 law firm domains\", even when described indirectly (outside counsel, cap-table review, GDPR/SOC2 oversight). Drives the ServiceGraph API (api.servicegraph.co) — a 100k+ US firm catalog filterable by industry, services, location, size, ratings. Skip personal/consumer legal services where the user is the end client (divorce, personal injury, criminal defense, family law, estate planning, wills) — the catalog is B2B-only. Also skip in-house GC hires, \"is this NDA enforceable\" DIY questions, non-US firms, individual freelancers."},"skills_sh_url":"https://skills.sh/nostrband/ServiceGraph/find-law-firm"},"updatedAt":"2026-05-18T18:56:03.114Z"}}