Agent Skills › alamenai/terrae › issue

issue

GitHub

读取GitHub Issue并生成摘要，根据内容标签自动推断分支类型，创建并切换到对应的开发工作分支，帮助用户快速启动任务。

.claude/skills/issue/SKILL.md alamenai/terrae

Trigger Scenarios

用户提供Issue编号或URL 需要为Issue创建开发分支

Install

npx skills add alamenai/terrae --skill issue -g -y

More Options

Non-standard path

npx skills add https://github.com/alamenai/terrae/tree/main/.claude/skills/issue -g -y

Use without installing

npx skills use alamenai/terrae@issue

指定 Agent (Claude Code)

npx skills add alamenai/terrae --skill issue -a claude-code -g -y

安装 repo 全部 skill

npx skills add alamenai/terrae --all -g -y

预览 repo 内 skill

npx skills add alamenai/terrae --list

SKILL.md

Frontmatter

{
    "name": "issue",
    "description": "Read a GitHub issue, summarize it, and create a branch for it",
    "allowed-tools": "Bash(gh *), Bash(git *)"
}

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

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