[{"data":1,"prerenderedAt":823},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-installation":129,"-getting-started-installation-surround":818},[4,28,62,94,100,125],{"title":5,"path":6,"stem":7,"children":8,"order":11,"icon":27},"Getting Started","/getting-started","1.getting-started/index",[9,12,17,22],{"title":10,"path":6,"stem":7,"order":11},"What is Gangsta Agents?",1,{"title":13,"path":14,"stem":15,"order":16},"Installation","/getting-started/installation","1.getting-started/installation",2,{"title":18,"path":19,"stem":20,"order":21},"Quickstart — Your First Heist","/getting-started/quickstart","1.getting-started/quickstart",3,{"title":23,"path":24,"stem":25,"order":26},"The 1% Rule","/getting-started/the-1-percent-rule","1.getting-started/the-1-percent-rule",4,"i-lucide-rocket",{"title":29,"path":30,"stem":31,"children":32,"order":11,"icon":61},"Core Concepts","/core-concepts","2.core-concepts/index",[33,34,39,43,48,52,56],{"title":29,"path":30,"stem":31,"order":11},{"title":35,"path":36,"stem":37,"order":38},"Intent Routing","/core-concepts/intent-routing","2.core-concepts/intent-routing",5,{"title":40,"path":41,"stem":42,"order":26},"Omerta — The Five Laws","/core-concepts/omerta","2.core-concepts/omerta",{"title":44,"path":45,"stem":46,"order":47},"Spec-Driven Development","/core-concepts/spec-driven-dev","2.core-concepts/spec-driven-dev",7,{"title":49,"path":50,"stem":51,"order":16},"The Gangsta Agents Family Hierarchy","/core-concepts/the-borgata","2.core-concepts/the-borgata",{"title":53,"path":54,"stem":55,"order":21},"The Heist Pipeline","/core-concepts/the-heist","2.core-concepts/the-heist",{"title":57,"path":58,"stem":59,"order":60},"The Ledger","/core-concepts/the-ledger","2.core-concepts/the-ledger",6,"i-lucide-brain",{"title":63,"icon":64,"path":65,"stem":66,"children":67},"Heist Pipeline","i-lucide-workflow","/heist-pipeline","3.heist-pipeline",[68,70,74,78,82,86,90],{"title":53,"path":65,"stem":69,"order":11},"3.heist-pipeline/index",{"title":71,"path":72,"stem":73,"order":16},"Reconnaissance","/heist-pipeline/reconnaissance","3.heist-pipeline/1.reconnaissance",{"title":75,"path":76,"stem":77,"order":21},"The Grilling","/heist-pipeline/the-grilling","3.heist-pipeline/2.the-grilling",{"title":79,"path":80,"stem":81,"order":26},"The Sit-Down","/heist-pipeline/the-sit-down","3.heist-pipeline/3.the-sit-down",{"title":83,"path":84,"stem":85,"order":38},"Resource Development","/heist-pipeline/resource-development","3.heist-pipeline/4.resource-development",{"title":87,"path":88,"stem":89,"order":60},"Execution","/heist-pipeline/the-hit","3.heist-pipeline/5.the-hit",{"title":91,"path":92,"stem":93,"order":47},"The Delivery","/heist-pipeline/laundering","3.heist-pipeline/6.laundering",{"title":95,"path":96,"stem":97,"children":98},"Skills Reference","/skills","4.skills/index",[99],{"title":95,"path":96,"stem":97},{"title":101,"icon":102,"path":103,"stem":104,"children":105},"Advanced","i-lucide-zap","/advanced","5.advanced",[106,109,113,117,121],{"title":107,"path":103,"stem":108,"order":11},"Advanced Topics","5.advanced/index",{"title":110,"path":111,"stem":112,"order":26},"Checkpoint Recovery","/advanced/checkpoint-recovery","5.advanced/checkpoint-recovery",{"title":114,"path":115,"stem":116,"order":38},"Contributing","/advanced/contributing","5.advanced/contributing",{"title":118,"path":119,"stem":120,"order":16},"Writing Custom Skills","/advanced/custom-skills","5.advanced/custom-skills",{"title":122,"path":123,"stem":124,"order":21},"Multi-Agent Patterns","/advanced/multi-agent-patterns","5.advanced/multi-agent-patterns",{"title":126,"path":127,"stem":128,"order":60},"Glossary","/glossary","6.glossary",{"id":130,"title":13,"body":131,"description":811,"extension":812,"links":813,"meta":814,"navigation":815,"path":14,"seo":816,"stem":15,"__hash__":817},"docs/1.getting-started/installation.md",{"type":132,"value":133,"toc":797},"minimark",[134,138,142,152,157,170,174,179,182,230,233,236,240,243,280,283,285,289,292,301,304,309,421,436,438,442,445,452,456,499,506,508,512,530,533,535,539,545,562,565,571,574,581,583,587,594,621,624,648,652,655,701,706,710,793],[135,136,13],"h1",{"id":137},"installation",[139,140,141],"p",{},"Gangsta Agents is a skills framework — it doesn't run as a standalone application. Instead, you install it into your AI coding tool so the agent can invoke skills automatically. Choose your platform below.",[143,144,147,151],"callout",{"icon":145,"type":146},"i-lucide-package","info",[148,149,150],"strong",{},"What you're installing:"," A collection of Markdown-based skill files that tell your AI agent when and how to use structured development processes. No runtime dependencies, no build step, no package manager required.",[153,154,156],"h2",{"id":155},"prerequisites","Prerequisites",[158,159,160,164,167],"ul",{},[161,162,163],"li",{},"Git",[161,165,166],{},"An AI coding tool: Claude Code, GitHub Copilot, OpenCode, Codex, Gemini CLI, or Cursor",[161,168,169],{},"A project directory where you want to use Gangsta Agents",[153,171,173],{"id":172},"install-for-your-platform","Install for Your Platform",[175,176,178],"h3",{"id":177},"claude-code","Claude Code",[139,180,181],{},"Run these two slash commands inside Claude Code:",[183,184,185,214],"code-group",{},[186,187,193],"pre",{"className":188,"code":189,"filename":190,"language":191,"meta":192,"style":192},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","/plugin marketplace add kucherenko/gangsta\n","1. Add marketplace","bash","",[194,195,196],"code",{"__ignoreMap":192},[197,198,200,204,208,211],"span",{"class":199,"line":11},"line",[197,201,203],{"class":202},"sBMFI","/plugin",[197,205,207],{"class":206},"sfazB"," marketplace",[197,209,210],{"class":206}," add",[197,212,213],{"class":206}," kucherenko/gangsta\n",[186,215,218],{"className":188,"code":216,"filename":217,"language":191,"meta":192,"style":192},"/plugin install gangsta@gangsta\n","2. Install plugin",[194,219,220],{"__ignoreMap":192},[197,221,222,224,227],{"class":199,"line":11},[197,223,203],{"class":202},[197,225,226],{"class":206}," install",[197,228,229],{"class":206}," gangsta@gangsta\n",[139,231,232],{},"That's it — Claude Code will fetch and register all Gangsta Agents skills automatically. Start a new session to activate them.",[234,235],"hr",{},[175,237,239],{"id":238},"github-copilot","GitHub Copilot",[139,241,242],{},"Run these two slash commands inside GitHub Copilot:",[183,244,245,264],{},[186,246,248],{"className":188,"code":247,"filename":190,"language":191,"meta":192,"style":192},"copilot plugin marketplace add kucherenko/gangsta\n",[194,249,250],{"__ignoreMap":192},[197,251,252,255,258,260,262],{"class":199,"line":11},[197,253,254],{"class":202},"copilot",[197,256,257],{"class":206}," plugin",[197,259,207],{"class":206},[197,261,210],{"class":206},[197,263,213],{"class":206},[186,265,267],{"className":188,"code":266,"filename":217,"language":191,"meta":192,"style":192},"copilot plugin install gangsta@gangsta-marketplace\n",[194,268,269],{"__ignoreMap":192},[197,270,271,273,275,277],{"class":199,"line":11},[197,272,254],{"class":202},[197,274,257],{"class":206},[197,276,226],{"class":206},[197,278,279],{"class":206}," gangsta@gangsta-marketplace\n",[139,281,282],{},"That's it — GitHub Copilot will fetch and register all Gangsta Agents skills automatically. Start a new session to activate them.",[234,284],{},[175,286,288],{"id":287},"opencode","OpenCode",[139,290,291],{},"Tell OpenCode in a new session:",[186,293,299],{"className":294,"code":296,"filename":297,"language":298,"meta":192},[295],"language-text","Fetch and follow instructions from https://raw.githubusercontent.com/kucherenko/gangsta/refs/heads/master/.opencode/INSTALL.md\n","Prompt OpenCode","text",[194,300,296],{"__ignoreMap":192},[139,302,303],{},"That's it — OpenCode will clone the repo, configure the plugin, and set up the skills path automatically.",[139,305,306],{},[148,307,308],{},"Prefer a manual install?",[183,310,311,331],{},[186,312,315],{"className":188,"code":313,"filename":314,"language":191,"meta":192,"style":192},"git clone https://github.com/kucherenko/gangsta.git ~/.gangsta\n","1. Clone",[194,316,317],{"__ignoreMap":192},[197,318,319,322,325,328],{"class":199,"line":11},[197,320,321],{"class":202},"git",[197,323,324],{"class":206}," clone",[197,326,327],{"class":206}," https://github.com/kucherenko/gangsta.git",[197,329,330],{"class":206}," ~/.gangsta\n",[186,332,337],{"className":333,"code":334,"filename":335,"language":336,"meta":192,"style":192},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"plugin\": [\"gangsta@file:///Users/you/.gangsta\"],\n  \"skills\": {\n    \"paths\": [\"~/.gangsta/skills\"]\n  }\n}\n","2. opencode.json","json",[194,338,339,345,373,387,411,416],{"__ignoreMap":192},[197,340,341],{"class":199,"line":11},[197,342,344],{"class":343},"sMK4o","{\n",[197,346,347,350,354,357,360,363,365,368,370],{"class":199,"line":16},[197,348,349],{"class":343},"  \"",[197,351,353],{"class":352},"spNyl","plugin",[197,355,356],{"class":343},"\"",[197,358,359],{"class":343},":",[197,361,362],{"class":343}," [",[197,364,356],{"class":343},[197,366,367],{"class":206},"gangsta@file:///Users/you/.gangsta",[197,369,356],{"class":343},[197,371,372],{"class":343},"],\n",[197,374,375,377,380,382,384],{"class":199,"line":21},[197,376,349],{"class":343},[197,378,379],{"class":352},"skills",[197,381,356],{"class":343},[197,383,359],{"class":343},[197,385,386],{"class":343}," {\n",[197,388,389,392,395,397,399,401,403,406,408],{"class":199,"line":26},[197,390,391],{"class":343},"    \"",[197,393,394],{"class":202},"paths",[197,396,356],{"class":343},[197,398,359],{"class":343},[197,400,362],{"class":343},[197,402,356],{"class":343},[197,404,405],{"class":206},"~/.gangsta/skills",[197,407,356],{"class":343},[197,409,410],{"class":343},"]\n",[197,412,413],{"class":199,"line":38},[197,414,415],{"class":343},"  }\n",[197,417,418],{"class":199,"line":60},[197,419,420],{"class":343},"}\n",[139,422,423,424,427,428,431,432,435],{},"Replace ",[194,425,426],{},"/Users/you/.gangsta"," with your actual clone path. The ",[194,429,430],{},"~"," shorthand works in ",[194,433,434],{},"skills.paths",". Restart OpenCode after saving.",[234,437],{},[175,439,441],{"id":440},"codex","Codex",[139,443,444],{},"Tell Codex in a new session:",[186,446,450],{"className":447,"code":448,"filename":449,"language":298,"meta":192},[295],"Fetch and follow instructions from https://raw.githubusercontent.com/kucherenko/gangsta/refs/heads/master/.codex/INSTALL.md\n","Prompt Codex",[194,451,448],{"__ignoreMap":192},[139,453,454],{},[148,455,308],{},[183,457,458],{},[186,459,462],{"className":188,"code":460,"filename":461,"language":191,"meta":192,"style":192},"git clone https://github.com/kucherenko/gangsta.git ~/.gangsta\nmkdir -p ~/.agents/skills\nln -sf ~/.gangsta/skills ~/.agents/skills/gangsta\n","Manual install",[194,463,464,474,485],{"__ignoreMap":192},[197,465,466,468,470,472],{"class":199,"line":11},[197,467,321],{"class":202},[197,469,324],{"class":206},[197,471,327],{"class":206},[197,473,330],{"class":206},[197,475,476,479,482],{"class":199,"line":16},[197,477,478],{"class":202},"mkdir",[197,480,481],{"class":206}," -p",[197,483,484],{"class":206}," ~/.agents/skills\n",[197,486,487,490,493,496],{"class":199,"line":21},[197,488,489],{"class":202},"ln",[197,491,492],{"class":206}," -sf",[197,494,495],{"class":206}," ~/.gangsta/skills",[197,497,498],{"class":206}," ~/.agents/skills/gangsta\n",[139,500,501,502,505],{},"Restart Codex — skills are discovered automatically from ",[194,503,504],{},"SKILL.md"," frontmatter.",[234,507],{},[175,509,511],{"id":510},"gemini-cli","Gemini CLI",[186,513,515],{"className":188,"code":514,"language":191,"meta":192,"style":192},"gemini extensions install https://github.com/kucherenko/gangsta\n",[194,516,517],{"__ignoreMap":192},[197,518,519,522,525,527],{"class":199,"line":11},[197,520,521],{"class":202},"gemini",[197,523,524],{"class":206}," extensions",[197,526,226],{"class":206},[197,528,529],{"class":206}," https://github.com/kucherenko/gangsta\n",[139,531,532],{},"This handles cloning, path configuration, and registration automatically.",[234,534],{},[175,536,538],{"id":537},"cursor","Cursor",[139,540,541,542,544],{},"Cursor doesn't have a native Gangsta Agents plugin yet. Use the ",[194,543,379],{}," utility to install all skills directly:",[186,546,548],{"className":188,"code":547,"language":191,"meta":192,"style":192},"npx skills add https://github.com/kucherenko/gangsta\n",[194,549,550],{"__ignoreMap":192},[197,551,552,555,558,560],{"class":199,"line":11},[197,553,554],{"class":202},"npx",[197,556,557],{"class":206}," skills",[197,559,210],{"class":206},[197,561,529],{"class":206},[139,563,564],{},"This installs the full Gangsta Agents skill set into your agent's skills directory. Once done, start a new Cursor session and prompt your agent:",[186,566,569],{"className":567,"code":568,"language":298},[295],"Use gangsta and build new feature\n",[194,570,568],{"__ignoreMap":192},[139,572,573],{},"Cursor will pick up the skills and invoke the right ones for the task.",[143,575,577,580],{"icon":576,"type":146},"i-lucide-info",[194,578,579],{},"npx skills add"," is also an alternative installation method for any platform listed above, if you prefer a single-command setup over platform-specific steps.",[234,582],{},[153,584,586],{"id":585},"verify-installation","Verify Installation",[139,588,589,590,593],{},"After installing, start a ",[148,591,592],{},"new session"," with your AI tool and test with this prompt:",[143,595,598,604,610],{"icon":596,"type":597},"i-lucide-check-circle","success",[139,599,600,603],{},[148,601,602],{},"Verification prompt:"," Start a new session and say:",[605,606,607],"blockquote",{},[139,608,609],{},"\"I want to build a new feature\"",[139,611,612,613,616,617,620],{},"The agent should ",[148,614,615],{},"automatically invoke"," ",[194,618,619],{},"gangsta:reconnaissance"," and begin gathering intel about your codebase and requirements. If it does, installation is successful.",[139,622,623],{},"If the agent doesn't invoke the skill:",[625,626,627,630,637],"ol",{},[161,628,629],{},"Check that the skills path is correctly configured",[161,631,632,633,636],{},"Ensure you're starting a ",[148,634,635],{},"fresh session"," (skills are loaded at session start)",[161,638,639,640,643,644,647],{},"Verify the ",[194,641,642],{},"skills/"," directory contains ",[194,645,646],{},".md"," files (not nested too deep)",[153,649,651],{"id":650},"updating","Updating",[139,653,654],{},"To update Gangsta Agents skills to the latest version:",[183,656,657,684],{},[186,658,661],{"className":188,"code":659,"filename":660,"language":191,"meta":192,"style":192},"cd ~/.gangsta\ngit pull origin master\n","All Platforms",[194,662,663,671],{"__ignoreMap":192},[197,664,665,669],{"class":199,"line":11},[197,666,668],{"class":667},"s2Zo4","cd",[197,670,330],{"class":206},[197,672,673,675,678,681],{"class":199,"line":16},[197,674,321],{"class":202},[197,676,677],{"class":206}," pull",[197,679,680],{"class":206}," origin",[197,682,683],{"class":206}," master\n",[186,685,687],{"className":188,"code":686,"filename":511,"language":191,"meta":192,"style":192},"gemini extensions update gangsta\n",[194,688,689],{"__ignoreMap":192},[197,690,691,693,695,698],{"class":199,"line":11},[197,692,521],{"class":202},[197,694,524],{"class":206},[197,696,697],{"class":206}," update",[197,699,700],{"class":206}," gangsta\n",[143,702,705],{"icon":703,"type":704},"i-lucide-refresh-cw","warning","Always update before starting a new Heist. Skill definitions evolve, and using the latest version ensures you have the most current process definitions.",[153,707,709],{"id":708},"troubleshooting","Troubleshooting",[711,712,713,726],"table",{},[714,715,716],"thead",{},[717,718,719,723],"tr",{},[720,721,722],"th",{},"Issue",[720,724,725],{},"Solution",[727,728,729,738,749,760,772,783],"tbody",{},[717,730,731,735],{},[732,733,734],"td",{},"Agent doesn't invoke skills",[732,736,737],{},"Check skills path configuration; restart session",[717,739,740,743],{},[732,741,742],{},"Skills appear but produce errors",[732,744,745,746,748],{},"Verify skill files are ",[194,747,646],{}," format, not corrupted",[717,750,751,754],{},[732,752,753],{},"Partial skill invocation",[732,755,756,757,759],{},"Ensure the entire ",[194,758,642],{}," directory is linked, not individual files",[717,761,762,765],{},[732,763,764],{},"Gemini CLI extension not found",[732,766,767,768,771],{},"Ensure ",[194,769,770],{},"gemini extensions install"," completed without errors",[717,773,774,777],{},[732,775,776],{},"Claude Code plugin not found",[732,778,779,780],{},"Ensure marketplace was added before running ",[194,781,782],{},"/plugin install",[717,784,785,788],{},[732,786,787],{},"GitHub Copilot plugin not found",[732,789,779,790],{},[194,791,792],{},"copilot plugin install",[794,795,796],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}",{"title":192,"searchDepth":16,"depth":16,"links":798},[799,800,808,809,810],{"id":155,"depth":16,"text":156},{"id":172,"depth":16,"text":173,"children":801},[802,803,804,805,806,807],{"id":177,"depth":21,"text":178},{"id":238,"depth":21,"text":239},{"id":287,"depth":21,"text":288},{"id":440,"depth":21,"text":441},{"id":510,"depth":21,"text":511},{"id":537,"depth":21,"text":538},{"id":585,"depth":16,"text":586},{"id":650,"depth":16,"text":651},{"id":708,"depth":16,"text":709},"Install Gangsta Agents skills on Claude Code, GitHub Copilot, OpenCode, Codex, Gemini CLI, or Cursor.","md",null,{},{"order":16},{"title":13,"description":811},"8TwPH6HXwIFBJEzR6VbV3egDqulQXiiwrM9xcH2ijV4",[819,821],{"title":10,"path":6,"stem":7,"description":820,"order":11,"children":-1},"An AI agentic skills framework for spec-driven development, organized around the mafia family metaphor.",{"title":18,"path":19,"stem":20,"description":822,"order":21,"children":-1},"Walk through your first Gangsta Agents Heist cycle from start to finish.",1776673362218]