# Issue

> Read a GitHub issue, summarize it, and create a branch for it Use when this capability is needed.

- Skill: `tomevault-io/issue` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/issue`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/issue/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/issue

---


# Issue Skill

Read a GitHub issue by number or URL, summarize it, then create a working branch.

## Repository

`alamenai/terrae` — https://github.com/alamenai/terrae/issues

## Arguments

The user provides either:

- An issue number (e.g., `42`)
- A GitHub issue URL (e.g., `https://github.com/alamenai/terrae/issues/42`)

If a URL is provided, extract the issue number from it.

## Instructions

1. **Fetch the Issue**
   - Run `gh issue view <number> --repo alamenai/terrae` to read the issue
   - If the issue doesn't exist, tell the user and stop

2. **Summarize the Issue**
   - Display the issue title and number
   - Summarize the description in 2-3 bullet points
   - List any labels
   - Note if there are linked PRs or assignees

3. **Determine Branch Name**
   - Infer the type from labels or content:
     - `bug` label or bug description → `fix/`
     - `enhancement` or `feature` label → `feat/`
     - `documentation` label → `docs/`
     - Otherwise → `feat/`
   - Build the branch name: `type/issue-number-short-description`
   - Keep the description part short (2-4 words, kebab-case)
   - Examples:
     - `feat/42-add-heatmap-component`
     - `fix/17-marker-memory-leak`
     - `docs/8-update-installation-guide`

4. **Create the Branch**
   - Make sure we're on `main` and up to date: `git checkout main && git pull`
   - Create and switch to the new branch: `git checkout -b <branch-name>`
   - Confirm the branch was created

5. **Report**
   - Show the branch name
   - Remind the user what the issue is about so they can start working

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/alamenai) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->