043-planning-github-issues - SKILL.md Agent Skill

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. Part of cursor-rules-java project license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.16.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

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.