021-tooling-github
GitHub CLI — issues, milestones, and discussion for analysis
Use 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.
What is covered in this Skill?
- Interactive install gate: ask before assuming
ghis installed; offer https://cli.github.com/ and OS hints when the user agrees - Install/auth checks (
gh --version,gh auth status,gh auth login) - Repository context (
--repo, inferred from git remote) - Issue lists: states, limits, milestone filter,
gh issue list --jsonfor tabular output - Milestone discovery via
gh apiwhen titles are unknown - Deep reads:
gh issue viewwith--json(body, comments) or--comments
Constraints
Do not fabricate issue data; use only gh output (or explicitly agreed public REST API responses). Never print tokens or secrets.