{"id":"8b838430-c21a-450c-81d4-d68a383cb4fa","shortId":"m7me7J","kind":"skill","title":"jahro-commands","tagline":"Analyzes C# classes and generates [JahroCommand] attributes with correct syntax, RegisterObject patterns, and group organization. Use when the user wants to add runtime commands, cheats, or debug actions to Unity classes, or mentions JahroCommand, console commands, runtime cheats","description":"# Jahro Commands\n\nHelp users add runtime-callable debug commands to Unity code using Jahro's `[JahroCommand]` attribute system.\n\n## Workflow\n\n1. **Analyze** the user's code — identify methods that are good command candidates\n2. **Generate** correct `[JahroCommand]` attributes with proper syntax\n3. **Add registration** if needed (instance methods require `RegisterObject`)\n4. **VERIFY** — \"Enter Play Mode, press ~, check the Commands tab\"\n\n## Analyzing Code for Command Candidates\n\nWhen the user shares a class, identify methods worth exposing as commands:\n\n**Good candidates:**\n- Public methods that change game state (damage, heal, spawn, teleport, reset)\n- Methods used for testing and tuning (set difficulty, add currency, skip level)\n- Diagnostic methods (print stats, dump state, force GC)\n- Methods with simple parameter types (int, float, bool, string, Vector2, Vector3, enum)\n\n**Skip these:**\n- Unity lifecycle methods (Update, Start, Awake, OnEnable, OnDisable, OnDestroy)\n- Private implementation details the developer wouldn't want to call manually\n- Methods with complex parameter types (custom classes, interfaces, delegates)\n- Property getters/setters (use `[JahroWatch]` for monitoring instead)\n\n## Attribute Syntax\n\n```csharp\n[JahroCommand(\"command-name\", \"GroupName\", \"Short description of what it does\")]\n```\n\nConstructor: `[JahroCommand(string name, string group, string description)]`\n\nAll parameters are optional. Defaults: name = method name, group = \"Default\", description = \"\".\n\n### Naming conventions\n\n- **Command name**: kebab-case (`\"spawn-enemy\"`, `\"add-gold\"`, `\"set-difficulty\"`)\n- **Group name**: PascalCase or Title Case (`\"Cheats\"`, `\"Spawning\"`, `\"Game\"`)\n- **Description**: Imperative, concise (`\"Spawn enemy at position\"`, `\"Add gold to player\"`)\n\n### Complete example\n\n```csharp\nusing JahroConsole;\nusing UnityEngine;\n\npublic class PlayerController : MonoBehaviour\n{\n    public float health = 100f;\n\n    [JahroCommand(\"heal\", \"Player\", \"Restore health by amount\")]\n    public void Heal(float amount) { health = Mathf.Min(health + amount, 100f); }\n\n    [JahroCommand(\"teleport\", \"Player\", \"Teleport to position\")]\n    public void Teleport(Vector3 position) { transform.position = position; }\n\n    [JahroCommand(\"reset-pos\", \"Player\", \"Reset to origin\")]\n    public void ResetPosition() { transform.position = Vector3.zero; }\n\n    void OnEnable()  => Jahro.RegisterObject(this);\n    void OnDisable() => Jahro.UnregisterObject(this);\n}\n```\n\n## Registration Pattern\n\n### Instance methods — require RegisterObject\n\nAny non-static method with `[JahroCommand]` needs the owning object registered so Jahro can invoke it:\n\n```csharp\nvoid OnEnable()  => Jahro.RegisterObject(this);\nvoid OnDisable() => Jahro.UnregisterObject(this);\n```\n\nThis same call also registers `[JahroWatch]` attributes on the class. If the class already has RegisterObject (e.g., for watchers), do not add a second call.\n\nRead `references/common-patterns.md` for the full lifecycle pattern and anti-patterns.\n\n### Static methods — no registration needed\n\nStatic methods are discovered via assembly scanning:\n\n```csharp\npublic class DebugCommands\n{\n    [JahroCommand(\"restart-level\", \"Game\", \"Restart current level\")]\n    public static void RestartLevel()\n    {\n        UnityEngine.SceneManagement.SceneManager.LoadScene(0);\n    }\n}\n```\n\n### Decision guide\n\n| Method type | Needs RegisterObject? | Why |\n|:------------|:---------------------|:----|\n| `public void Foo()` (instance) | Yes | Jahro needs the object reference to call it |\n| `public static void Foo()` | No | Called on the class, discovered via assembly scan |\n| `public void Foo()` on a class that already has RegisterObject | No extra work | Already registered |\n\n## Supported Parameter Types\n\nCommands accept these parameter types:\n\n| Type | Text Mode input | Visual Mode input |\n|:-----|:---------------|:-----------------|\n| `int` | `42` | Number field |\n| `float` | `3.14` | Decimal field |\n| `bool` | `true` / `false` | Toggle switch |\n| `string` | `hello world` | Text field |\n| `Vector2` | `1.5 2.0` | X/Y fields |\n| `Vector3` | `10 2.5 -7` | X/Y/Z fields |\n| `enum` (any) | `Hard` (name) | Dropdown selector |\n\nMaximum 3 parameters per command. For full type details, read `references/api-reference.md`.\n\n## Command Overloads\n\nSame command name with different parameter signatures:\n\n```csharp\n[JahroCommand(\"spawn-enemy\", \"Spawning\", \"Spawn one enemy at position\")]\npublic void SpawnEnemy(Vector3 position) { /* ... */ }\n\n[JahroCommand(\"spawn-enemy\", \"Spawning\", \"Spawn N enemies\")]\npublic void SpawnEnemy(int count) { /* ... */ }\n```\n\nText Mode resolves the correct overload by parameter count and type conversion.\n\n## Return Values\n\nCommands that return `string` display the result in the console log:\n\n```csharp\n[JahroCommand(\"get-pos\", \"Debug\", \"Print player position\")]\npublic static string GetPlayerPosition()\n{\n    return $\"Position: {Player.Instance.transform.position}\";\n}\n```\n\n## Dynamic Command Registration\n\nFor commands created at runtime instead of compile time. Use when wrapping external APIs, creating commands from data, or in non-MonoBehaviour systems.\n\n```csharp\n// No parameters\nJahro.RegisterCommand(\"clear-cache\", \"Maintenance\", \"Clear local cache\",\n    () => PlayerPrefs.DeleteAll());\n\n// One typed parameter\nJahro.RegisterCommand<int>(\"add-gold\", \"Cheats\", \"Add gold\",\n    amount => Player.Gold += amount);\n\n// Two parameters\nJahro.RegisterCommand<int, float>(\"set-stats\", \"Tuning\", \"Set health and speed\",\n    (health, speed) => { Player.Health = health; Player.Speed = speed; });\n```\n\n**Parameter order for dynamic registration:** `(name, description, groupName, callback)`.\nThis differs from the attribute order `(name, group, description)`.\n\nRegister command on existing object method:\n\n```csharp\nvar mgr = FindObjectOfType<GameManager>();\nJahro.RegisterCommand(\"restart\", \"Game\", \"Restart level\",\n    mgr, nameof(GameManager.RestartLevel));\n```\n\nCleanup:\n\n```csharp\nJahro.UnregisterCommand(\"clear-cache\");\nJahro.UnregisterCommand(\"restart\", \"Game\");\n```\n\nRead `references/api-reference.md` for all `RegisterCommand` overloads (0-3 generic parameters).\n\n## Command Organization\n\n### Group naming strategy\n\nOrganize commands by functional area:\n\n```\n\"Player\"    — heal, teleport, reset, set-speed\n\"Spawning\"  — spawn-enemy, spawn-wave, clear-enemies\n\"Cheats\"    — god-mode, add-gold, unlock-all\n\"Game\"      — restart-level, set-difficulty, skip-level\n\"Debug\"     — dump-state, gc-collect, toggle-fps\n```\n\n### Visual Mode vs Text Mode\n\nCommands work in both modes automatically. Consider the target audience:\n\n- **Text Mode** — fast for developers who know command names. Autocomplete helps. Vector3 entered as `10 2.5 -7`.\n- **Visual Mode** — browsable groups with descriptions, form-based parameter input. Touch-friendly on mobile. Enum parameters render as dropdown selectors.\n\nWhen designing commands for QA (non-developers), prefer:\n- Simple parameter types (bool, enum, int) over Vector3\n- Descriptive names and descriptions\n- Logical groups that match QA workflows\n\n### Favorites and Recent\n\nUsers can star frequently-used commands for quick access. The last 10 executed commands always appear in the Recent section. Command names and groups help discoverability — be descriptive.\n\n## Contextual Awareness\n\nWhen you see these patterns in user code, proactively suggest:\n\n| Pattern in code | Suggestion |\n|:---------------|:-----------|\n| `[JahroCommand]` already present | Offer improvements (better groups, descriptions, missing commands) |\n| `OnGUI()` with `GUI.Button` debug commands | Migrate to `[JahroCommand]` — Visual Mode replaces the button UI |\n| Public methods that modify game state | Suggest exposing as commands |\n| Custom command parser (string → command) | Migrate to Jahro's typed command system |\n\n## Verification\n\nAfter generating commands, always include:\n\n> **Verify:** Enter Play Mode → press ~ → switch to the Commands tab (or Visual Mode). Confirm your commands appear in the correct groups. Try executing one to confirm it works.\n\nIf commands don't appear, suggest the jahro-troubleshooting skill — common causes: missing RegisterObject, wrong assembly selected, JAHRO_DISABLE active.","tags":["jahro","commands","unity","agent","skills","jahro-console","agent-skills","ai-assistant","ai-coding","claude-code","cursor","debugging"],"capabilities":["skill","source-jahro-console","skill-jahro-commands","topic-agent-skills","topic-ai-assistant","topic-ai-coding","topic-claude-code","topic-cursor","topic-debugging","topic-gamedev","topic-in-game-console","topic-jahro","topic-logging","topic-unity","topic-unity-package"],"categories":["unity-agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jahro-console/unity-agent-skills/jahro-commands","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jahro-console/unity-agent-skills","source_repo":"https://github.com/jahro-console/unity-agent-skills","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 (8,220 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-18T19:07:08.917Z","embedding":null,"createdAt":"2026-04-23T13:04:13.538Z","updatedAt":"2026-05-18T19:07:08.917Z","lastSeenAt":"2026-05-18T19:07:08.917Z","tsv":"'-3':746 '-7':524,837 '0':434,745 '1':62 '1.5':517 '10':522,835,902 '100f':285,302 '2':75 '2.0':518 '2.5':523,836 '3':83,534 '3.14':503 '4':92 '42':499 'accept':487 'access':899 'action':31 'activ':1035 'add':25,46,84,140,246,267,390,667,670,781 'add-gold':245,666,780 'alreadi':382,475,481,936 'also':372 'alway':905,985 'amount':292,297,301,672,674 'analyz':4,63,102 'anti':403 'anti-pattern':402 'api':639 'appear':906,1003,1019 'area':758 'assembl':415,466,1031 'attribut':10,59,79,202,375,707 'audienc':820 'autocomplet':830 'automat':816 'awak':171 'awar':920 'base':846 'better':940 'bool':159,506,872 'browsabl':840 'button':957 'c':5 'cach':656,660,735 'call':184,371,393,453,460 'callabl':49 'callback':702 'candid':74,106,120 'case':241,256 'caus':1027 'chang':124 'cheat':28,41,257,669,776 'check':98 'class':6,34,112,192,279,378,381,419,463,473 'cleanup':730 'clear':655,658,734,774 'clear-cach':654,733 'clear-enemi':773 'code':54,67,103,928,933 'collect':802 'command':3,27,39,43,51,73,100,105,118,207,237,486,537,544,547,596,624,627,641,713,749,755,811,828,862,896,904,911,944,949,968,970,973,979,984,995,1002,1016 'command-nam':206 'common':1026 'compil':633 'complet':271 'complex':188 'concis':262 'confirm':1000,1012 'consid':817 'consol':38,605 'constructor':216 'contextu':919 'convent':236 'convers':593 'correct':12,77,586,1006 'count':581,590 'creat':628,640 'csharp':204,273,360,417,553,607,650,718,731 'currenc':141 'current':427 'custom':191,969 'damag':127 'data':643 'debug':30,50,612,796,948 'debugcommand':420 'decim':504 'decis':435 'default':228,233 'deleg':194 'descript':211,223,234,260,700,711,843,877,880,918,942 'design':861 'detail':177,541 'develop':179,825,867 'diagnost':144 'differ':550,704 'difficulti':139,250,792 'disabl':1034 'discov':413,464 'discover':916 'display':600 'dropdown':531,858 'dump':148,798 'dump-stat':797 'dynam':623,697 'e.g':385 'enemi':244,264,557,561,572,576,769,775 'enter':94,833,988 'enum':163,527,854,873 'exampl':272 'execut':903,1009 'exist':715 'expos':116,966 'extern':638 'extra':479 'fals':508 'fast':823 'favorit':887 'field':501,505,515,520,526 'findobjectoftyp':721 'float':158,283,296,502,679 'foo':444,458,470 'forc':150 'form':845 'form-bas':844 'fps':805 'frequent':894 'frequently-us':893 'friend':851 'full':398,539 'function':757 'game':125,259,425,724,738,786,963 'gamemanager.restartlevel':729 'gc':151,801 'gc-collect':800 'generat':8,76,983 'generic':747 'get':610 'get-po':609 'getplayerposit':619 'getters/setters':196 'god':778 'god-mod':777 'gold':247,268,668,671,782 'good':72,119 'group':17,221,232,251,710,751,841,882,914,941,1007 'groupnam':209,701 'gui.button':947 'guid':436 'hard':529 'heal':128,287,295,760 'health':284,290,298,300,685,688,691 'hello':512 'help':44,831,915 'identifi':68,113 'imper':261 'implement':176 'improv':939 'includ':986 'input':494,497,848 'instanc':88,339,445 'instead':201,631 'int':157,498,580,678,874 'interfac':193 'invok':358 'jahro':2,42,56,356,447,976,1023,1033 'jahro-command':1 'jahro-troubleshoot':1022 'jahro.registercommand':653,665,677,722 'jahro.registerobject':331,363 'jahro.unregistercommand':732,736 'jahro.unregisterobject':335,367 'jahrocommand':9,37,58,78,205,217,286,303,316,349,421,554,569,608,935,952 'jahroconsol':275 'jahrowatch':198,374 'kebab':240 'kebab-cas':239 'know':827 'last':901 'level':143,424,428,726,789,795 'lifecycl':167,399 'local':659 'log':606 'logic':881 'mainten':657 'manual':185 'match':884 'mathf.min':299 'maximum':533 'mention':36 'method':69,89,114,122,132,145,152,168,186,230,340,347,406,411,437,717,960 'mgr':720,727 'migrat':950,974 'miss':943,1028 'mobil':853 'mode':96,493,496,583,779,807,810,815,822,839,954,990,999 'modifi':962 'monitor':200 'monobehaviour':281,648 'n':575 'name':208,219,229,231,235,238,252,530,548,699,709,752,829,878,912 'nameof':728 'need':87,350,409,439,448 'non':345,647,866 'non-develop':865 'non-monobehaviour':646 'non-stat':344 'number':500 'object':353,450,716 'offer':938 'ondestroy':174 'ondis':173,334,366 'one':560,662,1010 'onen':172,330,362 'ongui':945 'option':227 'order':695,708 'organ':18,750,754 'origin':323 'overload':545,587,744 'own':352 'paramet':155,189,225,484,489,535,551,589,652,664,676,694,748,847,855,870 'parser':971 'pascalcas':253 'pattern':15,338,400,404,925,931 'per':536 'play':95,989 'player':270,288,305,320,614,759 'player.gold':673 'player.health':690 'player.instance.transform.position':622 'player.speed':692 'playercontrol':280 'playerprefs.deleteall':661 'pos':319,611 'posit':266,308,313,315,563,568,615,621 'prefer':868 'present':937 'press':97,991 'print':146,613 'privat':175 'proactiv':929 'proper':81 'properti':195 'public':121,278,282,293,309,324,418,429,442,455,468,564,577,616,959 'qa':864,885 'quick':898 'read':394,542,739 'recent':889,909 'refer':451 'references/api-reference.md':543,740 'references/common-patterns.md':395 'regist':354,373,482,712 'registercommand':743 'registerobject':14,91,342,384,440,477,1029 'registr':85,337,408,625,698 'render':856 'replac':955 'requir':90,341 'reset':131,318,321,762 'reset-po':317 'resetposit':326 'resolv':584 'restart':423,426,723,725,737,788 'restart-level':422,787 'restartlevel':432 'restor':289 'result':602 'return':594,598,620 'runtim':26,40,48,630 'runtime-cal':47 'scan':416,467 'second':392 'section':910 'see':923 'select':1032 'selector':532,859 'set':138,249,681,684,764,791 'set-difficulti':248,790 'set-spe':763 'set-stat':680 'share':110 'short':210 'signatur':552 'simpl':154,869 'skill':1025 'skill-jahro-commands' 'skip':142,164,794 'skip-level':793 'source-jahro-console' 'spawn':129,243,258,263,556,558,559,571,573,574,766,768,771 'spawn-enemi':242,555,570,767 'spawn-wav':770 'spawnenemi':566,579 'speed':687,689,693,765 'star':892 'start':170 'stat':147,682 'state':126,149,799,964 'static':346,405,410,430,456,617 'strategi':753 'string':160,218,220,222,511,599,618,972 'suggest':930,934,965,1020 'support':483 'switch':510,992 'syntax':13,82,203 'system':60,649,980 'tab':101,996 'target':819 'teleport':130,304,306,311,761 'test':135 'text':492,514,582,809,821 'time':634 'titl':255 'toggl':509,804 'toggle-fp':803 'topic-agent-skills' 'topic-ai-assistant' 'topic-ai-coding' 'topic-claude-code' 'topic-cursor' 'topic-debugging' 'topic-gamedev' 'topic-in-game-console' 'topic-jahro' 'topic-logging' 'topic-unity' 'topic-unity-package' 'touch':850 'touch-friend':849 'transform.position':314,327 'tri':1008 'troubleshoot':1024 'true':507 'tune':137,683 'two':675 'type':156,190,438,485,490,491,540,592,663,871,978 'ui':958 'uniti':33,53,166 'unityengin':277 'unityengine.scenemanagement.scenemanager.loadscene':433 'unlock':784 'unlock-al':783 'updat':169 'use':19,55,133,197,274,276,635,895 'user':22,45,65,109,890,927 'valu':595 'var':719 'vector2':161,516 'vector3':162,312,521,567,832,876 'vector3.zero':328 'verif':981 'verifi':93,987 'via':414,465 'visual':495,806,838,953,998 'void':294,310,325,329,333,361,365,431,443,457,469,565,578 'vs':808 'want':23,182 'watcher':387 'wave':772 'work':480,812,1014 'workflow':61,886 'world':513 'worth':115 'wouldn':180 'wrap':637 'wrong':1030 'x/y':519 'x/y/z':525 'yes':446","prices":[{"id":"692837b4-1519-46b6-aa16-643508b2bc0b","listingId":"8b838430-c21a-450c-81d4-d68a383cb4fa","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jahro-console","category":"unity-agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:13.538Z"}],"sources":[{"listingId":"8b838430-c21a-450c-81d4-d68a383cb4fa","source":"github","sourceId":"jahro-console/unity-agent-skills/jahro-commands","sourceUrl":"https://github.com/jahro-console/unity-agent-skills/tree/main/skills/jahro-commands","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:13.538Z","lastSeenAt":"2026-05-18T19:07:08.917Z"}],"details":{"listingId":"8b838430-c21a-450c-81d4-d68a383cb4fa","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jahro-console","slug":"jahro-commands","github":{"repo":"jahro-console/unity-agent-skills","stars":12,"topics":["agent-skills","ai-assistant","ai-coding","claude-code","cursor","debugging","gamedev","in-game-console","jahro","logging","unity","unity-package","unity3d"],"license":"mit","html_url":"https://github.com/jahro-console/unity-agent-skills","pushed_at":"2026-03-20T15:39:45Z","description":"Agent skills for AI-assisted Unity debugging — structured logging, runtime commands, variable watching, and more","skill_md_sha":"cf8f58e826410486214799f17e94e1982fe6f848","skill_md_path":"skills/jahro-commands/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jahro-console/unity-agent-skills/tree/main/skills/jahro-commands"},"layout":"multi","source":"github","category":"unity-agent-skills","frontmatter":{"name":"jahro-commands","description":"Analyzes C# classes and generates [JahroCommand] attributes with correct syntax, RegisterObject patterns, and group organization. Use when the user wants to add runtime commands, cheats, or debug actions to Unity classes, or mentions JahroCommand, console commands, runtime cheats, or debug actions."},"skills_sh_url":"https://skills.sh/jahro-console/unity-agent-skills/jahro-commands"},"updatedAt":"2026-05-18T19:07:08.917Z"}}