| name | 043-planning-github-issues |
| description | Use when you need GitHub CLI (`gh`) installation/authentication guidance and a sanitized GitHub issue inventory workflow. The agent does not ingest GitHub issue or milestone output directly; it asks the user for sanitized issue summaries before analysis or @014-agile-user-story handoff. This should trigger for requests such as GitHub issue summary workflow; GitHub CLI setup for issues; Prepare sanitized GitHub issue inventory; Analyze GitHub issues with gh CLI; Summarize milestones and issue discussions safely. Part of Plinth Toolkit |
| license | Apache-2.0 |
| metadata | {"author":"Juan Antonio Breña Moral","version":"0.17.0"} |
GitHub CLI — issues, milestones, and discussion for analysis
Use gh only for installation/authentication guidance. The agent must not ingest GitHub issue or milestone output directly. For requirements analysis, ask the user to provide a sanitized issue inventory or summary in their own words. When the user wants user stories plus Gherkin, chain to @014-agile-user-story using sanitized issue context as source material for the interactive questionnaire.
What is covered in this Skill?
- Interactive install gate: ask before assuming
gh is 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)
- Operator-prepared issue inventories summarized outside the agent context
- Sanitized GitHub issue inventories supplied by the user
- Sanitized GitHub issue summaries supplied by the user for requirement analysis
Constraints
Do not fabricate issue data; use only sanitized user-provided summaries for issue context. Never print tokens or secrets.
- INTERACTIVE GATE: If
gh is missing, stop, ask whether the user wants installation guidance, wait—do not skip to issue listing
- FIRST (after gate): Verify
gh availability only for setup guidance; do not ingest issue or milestone command output
- NO DIRECT ISSUE INGESTION: Use sanitized user summaries only; do not bring issue, milestone, body, or comment exports into the agent context
- SANITIZED INVENTORY: Ask the user to provide sanitized issue summaries before analysis or handoff
When to use this skill
- GitHub issue summary workflow
- GitHub CLI setup for issues
- Prepare sanitized GitHub issue inventory
- Analyze GitHub issues with gh CLI
- Summarize milestones and issue discussions safely
Workflow
- Run interactive install gate
Check gh --version; if missing, stop and ask whether the user wants installation guidance before any issue operations.
- Explain authentication and repository context
Explain how the user can verify gh auth status and repository context locally. Keep issue and milestone exports outside the agent context.
- Request sanitized issue inventory
Ask the user to prepare a sanitized issue inventory outside the agent context. They should paste only a maintainer-written summary, not raw issue or milestone output.
- Request sanitized issue context for analysis
Do not retrieve GitHub issue, milestone, body, or comment data. Ask the user for sanitized summaries of the relevant issue context and note that raw GitHub exports were not ingested.
- Chain to user story workflow when requested
When user asks for user stories and Gherkin from issues, hand off to @014-agile-user-story using only user-provided sanitized GitHub issue summaries.
Reference
For detailed guidance, examples, and constraints, see references/043-planning-github-issues.md.
