{"id":"1bf687f6-5870-45dc-bfec-9c28a434395f","shortId":"EpPZA3","kind":"skill","title":"blockrun","tagline":"BlockRun works with Claude Code and Google Antigravity.","description":"# BlockRun\n\n**BlockRun works with Claude Code and Google Antigravity.**\n\nYou can't generate images. You have no real-time X/Twitter access. BlockRun gives you these capabilities.\n\n## Philosophy\n\nYou have a wallet. When you need a capability you lack, you pay for it autonomously.\n\n| You Need | You Call | Pricing |\n|----------|----------|---------|\n| Image generation | DALL-E | $0.04/image |\n| Real-time X data | Grok + Live Search | $0.025/source |\n| Second opinion | GPT-5.2 | $1.75/M input, $14/M output |\n| Cheaper processing | DeepSeek | $0.14/M input, $0.28/M output |\n\n**How it works:** BlockRun uses x402 micropayments to route your requests to OpenAI, xAI, Google, and other providers. No API keys needed - your wallet pays per token.\n\n## Budget Control (Optional)\n\nIf the user specifies a budget (e.g., \"use at most $1\"), track spending and stop when budget is reached:\n\n```python\nfrom blockrun_llm import setup_agent_wallet\n\nclient = setup_agent_wallet()\nbudget = 1.0  # User's budget\n\n# Before each call, check if within budget\nspending = client.get_spending()\nif spending['total_usd'] >= budget:\n    print(f\"Budget reached: ${spending['total_usd']:.4f} spent\")\n    # Stop making calls\nelse:\n    response = client.chat(\"openai/gpt-5.2\", \"Hello!\")\n\n# At the end, report spending\nspending = client.get_spending()\nprint(f\"💰 Total spent: ${spending['total_usd']:.4f} across {spending['calls']} calls\")\n```\n\n## When to Use\n| Trigger | Your Action |\n|---------|-------------|\n| User explicitly requests (\"blockrun second opinion with GPT on...\", \"use grok to check...\", \"generate image with dall-e\") | Execute via BlockRun |\n| User needs something you can't do (images, live X data) | Suggest BlockRun, wait for confirmation |\n| You can handle the task fine | Do it yourself, don't mention BlockRun |\n\n## Example User Prompts\n\nUsers will say things like:\n\n| User Says | What You Do |\n|-----------|-------------|\n| \"blockrun generate an image of a sunset\" | Call DALL-E via ImageClient |\n| \"use grok to check what's trending on X\" | Call Grok with `search=True` |\n| \"blockrun GPT review this code\" | Call GPT-5.2 via LLMClient |\n| \"what's the latest news about AI agents?\" | Suggest Grok (you lack real-time data) |\n| \"generate a logo for my startup\" | Suggest DALL-E (you can't generate images) |\n| \"blockrun check my balance\" | Show wallet balance via `get_balance()` |\n| \"blockrun deepseek summarize this file\" | Call DeepSeek for cost savings |\n\n## Wallet & Balance\n\nUse `setup_agent_wallet()` to auto-create a wallet and get a client. This shows the QR code and welcome message on first use.\n\n**Initialize client (always start with this):**\n```python\nfrom blockrun_llm import setup_agent_wallet\n\nclient = setup_agent_wallet()  # Auto-creates wallet, shows QR if new\n```\n\n**Check balance (when user asks \"show balance\", \"check wallet\", etc.):**\n```python\nbalance = client.get_balance()  # On-chain USDC balance\nprint(f\"Balance: ${balance:.2f} USDC\")\nprint(f\"Wallet: {client.get_wallet_address()}\")\n```\n\n**Show QR code for funding:**\n```python\nfrom blockrun_llm import generate_wallet_qr_ascii, get_wallet_address\n\n# ASCII QR for terminal display\nprint(generate_wallet_qr_ascii(get_wallet_address()))\n```\n\n## SDK Usage\n\n**Prerequisite:** Install the SDK with `pip install blockrun-llm`\n\n### Basic Chat\n```python\nfrom blockrun_llm import setup_agent_wallet\n\nclient = setup_agent_wallet()  # Auto-creates wallet if needed\nresponse = client.chat(\"openai/gpt-5.2\", \"What is 2+2?\")\nprint(response)\n\n# Check spending\nspending = client.get_spending()\nprint(f\"Spent ${spending['total_usd']:.4f}\")\n```\n\n### Real-time X/Twitter Search (xAI Live Search)\n\n**IMPORTANT:** For real-time X/Twitter data, you MUST enable Live Search with `search=True` or `search_parameters`.\n\n```python\nfrom blockrun_llm import setup_agent_wallet\n\nclient = setup_agent_wallet()\n\n# Simple: Enable live search with search=True\nresponse = client.chat(\n    \"xai/grok-3\",\n    \"What are the latest posts from @blockrunai on X?\",\n    search=True  # Enables real-time X/Twitter search\n)\nprint(response)\n```\n\n### Advanced X Search with Filters\n\n```python\nfrom blockrun_llm import setup_agent_wallet\n\nclient = setup_agent_wallet()\n\nresponse = client.chat(\n    \"xai/grok-3\",\n    \"Analyze @blockrunai's recent content and engagement\",\n    search_parameters={\n        \"mode\": \"on\",\n        \"sources\": [\n            {\n                \"type\": \"x\",\n                \"included_x_handles\": [\"blockrunai\"],\n                \"post_favorite_count\": 5\n            }\n        ],\n        \"max_search_results\": 20,\n        \"return_citations\": True\n    }\n)\nprint(response)\n```\n\n### Image Generation\n```python\nfrom blockrun_llm import ImageClient\n\nclient = ImageClient()\nresult = client.generate(\"A cute cat wearing a space helmet\")\nprint(result.data[0].url)\n```\n\n## xAI Live Search Reference\n\nLive Search is xAI's real-time data API. Cost: **$0.025 per source** (default 10 sources = ~$0.26).\n\nTo reduce costs, set `max_search_results` to a lower value:\n```python\n# Only use 5 sources (~$0.13)\nresponse = client.chat(\"xai/grok-3\", \"What's trending?\",\n    search_parameters={\"mode\": \"on\", \"max_search_results\": 5})\n```\n\n### Search Parameters\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `mode` | string | \"auto\" | \"off\", \"auto\", or \"on\" |\n| `sources` | array | web,news,x | Data sources to query |\n| `return_citations` | bool | true | Include source URLs |\n| `from_date` | string | - | Start date (YYYY-MM-DD) |\n| `to_date` | string | - | End date (YYYY-MM-DD) |\n| `max_search_results` | int | 10 | Max sources to return (customize to control cost) |\n\n### Source Types\n\n**X/Twitter Source:**\n```python\n{\n    \"type\": \"x\",\n    \"included_x_handles\": [\"handle1\", \"handle2\"],  # Max 10\n    \"excluded_x_handles\": [\"spam_account\"],        # Max 10\n    \"post_favorite_count\": 100,  # Min likes threshold\n    \"post_view_count\": 1000      # Min views threshold\n}\n```\n\n**Web Source:**\n```python\n{\n    \"type\": \"web\",\n    \"country\": \"US\",  # ISO alpha-2 code\n    \"allowed_websites\": [\"example.com\"],  # Max 5\n    \"safe_search\": True\n}\n```\n\n**News Source:**\n```python\n{\n    \"type\": \"news\",\n    \"country\": \"US\",\n    \"excluded_websites\": [\"tabloid.com\"]  # Max 5\n}\n```\n\n## Available Models\n\n| Model | Best For | Pricing |\n|-------|----------|---------|\n| `openai/gpt-5.2` | Second opinions, code review, general | $1.75/M in, $14/M out |\n| `openai/gpt-5-mini` | Cost-optimized reasoning | $0.30/M in, $1.20/M out |\n| `openai/o4-mini` | Latest efficient reasoning | $1.10/M in, $4.40/M out |\n| `openai/o3` | Advanced reasoning, complex problems | $10/M in, $40/M out |\n| `xai/grok-3` | Real-time X/Twitter data | $3/M + $0.025/source |\n| `deepseek/deepseek-chat` | Simple tasks, bulk processing | $0.14/M in, $0.28/M out |\n| `google/gemini-2.5-flash` | Very long documents, fast | $0.15/M in, $0.60/M out |\n| `openai/dall-e-3` | Photorealistic images | $0.04/image |\n| `google/nano-banana` | Fast, artistic images | $0.01/image |\n\n*M = million tokens. Actual cost depends on your prompt and response length.*\n\n## Cost Reference\n\nAll LLM costs are per million tokens (M = 1,000,000 tokens).\n\n| Model | Input | Output |\n|-------|-------|--------|\n| GPT-5.2 | $1.75/M | $14.00/M |\n| GPT-5-mini | $0.30/M | $1.20/M |\n| Grok-3 (no search) | $3.00/M | $15.00/M |\n| DeepSeek | $0.14/M | $0.28/M |\n\n| Fixed Cost Actions | |\n|-------|--------|\n| Grok Live Search | $0.025/source (default 10 = $0.25) |\n| DALL-E image | $0.04/image |\n| Nano Banana image | $0.01/image |\n\n**Typical costs:** A 500-word prompt (~750 tokens) to GPT-5.2 costs ~$0.001 input. A 1000-word response (~1500 tokens) costs ~$0.02 output.\n\n## Setup & Funding\n\n**Wallet location:** `$HOME/.blockrun/.session` (e.g., `/Users/username/.blockrun/.session`)\n\n**First-time setup:**\n1. Wallet auto-creates when `setup_agent_wallet()` is called\n2. Check wallet and balance:\n```python\nfrom blockrun_llm import setup_agent_wallet\nclient = setup_agent_wallet()\nprint(f\"Wallet: {client.get_wallet_address()}\")\nprint(f\"Balance: ${client.get_balance():.2f} USDC\")\n```\n3. Fund wallet with $1-5 USDC on Base network\n\n**Show QR code for funding (ASCII for terminal):**\n```python\nfrom blockrun_llm import generate_wallet_qr_ascii, get_wallet_address\nprint(generate_wallet_qr_ascii(get_wallet_address()))\n```\n\n## Troubleshooting\n\n**\"Grok says it has no real-time access\"**\n→ You forgot to enable Live Search. Add `search=True`:\n```python\nresponse = client.chat(\"xai/grok-3\", \"What's trending?\", search=True)\n```\n\n**Module not found**\n→ Install the SDK: `pip install blockrun-llm`\n\n## Updates\n\n```bash\npip install --upgrade blockrun-llm\n```\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["blockrun","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity-skills"],"capabilities":["skill","source-sickn33","skill-blockrun","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/blockrun","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34882 github stars · SKILL.md body (8,980 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-24T12:50:41.125Z","embedding":null,"createdAt":"2026-04-18T21:33:37.765Z","updatedAt":"2026-04-24T12:50:41.125Z","lastSeenAt":"2026-04-24T12:50:41.125Z","tsv":"'+2':522 '-2':835 '-3':989 '-5':982,1103 '-5.2':79,316,976,1033 '/image':65,939,945,1017,1022 '/m':81,89,92,870,880,883,890,893,919,922,930,933,978,980,985,987,993,995,998,1000 '/source':75,912,1008 '/users/username/.blockrun/.session':1052 '0':676 '0.001':1035 '0.01':944,1021 '0.02':1044 '0.025':74,693,911,1007 '0.04':64,938,1016 '0.13':716 '0.14':88,918,997 '0.15':929 '0.25':1011 '0.26':699 '0.28':91,921,999 '0.30':879,984 '0.60':932 '000':969,970 '1':134,968,1057,1102 '1.0':156 '1.10':889 '1.20':882,986 '1.75':80,869,977 '10':697,782,804,811,1010 '10/m':900 '100':815 '1000':822,1038 '14.00':979 '14/m':83,872 '15.00':994 '1500':1041 '2':521,1068 '20':649 '2f':446,1096 '3':1098 '3.00':992 '3/m':910 '4.40':892 '40/m':902 '4f':182,207,536 '5':645,714,730,841,856 '500':1026 '750':1029 'access':31,1145 'account':809 'across':208 'action':217,1003 'actual':949 'add':1152 'address':453,470,483,1090,1127,1135 'advanc':604,896 'agent':149,153,326,374,409,413,504,508,569,573,615,619,1064,1079,1083 'ai':325 'allow':837 'alpha':834 'alway':399 'analyz':624 'antigrav':9,18 'api':113,691 'array':745 'artist':942 'ascii':467,471,480,1113,1124,1132 'ask':427,1216 'auto':378,416,511,739,741,1060 'auto-cr':377,415,510,1059 'autonom':53 'avail':857 'balanc':353,356,359,371,424,429,434,436,441,444,445,1072,1093,1095 'banana':1019 'base':1106 'bash':1176 'basic':496 'best':860 'blockrun':1,2,10,11,32,97,145,221,239,252,268,282,309,350,360,405,461,494,500,565,611,659,1075,1118,1173,1181 'blockrun-llm':493,1172,1180 'blockrunai':591,625,641 'bool':755 'boundari':1224 'budget':121,129,140,155,159,166,174,177 'bulk':916 'call':57,162,186,210,211,289,304,314,365,1067 'capabl':36,46 'cat':669 'chain':439 'chat':497 'cheaper':85 'check':163,230,298,351,423,430,525,1069 'citat':651,754 'clarif':1218 'claud':5,14 'clear':1191 'client':151,385,398,411,506,571,617,663,1081 'client.chat':189,517,583,622,718,1157 'client.generate':666 'client.get':168,198,435,451,528,1088,1094 'code':6,15,313,390,456,836,866,1110 'complex':898 'confirm':255 'content':628 'control':122,789 'cost':368,692,702,790,876,950,958,962,1002,1024,1034,1043 'cost-optim':875 'count':644,814,821 'countri':831,850 'creat':379,417,512,1061 'criteria':1227 'custom':787 'cute':668 'dall':62,235,291,343,1013 'dall-':61,234,290,342,1012 'data':70,250,334,551,690,749,909 'date':761,764,770,773 'dd':768,777 'deepseek':87,361,366,996 'deepseek/deepseek-chat':913 'default':696,735,1009 'depend':951 'describ':1195 'descript':736 'display':475 'document':927 'e':63,236,292,344,1014 'e.g':130,1051 'effici':887 'els':187 'enabl':554,576,596,1149 'end':194,772 'engag':630 'environ':1207 'environment-specif':1206 'etc':432 'exampl':269 'example.com':839 'exclud':805,852 'execut':237 'expert':1212 'explicit':219 'f':176,201,443,449,531,1086,1092 'fast':928,941 'favorit':643,813 'file':364 'filter':608 'fine':261 'first':395,1054 'first-tim':1053 'fix':1001 'forgot':1147 'found':1166 'fund':458,1047,1099,1112 'general':868 'generat':22,60,231,283,335,348,464,477,656,1121,1129 'get':358,383,468,481,1125,1133 'give':33 'googl':8,17,108 'google/gemini-2.5-flash':924 'google/nano-banana':940 'gpt':78,225,310,315,975,981,1032 'grok':71,228,296,305,328,988,1004,1137 'handl':258,640,800,807 'handle1':801 'handle2':802 'hello':191 'helmet':673 'home/.blockrun/.session':1050 'imag':23,59,232,247,285,349,655,937,943,1015,1020 'imagecli':294,662,664 'import':147,407,463,502,545,567,613,661,1077,1120 'includ':638,757,798 'initi':397 'input':82,90,973,1036,1221 'instal':487,492,1167,1171,1178 'int':781 'iso':833 'key':114 'lack':48,330 'latest':322,588,886 'length':957 'like':276,817 'limit':1183 'live':72,248,543,555,577,679,682,1005,1150 'llm':146,406,462,495,501,566,612,660,961,1076,1119,1174,1182 'llmclient':318 'locat':1049 'logo':337 'long':926 'lower':709 'm':946,967 'make':185 'match':1192 'max':646,704,727,778,783,803,810,840,855 'mention':267 'messag':393 'micropay':100 'million':947,965 'min':816,823 'mini':983 'miss':1229 'mm':767,776 'mode':633,725,737 'model':858,859,972 'modul':1164 'must':553 'nano':1018 'need':44,55,115,241,515 'network':1107 'new':422 'news':323,747,845,849 'on-chain':437 'openai':106 'openai/dall-e-3':935 'openai/gpt-5-mini':874 'openai/gpt-5.2':190,518,863 'openai/o3':895 'openai/o4-mini':885 'opinion':77,223,865 'optim':877 'option':123 'output':84,93,974,1045,1201 'paramet':562,632,724,732,733 'pay':50,118 'per':119,694,964 'permiss':1222 'philosophi':37 'photorealist':936 'pip':491,1170,1177 'post':589,642,812,819 'prerequisit':486 'price':58,862 'print':175,200,442,448,476,523,530,602,653,674,1085,1091,1128 'problem':899 'process':86,917 'prompt':271,954,1028 'provid':111 'python':143,403,433,459,498,563,609,657,711,795,828,847,1073,1116,1155 'qr':389,420,455,466,472,479,1109,1123,1131 'queri':752 'reach':142,178 'real':28,67,332,538,548,598,688,906,1143 'real-tim':27,66,331,537,547,597,687,905,1142 'reason':878,888,897 'recent':627 'reduc':701 'refer':681,959 'report':195 'request':104,220 'requir':1220 'respons':188,516,524,582,603,621,654,717,956,1040,1156 'result':648,665,706,729,780 'result.data':675 'return':650,753,786 'review':311,867,1213 'rout':102 'safe':842 'safeti':1223 'save':369 'say':274,278,1138 'scope':1194 'sdk':484,489,1169 'search':73,307,541,544,556,558,561,578,580,594,601,606,631,647,680,683,705,723,728,731,779,843,991,1006,1151,1153,1162 'second':76,222,864 'set':703 'setup':148,152,373,408,412,503,507,568,572,614,618,1046,1056,1063,1078,1082 'show':354,387,419,428,454,1108 'simpl':575,914 'skill':1186 'skill-blockrun' 'someth':242 'sourc':635,695,698,715,744,750,758,784,791,794,827,846 'source-sickn33' 'space':672 'spam':808 'specif':1208 'specifi':127 'spend':136,167,169,171,179,196,197,199,204,209,526,527,529,533 'spent':183,203,532 'start':400,763 'startup':340 'stop':138,184,1214 'string':738,762,771 'substitut':1204 'success':1226 'suggest':251,327,341 'summar':362 'sunset':288 'tabloid.com':854 'task':260,915,1190 'termin':474,1115 'test':1210 'thing':275 'threshold':818,825 'time':29,68,333,539,549,599,689,907,1055,1144 'token':120,948,966,971,1030,1042 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'total':172,180,202,205,534 'track':135 'treat':1199 'trend':301,722,1161 'trigger':215 'troubleshoot':1136 'true':308,559,581,595,652,756,844,1154,1163 'type':636,734,792,796,829,848 'typic':1023 'updat':1175 'upgrad':1179 'url':677,759 'us':832,851 'usag':485 'usd':173,181,206,535 'usdc':440,447,1097,1104 'use':98,131,214,227,295,372,396,713,1184 'user':126,157,218,240,270,272,277,426 'valid':1209 'valu':710 'via':238,293,317,357 'view':820,824 'wait':253 'wallet':41,117,150,154,355,370,375,381,410,414,418,431,450,452,465,469,478,482,505,509,513,570,574,616,620,1048,1058,1065,1070,1080,1084,1087,1089,1100,1122,1126,1130,1134 'wear':670 'web':746,826,830 'websit':838,853 'welcom':392 'within':165 'word':1027,1039 'work':3,12,96 'x':69,249,303,593,605,637,639,748,797,799,806 'x/twitter':30,540,550,600,793,908 'x402':99 'xai':107,542,678,685 'xai/grok-3':584,623,719,904,1158 'yyyi':766,775 'yyyy-mm-dd':765,774","prices":[{"id":"e66aac36-e027-4f88-bd81-42393cab0344","listingId":"1bf687f6-5870-45dc-bfec-9c28a434395f","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:33:37.765Z"}],"sources":[{"listingId":"1bf687f6-5870-45dc-bfec-9c28a434395f","source":"github","sourceId":"sickn33/antigravity-awesome-skills/blockrun","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/blockrun","isPrimary":false,"firstSeenAt":"2026-04-18T21:33:37.765Z","lastSeenAt":"2026-04-24T12:50:41.125Z"}],"details":{"listingId":"1bf687f6-5870-45dc-bfec-9c28a434395f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"blockrun","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34882,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"f5e4d8e3081bf635a58190adaa8a6b0584413c67","skill_md_path":"skills/blockrun/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/blockrun"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"blockrun","description":"BlockRun works with Claude Code and Google Antigravity."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/blockrun"},"updatedAt":"2026-04-24T12:50:41.125Z"}}