Back to Skills

ghe-claim

CLAIM a specific GitHub issue to START working on it. Requires an issue number. Performs validation, atomic claim, posts claim comment, and sets up worktree.USE THIS SKILL WHEN:- User says "claim issue #N" or "claim #N"- User says "start working on issue #N" or "take issue #N"- User says "I'll work on #N" or "pick up #N"- User wants to BEGIN work on a specific issue number- User selected an issue from available work and wants to claim itREQUIRED: An issue number must be specified or identifiable

4starsUpdated 3/7/2026

Security Assessment

Safe(100/100)
Security Score100/100

About ghe-claim

The 'ghe-claim' skill is designed to help users claim a specific GitHub issue and start working on it. This process involves validating the issue's current state, claiming it by posting a comment, and setting up a worktree for the user. The skill automates the process of validating the issue's readiness and ensuring that the user has permission to work on it, streamlining the workflow for those beginning work on a new task. It ensures that no issues are overlooked or claimed incorrectly, preventing any overlap or conflicts in the project workflow.

Key features of 'ghe-claim' include automatic validation of the issue's state through a phase-gate, ensuring that the issue is ready to be worked on, unassigned, and follows the correct phase order. The skill also ensures that no other threads are open for the same epic. It can automatically set up a Git worktree for the user if configured to do so. The skill integrates with the GitHub issue management system, offering a smooth transition from issue selection to claim, providing clarity and consistency in the project management process.

The 'ghe-claim' skill is primarily used by developers and teams managing tasks on GitHub. It is ideal for users who need to start working on an issue and need an automated process to claim it and ensure all prerequisites are met. This skill is useful for those handling multiple issues, ensuring that work is started in a structured and methodical way, without conflicts or issues being left unassigned.

FAQ

What happens if no issue number is provided?

The skill will not execute without a specific issue number. An issue number must be provided for the skill to function.

Can I use 'ghe-claim' if I just want to check the status of an issue?

No, 'ghe-claim' is used for claiming issues and starting work on them. For status checks, use the 'ghe-status' skill.

Can 'ghe-claim' work with issues already assigned?

No, the skill will only claim issues that are not already assigned.

How does 'ghe-claim' handle worktree setup?

If the setting 'auto_worktree' is enabled, the skill will automatically create a Git worktree for the user when claiming the issue.

Is 'ghe-claim' compatible with all GitHub repositories?

Yes, the skill is designed to work with any GitHub repository, but the repository must follow the necessary phase and labeling conventions for validation to succeed.

Install ghe-claim

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill