Agent skill

Gh Issues

by serejaris in serejaris/personal-corp-os

A skill your agent uses when creating, searching, updating, or managing GitHub issues via CLI.

MITAuto-check passedAgent Workflows

Install Gh Issues

skills CLI
$ npx skills add serejaris/personal-corp-os --skill gh-issues -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install serejaris/personal-corp-os gh-issues --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/serejaris/personal-corp-os.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gh-issues .claude/skills/gh-issues && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gh-issues
GitHub stars
229
Token cost
~1.8k tokens
SKILL.md length
317 words
Files
5 (incl. references, assets)
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when creating, searching, updating, or managing GitHub issues via CLI.

  • Works in 10 steps: Quick Reference → JSON Output → Search Filters → …
  • Managing GitHub issues via CLI
  • SKILL.md covers Table of Contents, Quick Reference, JSON Output Patterns and Advanced Search Filters, plus 7 more sections
  • Calls gh and git

What it does

Gh Issues is an agent skill from serejaris/personal-corp-os. Use when creating, searching, updating, or managing GitHub issues via CLI. Triggers: "issue", "create issue", "gh issue", "task tracking", "context", "handoff", "resume task", "session context", "save progress", "active tasks", "in-progress", "my tasks", "open issues". Covers: gh commands, bulk operations, JSON/jq, search filters, issue-to-PR workflow, AI session context storage, task workflow with labels.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files and assets (for example `README.md`, `README.ru.md` and `references/context-template.md`).

It sits in Agent Workflows, covering Session handoff, Task management and Project management. It works with GitHub. The repository describes itself as: Personal Corp OS — управление личной компанией через AI-агентов: задачи вне головы, отделы вместо памяти, недельное ретро. Открытые скиллы для Claude Code и Codex. The licence is MIT.

When your agent uses it

  • Managing GitHub issues via CLI
  • Tasks that involve Session handoff
  • Tasks that involve Task management

Example prompts

  • “create issue”
  • “gh issue”
  • “task tracking”
  • “/gh-issues”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. Quick Reference
  2. JSON Output
  3. Search Filters
  4. Bulk Operations
  5. Issue to PR Workflow
  6. Milestones
  7. AI Session Context
  8. Task Workflow
  9. Examples
  10. Common Mistakes

What it can do on your machine

Read from SKILL.md and the folder at commit 95e36c3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gh Issues loads about 1.8k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 317 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from serejaris/personal-corp-os at commit 95e36c3, republished under its MIT licence (© serejaris). 317 words, ~1,803 tokens.

Download SKILL.mdSave it as .claude/skills/gh-issues/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
gh-issues
description
Use when creating, searching, updating, or managing GitHub issues via CLI. Triggers: "issue", "create issue", "gh issue", "task tracking", "context", "handoff", "resume task", "session context", "save progress", "active tasks", "in-progress", "my tasks", "open issues". Covers: gh commands, bulk operations, JSON/jq, search filters, issue-to-PR workflow, AI session context storage, task workflow with labels.

GitHub Issues CLI

Efficient GitHub Issues management via gh CLI with AI session context storage.

Table of Contents

  1. Quick Reference
  2. JSON Output
  3. Search Filters
  4. Bulk Operations
  5. Issue to PR Workflow
  6. Milestones
  7. AI Session Context
  8. Task Workflow
  9. Examples
  10. Common Mistakes

Quick Reference

TaskCommand
Create issuegh issue create -t "Title" -b "Body" -l bug -a @me
Active tasksgh issue list -l in-progress -s open
List open bugsgh issue list -l bug -s open
View as JSONgh issue view 123 --json number,title,body,labels,state
Close with commentgh issue close 123 -c "Fixed in #456"
Edit labelsgh issue edit 123 --add-label priority:high
Start workgh issue edit 45 --add-label in-progress
Create branchgh issue develop 123 --checkout
Load contextgh issue view 45 --json comments --jq '.comments[] | select(.body | contains("AI-CONTEXT"))'

JSON Output Patterns

Always use --json for parsing. Fields: number, title, body, state, labels, assignees, milestone, author, createdAt, updatedAt, comments, url.

bash
gh issue view 123 --json number,title,labels,state
gh issue list --json number,title,labels --jq '.[] | select(.labels[].name == "bug")'
gh issue list -l bug --json number --jq '.[].number'

Advanced Search Filters

bash
gh issue list --search "is:open author:username"
gh issue list --search "created:>=2026-01-01 created:<=2026-01-07"
gh issue list --search "label:bug label:priority:high"
gh issue list --search "is:open -label:wontfix"
gh issue list --search "milestone:v2.0"

Bulk Operations

bash
gh issue edit 10 15 20 --add-label "priority:high"
gh issue close 10 15 20 -c "Duplicate of #5"
gh issue list -l needs-triage --json number --jq '.[].number' | \
  xargs -I{} gh issue edit {} --add-label reviewed

Issue to PR Workflow

bash
gh issue develop 123 --checkout          # Create branch from issue
git add . && git commit -m "fix: #123"   # Commit with reference
gh pr create --fill                       # Create PR (auto-links)
gh issue close 123 -c "Fixed in PR #456" # Close when merged

Milestones via API

bash
gh api repos/:owner/:repo/milestones --jq '.[].title'
gh issue edit 123 -m "v2.0"

AI Session Context

Store session context in GitHub issues for seamless task handoff.

Read Context
bash
# Get AI context from issue comments
gh issue view 45 --json comments --jq '
  .comments[] | select(.body | contains("AI-CONTEXT:START")) | .body
'

# Get comment ID for updates
gh issue view 45 --json comments --jq '
  .comments[] | select(.body | contains("AI-CONTEXT:START")) | .id
'
Save Context
bash
# Create new context comment
gh issue comment 45 --body-file .ai-context.md

# Update existing (replace COMMENT_ID)
gh api repos/:owner/:repo/issues/comments/COMMENT_ID \
  --method PATCH -f body="$(cat .ai-context.md)"
Context Template

See references/context-template.md for full template. Minimal version:

markdown
<!-- AI-CONTEXT:START -->
## Context | IN_PROGRESS
**Files:** `file.py:45`, `other.py:120`
**Done:** task1, task2
**Next:** next task
**Resume:** One-line summary for cold start
<!-- AI-CONTEXT:END -->
Workflow
  1. Start work — load context from issue
  2. Work on task — track progress mentally
  3. Pause/Stop — save context to issue comment
  4. Resume later — load context, continue

Task Workflow

Manage issue lifecycle with labels.

Labels
LabelMeaning
backlogIn queue
in-progressActive work
blockedBlocked
reviewNeeds review
View Active Tasks
bash
# My active issues
gh issue list -l in-progress -s open

# All my assigned issues
gh issue list --assignee @me -s open

# Issues with context
gh issue list -s open --json number,title,labels --jq '
  .[] | select(.labels[].name == "in-progress") | "#\(.number): \(.title)"
'
Start Working
bash
# Mark as in-progress
gh issue edit 45 --add-label in-progress --remove-label backlog

# View issue + load context
gh issue view 45 --json number,title,body,comments --jq '{
  number, title, body,
  context: (.comments[] | select(.body | contains("AI-CONTEXT")) | .body) // "No context"
}'
Pause/Block
bash
# Mark as blocked
gh issue edit 45 --add-label blocked --remove-label in-progress

# Add blocking comment
gh issue comment 45 --body "Blocked: waiting for API access"
Complete
bash
# Close with comment
gh issue close 45 -c "Done in commit abc123"

# Or close via PR (auto-closes if PR body contains "Fixes #45")

Examples

Create Issue for Task
bash
gh issue create -t "Simplify bot flow" -b "## Problem
Bot stopped converting. Current flow is complex.

## Reference
Simple flow example from competitor.

## Tasks
- [ ] Analyze current flow
- [ ] Create new diagram
- [ ] Implement"
Start Working on Issue
bash
# 1. View issue with context
gh issue view 45 --json number,title,body,comments --jq '{
  number, title, body,
  context: (.comments[] | select(.body | contains("AI-CONTEXT")) | .body) // "No context"
}'

# 2. Create branch
gh issue develop 45 --checkout

# 3. Work...
Save Progress Before Stopping
bash
# Create context file
cat > .ai-context.md << 'EOF'
<!-- AI-CONTEXT:START -->
## AI Session Context
_Last updated: 2026-01-07 16:00_

### Status
**IN_PROGRESS**

### Progress
- [x] Analyzed current flow
- [ ] Create new diagram

### Key Files
- `handlers/start.py:45-78` — start handler
- `data/courses.yaml` — config

### Next Steps
1. Draw simplified flow
2. Implement changes

### Resume Context
Simplifying bot flow. Analyzed current state. Next: create diagram.
<!-- AI-CONTEXT:END -->
EOF

# Save to issue
gh issue comment 45 --body-file .ai-context.md
Resume Work
bash
# Load context
CONTEXT=$(gh issue view 45 --json comments --jq '
  .comments[] | select(.body | contains("AI-CONTEXT")) | .body
' 2>/dev/null)

echo "$CONTEXT"
# Continue from where you left off...

Common Mistakes

MistakeFix
Missing --jsonAlways --json field1,field2
Loop instead of multi-arggh issue edit 1 2 3
Using grep on outputUse --jq
Forgot -s all for closedDefault is open only
{owner}/{repo} in APIUse :owner/:repo
Duplicate context commentsUpdate existing, don't create new

© serejaris, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references, assets) in skills/gh-issues of serejaris/personal-corp-os.

  • SKILL.md
  • README.md
  • README.ru.md
  • assets/illustration.png
  • references/context-template.md

Open the folder on GitHubat commit 95e36c3

Compare with similar skills

Gh Issues next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gh Issues compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gh Issues this skillserejaris/personal-corp-os229—~1.8kAutomated safety check: PassMIT
Beadsmatthiasn/lotti1.2k—~589Automated safety check: PassGPL-3.0
Swarm Coordinationdralgorhythm/claude-agentic-framework125—~1.6kAutomated safety check: PassNone
Requirement Ledger Workflowadand-91/gpt-6-astra-skill125—~6.3kAutomated safety check: PassMIT
Gh Issuestrpc-group/trpc-agent-go1.8k8 repos~8.7kAutomated safety check: PassApache-2.0
Integration Orchestratorrampstackco/claude-skills940—~5.3kAutomated safety check: PassMIT

Similar skills

  • Beads

    matthiasn/lotti

    A skill your agent uses for authorized Lotti maintainer work that needs private durable task tracking, issue dependencies, blocker management, multi-session handoff, or shared agent memory.

    1.2k GitHub stars~589 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Swarm Coordination

    dralgorhythm/claude-agentic-framework

    Rules for several agents sharing one repository: an orchestrator tracks work in two tiers, workers write to scratch files, and every handoff leaves a pointer to an artifact.

    125 GitHub stars~1.6k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Requirement Ledger Workflow

    adand-91/gpt-6-astra-skill

    Takes over one selected project on request, reports progress in a fixed Chinese-language format, and runs bounded reviews, handoffs and verifications from explicit sources.

    125 GitHub stars~6.3k tokensUpdated 23 days ago
    Agent WorkflowsAuto-check passed
  • Gh Issues

    trpc-group/trpc-agent-go

    Fetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments.

    1.8k GitHub starsUsed in 8 repos~8.7k tokens
    Agent WorkflowsAuto-check passed
  • Integration Orchestrator

    rampstackco/claude-skills

    Generate a phased delivery orchestration plan for creative-direction-driven work: which skills run when, what locks at which gate, how handoffs occur, and how the cadence implements in the team's…

    940 GitHub stars~5.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Vibe Kanban

    aiskillstore/marketplace

    Manage AI coding agents on a visual Kanban board. An agent skill from aiskillstore/marketplace.

    430 GitHub stars~4.4k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

More from serejaris/personal-corp-os

All 36 skills in this repo
  • Weekly Planning

    serejaris/personal-corp-os

    A skill your agent uses when the user is transitioning from a completed retro into a weekly plan, choosing weekly outcomes, scheduling a full ISO week, or asking for "план на неделю", "weekly…

    229 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Product Data Audit

    serejaris/personal-corp-os

    A skill your agent uses when auditing a product, business, or project ecosystem — analyzing data sources, decision loops, bottlenecks, and implementation contours.

    229 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Tg Bot Ops

    serejaris/personal-corp-os

    A skill your agent uses when operating, debugging, deploying, or monitoring a Telegram bot or Telegram-to-agent gateway.

    229 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check: notes
  • Audit Agent Rules

    serejaris/personal-corp-os

    Audits the agent rules in the current folder (AGENTS.md, nested AGENTS.md files) and the skill descriptions the agent sees at start, then reports what to cut, move or rewrite and edits only after…

    229 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Make Landing

    serejaris/personal-corp-os

    Создаёт несколько вариантов дизайна 2D-поверхности (лендинг, герой, обложка, слайды): свой визуальный референс и автор на вариант, полный design.md с UTC/SHA-256 до кода, проверка в браузере…

    229 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Safe Public Release

    serejaris/personal-corp-os

    A skill your agent uses when publishing, open-sourcing, exporting, sanitizing, or moving code, agent skills, prompts, templates, fixtures, datasets, workshop assets, or other artifacts from a…

    229 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check: notes

Works with

Questions about Gh Issues

What does Gh Issues do?

A skill your agent uses when creating, searching, updating, or managing GitHub issues via CLI. Gh Issues is an agent skill from serejaris/personal-corp-os. Use when creating, searching, updating, or managing GitHub issues via CLI.

When should I use Gh Issues?

Gh Issues fits situations like: managing GitHub issues via CLI; tasks that involve Session handoff; tasks that involve Task management.

How do I install Gh Issues in Claude Code?

Run `npx skills add serejaris/personal-corp-os --skill gh-issues -a claude-code`. Or copy the skill folder (skills/gh-issues in serejaris/personal-corp-os) into .claude/skills/gh-issues in your project. Claude Code loads it when a task matches its description.

How do I install Gh Issues in Codex?

Run `npx skills add serejaris/personal-corp-os --skill gh-issues -a codex`. Or copy the skill folder (skills/gh-issues in serejaris/personal-corp-os) into .agents/skills/gh-issues in your project. Codex loads it when a task matches its description.

Can I use Gh Issues in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add serejaris/personal-corp-os --skill gh-issues -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gh-issues, .gemini/skills/gh-issues, .github/skills/gh-issues and .opencode/skills/gh-issues in your project.

What does Gh Issues need to run?

Going by SKILL.md and its folder, Gh Issues needs the command-line tools its instructions call (gh and git).

Does Gh Issues access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Gh Issues safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gh Issues use?

Gh Issues is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gh Issues use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 549 tokens, read only when the agent opens those files.

What are the alternatives to Gh Issues?

Skills that share tags, products or a category with Gh Issues: Beads (matthiasn/lotti, 1.2k stars), Swarm Coordination (dralgorhythm/claude-agentic-framework, 125 stars), Requirement Ledger Workflow (adand-91/gpt-6-astra-skill, 125 stars) and Gh Issues (trpc-group/trpc-agent-go, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gh Issues?

serejaris (a GitHub user) maintains it in serejaris/personal-corp-os, which has 229 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 7, 2026.

Source: serejaris/personal-corp-os on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.