{"id":"3cbfed36-be7e-4b12-82a0-072d9db5d6fb","shortId":"sqJaSP","kind":"skill","title":"auto-dev","tagline":"Use when working with Auto.dev APIs, vehicle data, VIN decoding, car listings, vehicle photos, specs, recalls, payments, interest rates, taxes, OEM build data, plate-to-VIN, CLI commands, MCP tools, or SDK methods for any automotive data task","description":"# Auto.dev\n\nAutomotive data for AI agents — via MCP tools, CLI commands, SDK methods, or direct API calls.\n\n## Detect Your Surface\n\nCheck in this order. Use the first one available:\n\n**1. MCP** — Check if `auto_decode` is in your available tools.\nIf yes: use `auto_*` tools for everything. Do NOT make raw HTTP calls.\nTo install: `npx @auto.dev/sdk mcp install` (installs globally and configures Claude Code, Claude Desktop, Cursor, Windsurf, VS Code Copilot, Cline, Zed).\n\n**2. CLI** — Run `auto --version`.\nIf installed: authenticate once with `auto login` (OAuth — no API key needed), then use `auto` commands.\nTo install: `npm install -g @auto.dev/sdk` or use `npx @auto.dev/sdk <command>` without installing.\n\n**3. SDK** — Check if `@auto.dev/sdk` is in project dependencies.\nIf yes: use typed SDK methods. See code-patterns.md for all methods.\nTo install: `npm install @auto.dev/sdk`\n\n**4. Direct API** — Check for `AUTODEV_API_KEY` env var.\nIf not set: ask the user for it or direct them to https://auto.dev/pricing (free Starter plan).\n\n## MCP Tools\n\nIf MCP tools are available, this is your only section. Use `auto_docs` to look up\nparameters and response shapes before calling an unfamiliar endpoint.\n\n```\nauto_docs listings      # see all listing filters\nauto_docs payments      # see payment params\nauto_docs vin-decode    # see VIN decode response shape\n```\n\n| Tool | Description | Plan |\n|------|-------------|------|\n| `auto_decode` | Decode a VIN | Starter |\n| `auto_listings` | Search listings with filters | Starter |\n| `auto_photos` | Get vehicle photos | Starter |\n| `auto_specs` | Vehicle specifications | Growth |\n| `auto_build` | OEM build data ($0.10/call) | Growth |\n| `auto_recalls` | Safety recalls | Growth |\n| `auto_payments` | Payment calculations | Growth |\n| `auto_apr` | Interest rates | Growth |\n| `auto_tco` | Total cost of ownership | Growth |\n| `auto_open_recalls` | Open/unresolved recalls | Scale |\n| `auto_plate` | Plate to VIN ($0.55/call) | Scale |\n| `auto_taxes` | Taxes and fees | Scale |\n| `auto_docs` | Search bundled API documentation | — |\n| `auto_config_set` | Set a config value (e.g. `raw: true`) | — |\n| `auto_config_get` | Get a config value or list all settings | — |\n\nAPI metadata is stripped from MCP tool responses by default. Use `auto_config_set` with `key: \"raw\"` and `value: \"true\"` to get full responses.\n\n**If MCP tools are available, skip to Important Rules below.**\n\n## CLI Quick Reference\n\nInstall: `npm install -g @auto.dev/sdk` (or use `npx @auto.dev/sdk` without installing)\nAuthenticate once: `auto login`\n\n```\nauto decode <vin>\nauto photos <vin>\nauto listings --make Toyota --year 2024 --price 10000-40000 --state CA\nauto specs <vin>\nauto build <vin>\nauto recalls <vin>\nauto open-recalls <vin>\nauto payments <vin> --price 35000 --zip 90210 --down-payment 5000\nauto apr <vin> --year 2024 --make Honda --model Accord --zip 90210 --credit-score 750\nauto tco <vin> --zip 90210\nauto taxes <vin> --price 35000 --zip 90210\nauto plate <state> <plate>\nauto usage\nauto docs [query]        # search bundled docs\nauto explore [endpoint]  # browse params and mappings\n```\n\nAll commands support `--json`, `--yaml`, `--raw`, and `--api-key <key>` flags.\n\nAPI metadata is stripped by default — you get clean vehicle data. Use `--raw` to see the full API response.\n\n```\nauto config set raw true    # always show full responses\nauto config get raw         # check current value\nauto config list            # show all settings\n```\nFull CLI reference: https://docs.auto.dev/v2/cli-mcp-sdk\n\n**If CLI is available, skip to Important Rules below.**\n\n## Direct API Quick Reference\n\nUse these only when MCP and CLI are unavailable.\n\n**V2** (base: `https://api.auto.dev`): `Authorization: Bearer {key}` or `?apiKey={key}`\n**V1** (base: `https://auto.dev/api`): `?apikey={key}` (query string only)\n\n| Endpoint | Plan | Required Params |\n|----------|------|-----------------|\n| `GET /listings?filters` | Starter | See v2-listings-api.md |\n| `GET /listings/{vin}` | Starter | — |\n| `GET /vin/{vin}` | Starter | — |\n| `GET /photos/{vin}` | Starter | — |\n| `GET /specs/{vin}` | Growth | — |\n| `GET /build/{vin}` | Growth | — ($0.10/call) |\n| `GET /recalls/{vin}` | Growth | — |\n| `GET /tco/{vin}` | Growth | — |\n| `GET /payments/{vin}` | Growth | `price`, `zip` |\n| `GET /apr/{vin}` | Growth | `year`, `make`, `model`, `zip`, `creditScore` |\n| `GET /openrecalls/{vin}` | Scale | — |\n| `GET /plate/{state}/{plate}` | Scale | — ($0.55/call) |\n| `GET /taxes/{vin}` | Scale | — |\n\nV1 supplemental (no V2 equivalent): `/api/models`, `/api/cities`, `/api/zip/{zip}`, `/api/autosuggest/{term}`\n\nBefore making any Direct API call, read the relevant reference file for full parameter names and examples.\nFull parameter reference: v2-listings-api.md | v2-vin-apis.md | v2-plate-api.md | v1-apis.md\n\n### Common Gotchas (All Surfaces)\n\nThese parameter names do NOT exist on the Direct API — agents hallucinate them frequently:\n\n```\nmake=    ← use vehicle.make\nmodel=   ← use vehicle.model\nstate=   ← use retailListing.state\nprice=   ← use retailListing.price (on /listings), or price= (on /payments, /taxes)\nrows=    ← use limit\nsort=    ← no sort parameter exists\n_order=  ← no sort parameter exists\n```\n\nMCP and CLI handle these mappings automatically. This only matters for Direct API calls.\n\n## Plans & Pricing\n\nSee pricing.md for full per-call costs and upgrade links.\n\n| Plan | Monthly | Includes |\n|------|---------|----------|\n| Starter | Free + data fees | VIN Decode, Listings, Photos (1,000 free calls/mo) |\n| Growth | $299/mo + data fees | + Specs, Recalls, TCO, Payments, APR, Build |\n| Scale | $599/mo + data fees | + Open Recalls, Plate-to-VIN, Taxes & Fees |\n\nAll plans charge per-call data fees on every request. Growth/Scale have no cap on volume but data fees still apply.\n\n## Important Rules\n\n- **Before batch operations**, call the endpoint once with a single item to see the actual response shape. Do not guess field names or nesting — inspect the real response first.\n- **Include ALL fields** from the API response unless the user explicitly says to exclude some.\n- **Small results** (<10 items, single VIN): Display inline as formatted table\n- **Large results** (10+ listings): Ask user preference, default to CSV export\n- **Always support**: CSV, JSON export when user requests\n- **Chain APIs** when the query spans multiple endpoints — MCP tools and CLI commands can be called in parallel\n\n## Deep Reference\n\n**MCP or CLI:** use `auto_docs [query]` or `auto docs [query]` for live parameter lookup.\nFull reference: https://docs.auto.dev/v2/cli-mcp-sdk\n\n**SDK:** see code-patterns.md for typed methods and response format.\n\n**Direct API:**\n- API Docs: v2-listings-api.md | v2-vin-apis.md | v2-plate-api.md | v1-apis.md\n- Workflows: chaining-patterns.md | interactive-explorer.md | business-workflows.md\n- Code Gen: code-patterns.md | app-scaffolding.md | integration-recipes.md\n- Other: error-recovery.md | pricing.md | examples.md","tags":["auto","dev","skill","drivly","agent-skills","auto-dev","automotive-apis","automotive-data","car-api","claude-code","codex-skills","vehicle-listings"],"capabilities":["skill","source-drivly","skill-auto-dev-skill","topic-agent-skills","topic-auto-dev","topic-automotive-apis","topic-automotive-data","topic-car-api","topic-claude-code","topic-codex-skills","topic-vehicle-listings","topic-vin-decoder"],"categories":["auto-dev-skill"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/drivly/auto-dev-skill","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add drivly/auto-dev-skill","source_repo":"https://github.com/drivly/auto-dev-skill","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 12 github stars · SKILL.md body (6,984 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-04-19T00:41:26.726Z","embedding":null,"createdAt":"2026-04-19T00:41:26.726Z","updatedAt":"2026-04-19T00:41:26.726Z","lastSeenAt":"2026-04-19T00:41:26.726Z","tsv":"'-40000':435 '/api':592 '/api/autosuggest':677 '/api/cities':674 '/api/models':673 '/api/zip':675 '/apr':645 '/build':625 '/call':296,332,629,663 '/listings':603,609,734 '/openrecalls':654 '/payments':639,738 '/photos':617 '/plate':658 '/pricing':209 '/recalls':631 '/sdk':101,147,153,162,184,410,416 '/specs':621 '/taxes':665,739 '/tco':635 '/v2/cli-mcp-sdk':556,954 '/vin':613 '0.10':295,628 '0.55':331,662 '000':792 '1':72,791 '10':887,898 '10000':434 '2':119 '2024':432,461 '299/mo':796 '3':156 '35000':451,479 '4':185 '5000':457 '599/mo':806 '750':471 '90210':453,467,475,481 'accord':465 'actual':855 'agent':48,717 'ai':47 'alway':534,907 'api':9,58,133,187,191,344,367,507,510,527,567,683,716,765,875,916,965,966 'api-key':506 'api.auto.dev':581 'apikey':586,593 'app-scaffolding.md':979 'appli':838 'apr':309,459,803 'ask':198,900 'authent':126,419 'author':582 'auto':2,76,86,122,129,138,226,240,247,253,266,272,279,285,290,298,303,308,313,320,326,334,340,346,356,378,421,423,425,427,438,440,442,444,448,458,472,476,482,484,486,492,529,538,545,939,943 'auto-dev':1 'auto.dev':8,43,100,146,152,161,183,208,409,415,591 'auto.dev/api':590 'auto.dev/pricing':207 'auto.dev/sdk':99,145,151,160,182,408,414 'autodev':190 'automat':759 'automot':40,44 'avail':71,81,219,395,560 'base':580,589 'batch':842 'bearer':583 'brows':495 'build':25,291,293,441,804 'bundl':343,490 'business-workflows.md':975 'ca':437 'calcul':306 'call':59,95,236,684,766,775,822,844,930 'calls/mo':794 'cap':831 'car':14 'chain':915 'chaining-patterns.md':973 'charg':819 'check':63,74,158,188,542 'claud':108,110 'clean':518 'cli':31,52,120,401,552,558,576,755,926,937 'cline':117 'code':109,115,976 'code-patterns.md':174,957,978 'command':32,53,139,500,927 'common':703 'config':347,351,357,361,379,530,539,546 'configur':107 'copilot':116 'cost':316,776 'credit':469 'credit-scor':468 'creditscor':652 'csv':905,909 'current':543 'cursor':112 'data':11,26,41,45,294,520,785,797,807,823,835 'decod':13,77,257,260,267,268,424,788 'deep':933 'default':376,515,903 'depend':166 'descript':264 'desktop':111 'detect':60 'dev':3 'direct':57,186,204,566,682,715,764,964 'display':891 'doc':227,241,248,254,341,487,491,940,944,967 'docs.auto.dev':555,953 'docs.auto.dev/v2/cli-mcp-sdk':554,952 'document':345 'down-pay':454 'e.g':353 'endpoint':239,494,598,846,922 'env':193 'equival':672 'error-recovery.md':982 'everi':826 'everyth':89 'exampl':695 'examples.md':984 'exclud':883 'exist':712,747,752 'explicit':880 'explor':493 'export':906,911 'fee':338,786,798,808,816,824,836 'field':861,872 'file':689 'filter':246,277,604 'first':69,869 'flag':509 'format':894,963 'free':210,784,793 'frequent':720 'full':389,526,536,551,691,696,772,950 'g':144,407 'gen':977 'get':281,358,359,388,517,540,602,608,612,616,620,624,630,634,638,644,653,657,664 'global':105 'gotcha':704 'growth':289,297,302,307,312,319,623,627,633,637,641,647,795 'growth/scale':828 'guess':860 'hallucin':718 'handl':756 'honda':463 'http':94 'import':398,563,839 'includ':782,870 'inlin':892 'inspect':865 'instal':97,103,104,125,141,143,155,179,181,404,406,418 'integration-recipes.md':980 'interactive-explorer.md':974 'interest':21,310 'item':851,888 'json':502,910 'key':134,192,382,508,584,587,594 'larg':896 'limit':742 'link':779 'list':15,242,245,273,275,364,428,547,789,899 'live':947 'login':130,422 'look':229 'lookup':949 'make':92,429,462,649,680,721 'map':498,758 'matter':762 'mcp':33,50,73,102,213,216,372,392,574,753,923,935 'metadata':368,511 'method':37,55,172,177,960 'model':464,650,724 'month':781 'multipl':921 'name':693,709,862 'need':135 'nest':864 'npm':142,180,405 'npx':98,150,413 'oauth':131 'oem':24,292 'one':70 'open':321,446,809 'open-recal':445 'open/unresolved':323 'oper':843 'order':66,748 'ownership':318 'parallel':932 'param':252,496,601 'paramet':231,692,697,708,746,751,948 'payment':20,249,251,304,305,449,456,802 'per':774,821 'per-cal':773,820 'photo':17,280,283,426,790 'plan':212,265,599,767,780,818 'plate':28,327,328,483,660,812 'plate-to-vin':27,811 'prefer':902 'price':433,450,478,642,730,736,768 'pricing.md':770,983 'project':165 'queri':488,595,919,941,945 'quick':402,568 'rate':22,311 'raw':93,354,383,504,522,532,541 'read':685 'real':867 'recal':19,299,301,322,324,443,447,800,810 'refer':403,553,569,688,698,934,951 'relev':687 'request':827,914 'requir':600 'respons':233,261,374,390,528,537,856,868,876,962 'result':886,897 'retaillisting.price':732 'retaillisting.state':729 'row':740 'rule':399,564,840 'run':121 'safeti':300 'say':881 'scale':325,333,339,656,661,667,805 'score':470 'sdk':36,54,157,171,955 'search':274,342,489 'section':224 'see':173,243,250,258,524,606,769,853,956 'set':197,348,349,366,380,531,550 'shape':234,262,857 'show':535,548 'singl':850,889 'skill' 'skill-auto-dev-skill' 'skip':396,561 'small':885 'sort':743,745,750 'source-drivly' 'span':920 'spec':18,286,439,799 'specif':288 'starter':211,271,278,284,605,611,615,619,783 'state':436,659,727 'still':837 'string':596 'strip':370,513 'supplement':669 'support':501,908 'surfac':62,706 'tabl':895 'task':42 'tax':23,335,336,477,815 'tco':314,473,801 'term':678 'tool':34,51,82,87,214,217,263,373,393,924 'topic-agent-skills' 'topic-auto-dev' 'topic-automotive-apis' 'topic-automotive-data' 'topic-car-api' 'topic-claude-code' 'topic-codex-skills' 'topic-vehicle-listings' 'topic-vin-decoder' 'total':315 'toyota':430 'true':355,386,533 'type':170,959 'unavail':578 'unfamiliar':238 'unless':877 'upgrad':778 'usag':485 'use':4,67,85,137,149,169,225,377,412,521,570,722,725,728,731,741,938 'user':200,879,901,913 'v1':588,668 'v1-apis.md':702,971 'v2':579,671 'v2-listings-api.md':607,699,968 'v2-plate-api.md':701,970 'v2-vin-apis.md':700,969 'valu':352,362,385,544 'var':194 'vehicl':10,16,282,287,519 'vehicle.make':723 'vehicle.model':726 'version':123 'via':49 'vin':12,30,256,259,270,330,610,614,618,622,626,632,636,640,646,655,666,787,814,890 'vin-decod':255 'volum':833 'vs':114 'windsurf':113 'without':154,417 'work':6 'workflow':972 'yaml':503 'year':431,460,648 'yes':84,168 'zed':118 'zip':452,466,474,480,643,651,676","prices":[{"id":"37558c4c-bfe5-4622-8a19-40ddbd899074","listingId":"3cbfed36-be7e-4b12-82a0-072d9db5d6fb","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"drivly","category":"auto-dev-skill","install_from":"skills.sh"},"createdAt":"2026-04-19T00:41:26.726Z"}],"sources":[{"listingId":"3cbfed36-be7e-4b12-82a0-072d9db5d6fb","source":"github","sourceId":"drivly/auto-dev-skill","sourceUrl":"https://github.com/drivly/auto-dev-skill","isPrimary":false,"firstSeenAt":"2026-04-19T00:41:26.726Z","lastSeenAt":"2026-04-19T00:41:26.726Z"}],"details":{"listingId":"3cbfed36-be7e-4b12-82a0-072d9db5d6fb","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"drivly","slug":"auto-dev-skill","github":{"repo":"drivly/auto-dev-skill","stars":12,"topics":["agent-skills","auto-dev","automotive-apis","automotive-data","car-api","claude-code","codex-skills","vehicle-listings","vin-decoder"],"license":"mit","html_url":"https://github.com/drivly/auto-dev-skill","pushed_at":"2026-04-08T15:46:52Z","description":"Automotive Data for AI Agents","skill_md_sha":"4fa45f90891abef51f0baff20f226c128e5cda5f","skill_md_path":"SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/drivly/auto-dev-skill"},"layout":"root","source":"github","category":"auto-dev-skill","frontmatter":{"name":"auto-dev","description":"Use when working with Auto.dev APIs, vehicle data, VIN decoding, car listings, vehicle photos, specs, recalls, payments, interest rates, taxes, OEM build data, plate-to-VIN, CLI commands, MCP tools, or SDK methods for any automotive data task"},"skills_sh_url":"https://skills.sh/drivly/auto-dev-skill"},"updatedAt":"2026-04-19T00:41:26.726Z"}}