[{"data":1,"prerenderedAt":796},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-installation":125,"-getting-started-installation-surround":791},[4,28,62,94,100],{"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?",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 Borgata 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},"The Hit","/heist-pipeline/the-hit","3.heist-pipeline/5.the-hit",{"title":91,"path":92,"stem":93,"order":47},"Laundering","/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",{"id":126,"title":13,"body":127,"description":784,"extension":785,"links":786,"meta":787,"navigation":788,"path":14,"seo":789,"stem":15,"__hash__":790},"docs/1.getting-started/installation.md",{"type":128,"value":129,"toc":777},"minimark",[130,134,138,148,153,166,170,585,589,596,623,626,650,654,657,702,707,711,773],[131,132,13],"h1",{"id":133},"installation",[135,136,137],"p",{},"Gangsta 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.",[139,140,143,147],"callout",{"icon":141,"type":142},"i-lucide-package","info",[144,145,146],"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.",[149,150,152],"h2",{"id":151},"prerequisites","Prerequisites",[154,155,156,160,163],"ul",{},[157,158,159],"li",{},"Git",[157,161,162],{},"An AI coding tool (Claude Code, OpenCode, Codex, Gemini CLI, or Cursor)",[157,164,165],{},"A project directory where you want to use Gangsta",[149,167,169],{"id":168},"install-for-your-platform","Install for Your Platform",[171,172,173,305,431,494,528],"code-group",{},[174,175,181],"pre",{"className":176,"code":177,"filename":178,"language":179,"meta":180,"style":180},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# 1. Clone the Gangsta repo\ngit clone https://github.com/kucherenko/gangsta.git ~/gangsta\n\n# 2. Add the skills path to your Claude Code config\n# Edit ~/.claude/settings.json (or your project's .claude/settings.json)\n# Add under \"mcpServers\" or the appropriate config key:\n{\n  \"mcpServers\": {},\n  \"skills\": {\n    \"paths\": [\"~/gangsta/skills\"]\n  }\n}\n\n# 3. Restart Claude Code\n","Claude Code","bash","",[182,183,184,192,208,214,219,224,229,235,248,259,282,288,294,299],"code",{"__ignoreMap":180},[185,186,188],"span",{"class":187,"line":11},"line",[185,189,191],{"class":190},"sHwdD","# 1. Clone the Gangsta repo\n",[185,193,194,198,202,205],{"class":187,"line":16},[185,195,197],{"class":196},"sBMFI","git",[185,199,201],{"class":200},"sfazB"," clone",[185,203,204],{"class":200}," https://github.com/kucherenko/gangsta.git",[185,206,207],{"class":200}," ~/gangsta\n",[185,209,210],{"class":187,"line":21},[185,211,213],{"emptyLinePlaceholder":212},true,"\n",[185,215,216],{"class":187,"line":26},[185,217,218],{"class":190},"# 2. Add the skills path to your Claude Code config\n",[185,220,221],{"class":187,"line":38},[185,222,223],{"class":190},"# Edit ~/.claude/settings.json (or your project's .claude/settings.json)\n",[185,225,226],{"class":187,"line":60},[185,227,228],{"class":190},"# Add under \"mcpServers\" or the appropriate config key:\n",[185,230,231],{"class":187,"line":47},[185,232,234],{"class":233},"sMK4o","{\n",[185,236,238,241,245],{"class":187,"line":237},8,[185,239,240],{"class":196},"  \"mcpServers\"",[185,242,244],{"class":243},"s2Zo4",":",[185,246,247],{"class":200}," {},\n",[185,249,251,254,256],{"class":187,"line":250},9,[185,252,253],{"class":196},"  \"skills\"",[185,255,244],{"class":243},[185,257,258],{"class":200}," {\n",[185,260,262,265,267,271,274,277,279],{"class":187,"line":261},10,[185,263,264],{"class":196},"    \"paths\"",[185,266,244],{"class":243},[185,268,270],{"class":269},"sTEyZ"," [",[185,272,273],{"class":233},"\"",[185,275,276],{"class":200},"~/gangsta/skills",[185,278,273],{"class":233},[185,280,281],{"class":269},"]\n",[185,283,285],{"class":187,"line":284},11,[185,286,287],{"class":233},"  }\n",[185,289,291],{"class":187,"line":290},12,[185,292,293],{"class":269},"}\n",[185,295,297],{"class":187,"line":296},13,[185,298,213],{"emptyLinePlaceholder":212},[185,300,302],{"class":187,"line":301},14,[185,303,304],{"class":190},"# 3. Restart Claude Code\n",[174,306,309],{"className":176,"code":307,"filename":308,"language":179,"meta":180,"style":180},"# 1. Clone the Gangsta repo\ngit clone https://github.com/kucherenko/gangsta.git ~/gangsta\n\n# 2. Create or edit opencode.json in your project root\n# Add the Gangsta plugin with skills path:\n{\n  \"plugins\": {\n    \"gangsta\": {\n      \"source\": \"~/gangsta\"\n    }\n  },\n  \"skills\": {\n    \"paths\": [\"~/gangsta/skills\"]\n  }\n}\n\n# 3. Restart OpenCode\n","OpenCode",[182,310,311,315,325,329,334,339,343,352,361,377,382,387,395,411,415,420,425],{"__ignoreMap":180},[185,312,313],{"class":187,"line":11},[185,314,191],{"class":190},[185,316,317,319,321,323],{"class":187,"line":16},[185,318,197],{"class":196},[185,320,201],{"class":200},[185,322,204],{"class":200},[185,324,207],{"class":200},[185,326,327],{"class":187,"line":21},[185,328,213],{"emptyLinePlaceholder":212},[185,330,331],{"class":187,"line":26},[185,332,333],{"class":190},"# 2. Create or edit opencode.json in your project root\n",[185,335,336],{"class":187,"line":38},[185,337,338],{"class":190},"# Add the Gangsta plugin with skills path:\n",[185,340,341],{"class":187,"line":60},[185,342,234],{"class":233},[185,344,345,348,350],{"class":187,"line":47},[185,346,347],{"class":196},"  \"plugins\"",[185,349,244],{"class":243},[185,351,258],{"class":200},[185,353,354,357,359],{"class":187,"line":237},[185,355,356],{"class":196},"    \"gangsta\"",[185,358,244],{"class":243},[185,360,258],{"class":200},[185,362,363,366,368,371,374],{"class":187,"line":250},[185,364,365],{"class":196},"      \"source\"",[185,367,244],{"class":243},[185,369,370],{"class":233}," \"",[185,372,373],{"class":200},"~/gangsta",[185,375,376],{"class":233},"\"\n",[185,378,379],{"class":187,"line":261},[185,380,381],{"class":233},"    }\n",[185,383,384],{"class":187,"line":284},[185,385,386],{"class":269},"  },\n",[185,388,389,391,393],{"class":187,"line":290},[185,390,253],{"class":196},[185,392,244],{"class":243},[185,394,258],{"class":200},[185,396,397,399,401,403,405,407,409],{"class":187,"line":296},[185,398,264],{"class":196},[185,400,244],{"class":243},[185,402,270],{"class":269},[185,404,273],{"class":233},[185,406,276],{"class":200},[185,408,273],{"class":233},[185,410,281],{"class":269},[185,412,413],{"class":187,"line":301},[185,414,287],{"class":269},[185,416,418],{"class":187,"line":417},15,[185,419,293],{"class":269},[185,421,423],{"class":187,"line":422},16,[185,424,213],{"emptyLinePlaceholder":212},[185,426,428],{"class":187,"line":427},17,[185,429,430],{"class":190},"# 3. Restart OpenCode\n",[174,432,435],{"className":176,"code":433,"filename":434,"language":179,"meta":180,"style":180},"# 1. Clone the Gangsta repo\ngit clone https://github.com/kucherenko/gangsta.git ~/gangsta\n\n# 2. Symlink skills to the Codex skills directory\nmkdir -p ~/.agents/skills\nln -s ~/gangsta/skills/gangsta ~/.agents/skills/gangsta\n\n# 3. Restart Codex\n","Codex",[182,436,437,441,451,455,460,471,485,489],{"__ignoreMap":180},[185,438,439],{"class":187,"line":11},[185,440,191],{"class":190},[185,442,443,445,447,449],{"class":187,"line":16},[185,444,197],{"class":196},[185,446,201],{"class":200},[185,448,204],{"class":200},[185,450,207],{"class":200},[185,452,453],{"class":187,"line":21},[185,454,213],{"emptyLinePlaceholder":212},[185,456,457],{"class":187,"line":26},[185,458,459],{"class":190},"# 2. Symlink skills to the Codex skills directory\n",[185,461,462,465,468],{"class":187,"line":38},[185,463,464],{"class":196},"mkdir",[185,466,467],{"class":200}," -p",[185,469,470],{"class":200}," ~/.agents/skills\n",[185,472,473,476,479,482],{"class":187,"line":60},[185,474,475],{"class":196},"ln",[185,477,478],{"class":200}," -s",[185,480,481],{"class":200}," ~/gangsta/skills/gangsta",[185,483,484],{"class":200}," ~/.agents/skills/gangsta\n",[185,486,487],{"class":187,"line":47},[185,488,213],{"emptyLinePlaceholder":212},[185,490,491],{"class":187,"line":237},[185,492,493],{"class":190},"# 3. Restart Codex\n",[174,495,498],{"className":176,"code":496,"filename":497,"language":179,"meta":180,"style":180},"# Install directly via the Gemini extensions registry\ngemini extensions install https://github.com/kucherenko/gangsta\n\n# This handles cloning, path configuration, and registration automatically\n","Gemini CLI",[182,499,500,505,519,523],{"__ignoreMap":180},[185,501,502],{"class":187,"line":11},[185,503,504],{"class":190},"# Install directly via the Gemini extensions registry\n",[185,506,507,510,513,516],{"class":187,"line":16},[185,508,509],{"class":196},"gemini",[185,511,512],{"class":200}," extensions",[185,514,515],{"class":200}," install",[185,517,518],{"class":200}," https://github.com/kucherenko/gangsta\n",[185,520,521],{"class":187,"line":21},[185,522,213],{"emptyLinePlaceholder":212},[185,524,525],{"class":187,"line":26},[185,526,527],{"class":190},"# This handles cloning, path configuration, and registration automatically\n",[174,529,532],{"className":176,"code":530,"filename":531,"language":179,"meta":180,"style":180},"# 1. Clone the Gangsta repo\ngit clone https://github.com/kucherenko/gangsta.git ~/gangsta\n\n# 2. Follow the Claude Code installation steps\n# Cursor uses the same conventions as Claude Code for skill registration\n\n# 3. In Cursor settings, add the skills path:\n#    ~/gangsta/skills\n\n# 4. Restart Cursor\n","Cursor",[182,533,534,538,548,552,557,562,566,571,576,580],{"__ignoreMap":180},[185,535,536],{"class":187,"line":11},[185,537,191],{"class":190},[185,539,540,542,544,546],{"class":187,"line":16},[185,541,197],{"class":196},[185,543,201],{"class":200},[185,545,204],{"class":200},[185,547,207],{"class":200},[185,549,550],{"class":187,"line":21},[185,551,213],{"emptyLinePlaceholder":212},[185,553,554],{"class":187,"line":26},[185,555,556],{"class":190},"# 2. Follow the Claude Code installation steps\n",[185,558,559],{"class":187,"line":38},[185,560,561],{"class":190},"# Cursor uses the same conventions as Claude Code for skill registration\n",[185,563,564],{"class":187,"line":60},[185,565,213],{"emptyLinePlaceholder":212},[185,567,568],{"class":187,"line":47},[185,569,570],{"class":190},"# 3. In Cursor settings, add the skills path:\n",[185,572,573],{"class":187,"line":237},[185,574,575],{"class":190},"#    ~/gangsta/skills\n",[185,577,578],{"class":187,"line":250},[185,579,213],{"emptyLinePlaceholder":212},[185,581,582],{"class":187,"line":261},[185,583,584],{"class":190},"# 4. Restart Cursor\n",[149,586,588],{"id":587},"verify-installation","Verify Installation",[135,590,591,592,595],{},"After installing, start a ",[144,593,594],{},"new session"," with your AI tool and test with this prompt:",[139,597,600,606,612],{"icon":598,"type":599},"i-lucide-check-circle","success",[135,601,602,605],{},[144,603,604],{},"Verification prompt:"," Start a new session and say:",[607,608,609],"blockquote",{},[135,610,611],{},"\"I want to build a new feature\"",[135,613,614,615,618,619,622],{},"The agent should ",[144,616,617],{},"automatically invoke"," ",[182,620,621],{},"gangsta:reconnaissance"," and begin gathering intel about your codebase and requirements. If it does, installation is successful.",[135,624,625],{},"If the agent doesn't invoke the skill:",[627,628,629,632,639],"ol",{},[157,630,631],{},"Check that the skills path is correctly configured",[157,633,634,635,638],{},"Ensure you're starting a ",[144,636,637],{},"fresh session"," (skills are loaded at session start)",[157,640,641,642,645,646,649],{},"Verify the ",[182,643,644],{},"skills/"," directory contains ",[182,647,648],{},".md"," files (not nested too deep)",[149,651,653],{"id":652},"updating","Updating",[135,655,656],{},"To update Gangsta skills to the latest version:",[171,658,659,685],{},[174,660,663],{"className":176,"code":661,"filename":662,"language":179,"meta":180,"style":180},"cd ~/gangsta\ngit pull origin main\n","Git Clone (All Platforms)",[182,664,665,672],{"__ignoreMap":180},[185,666,667,670],{"class":187,"line":11},[185,668,669],{"class":243},"cd",[185,671,207],{"class":200},[185,673,674,676,679,682],{"class":187,"line":16},[185,675,197],{"class":196},[185,677,678],{"class":200}," pull",[185,680,681],{"class":200}," origin",[185,683,684],{"class":200}," main\n",[174,686,688],{"className":176,"code":687,"filename":497,"language":179,"meta":180,"style":180},"gemini extensions update gangsta\n",[182,689,690],{"__ignoreMap":180},[185,691,692,694,696,699],{"class":187,"line":11},[185,693,509],{"class":196},[185,695,512],{"class":200},[185,697,698],{"class":200}," update",[185,700,701],{"class":200}," gangsta\n",[139,703,706],{"icon":704,"type":705},"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.",[149,708,710],{"id":709},"troubleshooting","Troubleshooting",[712,713,714,727],"table",{},[715,716,717],"thead",{},[718,719,720,724],"tr",{},[721,722,723],"th",{},"Issue",[721,725,726],{},"Solution",[728,729,730,739,750,761],"tbody",{},[718,731,732,736],{},[733,734,735],"td",{},"Agent doesn't invoke skills",[733,737,738],{},"Check skills path configuration; restart session",[718,740,741,744],{},[733,742,743],{},"Skills appear but produce errors",[733,745,746,747,749],{},"Verify skill files are ",[182,748,648],{}," format, not corrupted",[718,751,752,755],{},[733,753,754],{},"Partial skill invocation",[733,756,757,758,760],{},"Ensure the entire ",[182,759,644],{}," directory is linked, not individual files",[718,762,763,766],{},[733,764,765],{},"Gemini CLI extension not found",[733,767,768,769,772],{},"Ensure ",[182,770,771],{},"gemini extensions install"," completed without errors",[774,775,776],"style",{},"html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}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 pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}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);}",{"title":180,"searchDepth":16,"depth":16,"links":778},[779,780,781,782,783],{"id":151,"depth":16,"text":152},{"id":168,"depth":16,"text":169},{"id":587,"depth":16,"text":588},{"id":652,"depth":16,"text":653},{"id":709,"depth":16,"text":710},"Install Gangsta skills on your preferred AI development platform.","md",null,{},{"order":16},{"title":13,"description":784},"thGGI0EaP8LnWQcX_VwxGO3j-qqC-2fM-qBy4B7DAEU",[792,794],{"title":10,"path":6,"stem":7,"description":793,"order":11,"children":-1},"An AI agentic skills framework for spec-driven development, organized around the Borgata metaphor.",{"title":18,"path":19,"stem":20,"description":795,"order":21,"children":-1},"Walk through your first Gangsta Heist cycle from start to finish.",1776282625801]