Issue Skill

SkillDev tools

Read a GitHub issue, summarize it, and create a branch for it

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Issue Skill skill

What this skill tells your AI

The instructions your AI receives, as published by alamenai/terrae in .claude/skills/issue/SKILL.md and read by ahel’s review.

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

The user provides either:

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

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
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
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
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
Report
- Show the branch name
- Remind the user what the issue is about so they can start working

Advanced