{"id":"24140d6f-8126-4089-ae94-2b6510178204","shortId":"9zTWuG","kind":"skill","title":"043-planning-github-issues","tagline":"Use when you need the GitHub CLI (`gh`) to verify installation, list issues (all or by milestone) as markdown tables, fetch issue bodies and comments for analysis, or hand off to @014-agile-user-story when creating user stories from GitHub threads. Uses an interactive install gat","description":"# GitHub CLI — issues, milestones, and discussion for analysis\n\nUse **`gh`** to work with GitHub issues: **first** run an **interactive** check—if `gh` is not installed, **stop**, ask whether the user wants installation guidance (see the consultative pattern in **`112-java-maven-plugins`**, Maven Wrapper step), **wait** for an answer, then continue. When `gh` is available, confirm auth, list issues with optional milestone filters, render **markdown tables** from `--json` output, load **full issue bodies and comment threads** for analysis, and when the user wants user stories plus Gherkin, **chain to `@014-agile-user-story`** using issue content as source material for the interactive questionnaire.\n\n**What is covered in this Skill?**\n\n- **Interactive** install gate: ask before assuming `gh` is installed; offer https://cli.github.com/ and OS hints when the user agrees\n- Install/auth checks (`gh --version`, `gh auth status`, `gh auth login`)\n- Repository context (`--repo`, inferred from git remote)\n- Issue lists: states, limits, milestone filter, `gh issue list --json` for tabular output\n- Milestone discovery via `gh api` when titles are unknown\n- Deep reads: `gh issue view` with `--json` (body, comments) or `--comments`\n\n## Constraints\n\nDo not fabricate issue data; use only `gh` output (or explicitly agreed public REST API responses). Never print tokens or secrets.\n\n- **INTERACTIVE GATE**: If `gh` is missing, **stop**, ask whether the user wants installation guidance, **wait**—do not skip to issue listing\n- **FIRST** (after gate): Verify `gh` is available before issuing subcommands\n- **TABLES**: Prefer `--json` + markdown pipe tables for issue list summaries\n- **THREAD**: For analysis, include body and all comments (or explicitly summarize with omissions noted)\n\n## When to use this skill\n\n- gh issue list\n- List GitHub issues\n- Issues in milestone\n- GitHub CLI issues\n- gh issue view comments\n\n## Workflow\n\n1. **Run interactive install gate**\n\nCheck `gh --version`; if missing, stop and ask whether the user wants installation guidance before any issue operations.\n\n2. **Verify authentication and repository context**\n\nConfirm `gh auth status`, authenticate if needed, and establish target repository context via `--repo` or git remote.\n\n3. **List issues and milestones**\n\nRetrieve issues (optionally by milestone/state) using `gh issue list --json` and present summaries as markdown pipe tables.\n\n4. **Load full thread for analysis**\n\nRead issue body and all comments via `gh issue view --json` or `--comments`, then provide evidence-based analysis.\n\n5. **Chain to user story workflow when requested**\n\nWhen user asks for user stories and Gherkin from issues, hand off to `@014-agile-user-story` using GitHub-sourced content.\n\n## Reference\n\nFor detailed guidance, examples, and constraints, see [references/043-planning-github-issues.md](references/043-planning-github-issues.md).","tags":["043","planning","github","issues","cursor","rules","java","jabrena","agent-skills","ai-skills","claude","claude-code"],"capabilities":["skill","source-jabrena","skill-043-planning-github-issues","topic-agent-skills","topic-ai-skills","topic-claude","topic-claude-code","topic-claude-code-skills","topic-claude-code-subagents","topic-claude-skills","topic-cursor-agent","topic-cursor-ai","topic-cursor-skills","topic-cursorai","topic-github-copilot"],"categories":["cursor-rules-java"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jabrena/cursor-rules-java/043-planning-github-issues","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jabrena/cursor-rules-java","source_repo":"https://github.com/jabrena/cursor-rules-java","install_from":"skills.sh"}},"qualityScore":"0.631","qualityRationale":"deterministic score 0.63 from registry signals: · indexed on github topic:agent-skills · 362 github stars · SKILL.md body (2,910 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-26T18:53:40.206Z","embedding":null,"createdAt":"2026-04-18T22:01:48.552Z","updatedAt":"2026-04-26T18:53:40.206Z","lastSeenAt":"2026-04-26T18:53:40.206Z","tsv":"'014':37,144,446 '043':1 '1':332 '112':92 '2':355 '3':378 '4':400 '5':425 'agil':39,146,448 'agile-user-stori':38,145,447 'agre':182,245 'analysi':32,61,132,298,405,424 'answer':103 'api':217,248 'ask':80,168,262,344,435 'assum':170 'auth':111,188,191,363 'authent':357,365 'avail':109,282 'base':423 'bodi':28,127,229,300,408 'chain':142,426 'check':73,184,337 'cli':12,55,325 'cli.github.com':175 'comment':30,129,230,232,303,330,411,418 'confirm':110,361 'constraint':233,462 'consult':89 'content':151,455 'context':194,360,372 'continu':105 'cover':161 'creat':43 'data':238 'deep':222 'detail':458 'discoveri':214 'discuss':59 'establish':369 'evid':422 'evidence-bas':421 'exampl':460 'explicit':244,305 'fabric':236 'fetch':26 'filter':117,205 'first':69,276 'full':125,402 'gat':53 'gate':167,256,278,336 'gh':13,63,75,107,171,185,187,190,206,216,224,241,258,280,315,327,338,362,389,413 'gherkin':141,440 'git':198,376 'github':4,11,47,54,67,319,324,453 'github-sourc':452 'guidanc':86,268,350,459 'hand':34,443 'hint':178 'includ':299 'infer':196 'instal':16,52,78,85,166,173,267,335,349 'install/auth':183 'interact':51,72,157,165,255,334 'issu':5,18,27,56,68,113,126,150,200,207,225,237,274,284,293,316,320,321,326,328,353,380,384,390,407,414,442 'java':94 'java-maven-plugin':93 'json':122,209,228,288,392,416 'limit':203 'list':17,112,201,208,275,294,317,318,379,391 'load':124,401 'login':192 'markdown':24,119,289,397 'materi':154 'maven':95,97 'mileston':22,57,116,204,213,323,382 'milestone/state':387 'miss':260,341 'need':9,367 'never':250 'note':309 'offer':174 'omiss':308 'oper':354 'option':115,385 'os':177 'output':123,212,242 'pattern':90 'pipe':290,398 'plan':3 'planning-github-issu':2 'plugin':96 'plus':140 'prefer':287 'present':394 'print':251 'provid':420 'public':246 'questionnair':158 'read':223,406 'refer':456 'references/043-planning-github-issues.md':464,465 'remot':199,377 'render':118 'repo':195,374 'repositori':193,359,371 'request':432 'respons':249 'rest':247 'retriev':383 'run':70,333 'secret':254 'see':87,463 'skill':164,314 'skill-043-planning-github-issues' 'skip':272 'sourc':153,454 'source-jabrena' 'state':202 'status':189,364 'step':99 'stop':79,261,342 'stori':41,45,139,148,429,438,450 'subcommand':285 'summar':306 'summari':295,395 'tabl':25,120,286,291,399 'tabular':211 'target':370 'thread':48,130,296,403 'titl':219 'token':252 'topic-agent-skills' 'topic-ai-skills' 'topic-claude' 'topic-claude-code' 'topic-claude-code-skills' 'topic-claude-code-subagents' 'topic-claude-skills' 'topic-cursor-agent' 'topic-cursor-ai' 'topic-cursor-skills' 'topic-cursorai' 'topic-github-copilot' 'unknown':221 'use':6,49,62,149,239,312,388,451 'user':40,44,83,136,138,147,181,265,347,428,434,437,449 'verifi':15,279,356 'version':186,339 'via':215,373,412 'view':226,329,415 'wait':100,269 'want':84,137,266,348 'whether':81,263,345 'work':65 'workflow':331,430 'wrapper':98","prices":[{"id":"7a29ab67-0b51-4979-9427-c2ee5fbe9c76","listingId":"24140d6f-8126-4089-ae94-2b6510178204","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jabrena","category":"cursor-rules-java","install_from":"skills.sh"},"createdAt":"2026-04-18T22:01:48.552Z"}],"sources":[{"listingId":"24140d6f-8126-4089-ae94-2b6510178204","source":"github","sourceId":"jabrena/cursor-rules-java/043-planning-github-issues","sourceUrl":"https://github.com/jabrena/cursor-rules-java/tree/main/skills/043-planning-github-issues","isPrimary":false,"firstSeenAt":"2026-04-18T22:01:48.552Z","lastSeenAt":"2026-04-26T18:53:40.206Z"}],"details":{"listingId":"24140d6f-8126-4089-ae94-2b6510178204","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jabrena","slug":"043-planning-github-issues","github":{"repo":"jabrena/cursor-rules-java","stars":362,"topics":["agent-skills","ai-skills","claude","claude-code","claude-code-skills","claude-code-subagents","claude-skills","cursor-agent","cursor-ai","cursor-skills","cursorai","github-copilot","intellij-idea","java","prompting","system-prompts"],"license":"apache-2.0","html_url":"https://github.com/jabrena/cursor-rules-java","pushed_at":"2026-04-26T13:48:39Z","description":"A curated and opinionated collection of Skills and Agents to be used in modern SDLC workflows for Java Enterprise development with your favorite AI Agent harness.","skill_md_sha":"8160d57275a4c5c58df9b39262d2f85663bc6012","skill_md_path":"skills/043-planning-github-issues/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jabrena/cursor-rules-java/tree/main/skills/043-planning-github-issues"},"layout":"multi","source":"github","category":"cursor-rules-java","frontmatter":{"name":"043-planning-github-issues","license":"Apache-2.0","description":"Use when you need the GitHub CLI (`gh`) to verify installation, list issues (all or by milestone) as markdown tables, fetch issue bodies and comments for analysis, or hand off to @014-agile-user-story when creating user stories from GitHub threads. Uses an interactive install gate — if `gh` is missing, ask whether to show installation guidance before any issue commands. This should trigger for requests such as gh issue list; List GitHub issues; Issues in milestone; GitHub CLI issues; gh issue view comments. Part of cursor-rules-java project"},"skills_sh_url":"https://skills.sh/jabrena/cursor-rules-java/043-planning-github-issues"},"updatedAt":"2026-04-26T18:53:40.206Z"}}