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