gh-read-issue-context

Retrieve GitHub issue metadata, comments, labels, and linked PRs via gh.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/mvillmow/ProjectOdyssey --skill gh-read-issue-context
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-read-issue-context
Source: https://github.com/mvillmow/ProjectOdyssey/tree/main/.claude/skills/gh-read-issue-context
Command: npx skills add https://github.com/mvillmow/ProjectOdyssey --skill gh-read-issue-context

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq.

What problem does it solve?

Manually gathering all relevant information (issue body, comments, linked PRs, labels) from a GitHub issue before starting work is time-consuming and can lead to missed context.

Core Features & Use Cases

  • Comprehensive Context Retrieval: Retrieves all details from a GitHub issue, including its body, comments, labels, assignees, and linked pull requests.
  • Keyword Parsing: Helps parse comments for keywords like "design decision" or "blocker" to quickly extract critical information.
  • Use Case: Before starting implementation on a new feature, use this skill to quickly read all prior discussions, design decisions, and acceptance criteria from the associated GitHub issue.

Quick Start

Use the gh-read-issue-context skill to view all details and comments for GitHub issue #123.

Frequently Asked Questions about gh-read-issue-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve all comments and context from a GitHub issue before starting work?

Retrieving GitHub issue context compiles issue details, comments, labels, assignees, linked PRs, and timeline into structured JSON output. Use gh-read-issue-context to extract this data via the gh CLI, exposing fields needed for downstream parsing and implementation decisions without manually gathering scattered information.

Can I extract design decisions and blockers from GitHub issue discussions?

Yes. The Skill parses issue body, comments, and metadata to surface critical information like design decisions and blockers. Combined with keyword parsing, you can quickly identify key constraints and prior discussions from all comments and linked context.

What information does gh issue view expose for automation workflows?

The gh CLI exposes issue metadata including title, body, comments, labels, assignees, milestone, state, and linked pull requests. This structured JSON output feeds directly into documentation, analysis, or downstream automation tools that require comprehensive issue context.

How do I access linked pull requests and timeline history from an issue?

GitHub issue context retrieval includes related data like linked PRs and timeline events alongside the core issue metadata. The Skill compiles these via gh issue view, providing full relational context for understanding prior work and design rationale.

Can I use this with GitHub automation and CI/CD workflows?

Yes. The Skill requires only gh and jq, both standard in GitHub Actions and command-line environments. JSON output integrates cleanly into scripts, automation workflows, and documentation pipelines that need structured issue data.

What's the best way to avoid missing context when resuming work on an issue?

Retrieving full issue context systematically captures all prior discussions, decisions, and linked work in one operation. This prevents gaps when returning to a task after a break and ensures implementation decisions align with documented requirements and constraints.