Agent skill

Gh Issue Specifier

by POW-Software in POW-Software/ByteSync

Analyze a GitHub issue in depth and produce a detailed specification based on codebase analysis.

MITAuto-check passedDevelopment

Install Gh Issue Specifier

skills CLI
$ npx skills add POW-Software/ByteSync --skill gh-issue-specifier -a claude-code

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

GitHub CLI
$ gh skill install POW-Software/ByteSync gh-issue-specifier --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/POW-Software/ByteSync.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gh-issue-specifier .claude/skills/gh-issue-specifier && 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-issue-specifier
GitHub stars
172
Token cost
~643 tokens
SKILL.md length
308 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Analyze a GitHub issue in depth and produce a detailed specification based on codebase analysis.

  • Given a GitHub issue URL
  • SKILL.md covers Overview, Workflow, Required Spec Format and Operational Notes, plus 1 more section
  • Calls gh
  • Number and asked to deeply analyze requirements

What it does

Gh Issue Specifier is an agent skill from POW-Software/ByteSync. Analyze a GitHub issue in depth and produce a detailed specification based on codebase analysis. Use when given a GitHub issue URL or number and asked to deeply analyze requirements, scan the repository, and write a structured spec (no code changes).

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Codebase onboarding. It works with GitHub. The repository describes itself as: ByteSync is a free and open-source tool for file synchronization, backup, and deduplication. It works locally or remotely, with no VPNs or firewall configuration required… The licence is MIT.

When your agent uses it

  • Given a GitHub issue URL
  • Number and asked to deeply analyze requirements
  • Scan the repository
  • Write a structured spec (no code changes)

Example prompts

  • “/gh-issue-specifier”

What it can do on your machine

Read from SKILL.md and the folder at commit 397a1d1. 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

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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 Issue Specifier loads about 643 tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 308 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~643

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 POW-Software/ByteSync at commit 397a1d1, republished under its MIT licence (© POW-Software). 308 words, ~643 tokens.

Download SKILL.mdSave it as .claude/skills/gh-issue-specifier/SKILL.md (or your agent's skills folder).
name
gh-issue-specifier
description
Analyze a GitHub issue in depth and produce a detailed specification based on codebase analysis. Use when given a GitHub issue URL or number and asked to deeply analyze requirements, scan the repository, and write a structured spec (no code changes).

Gh Issue Specifier

Overview

Build a deep, code-informed specification from a GitHub issue using gh CLI and targeted repository analysis. Ask clarifying questions when needed, then deliver a structured, implementation-ready spec.

Workflow

  1. Parse the issue target
  • Accept a full GitHub issue URL or an issue number.
  • Resolve owner/repo from the URL when provided.
  • If only a number is provided, ask which repo to use.
  1. Fetch issue details via gh
  • Always use gh issue view <number> --repo <owner>/<repo>.
  • Capture title, body, labels, and comments.
  1. Scan the codebase deeply
  • Use rg for fast discovery (types, references, UI strings, tests, configs).
  • Open and read relevant files with Get-Content.
  • Trace the end-to-end flow: entry points -> services -> domain -> storage -> UI.
  • Identify existing validations, error handling, localization, and logging patterns.
  1. Identify gaps and impacts
  • What is missing relative to the issue requirements?
  • Which modules and layers must change?
  • What new tests are required and where?
  • Identify risk areas and backward compatibility issues.
  1. Ask clarifying questions when needed
  • Ask only the minimum set of questions to disambiguate scope, UX, or behavior.
  • If no questions are needed, proceed directly to the spec.
  1. Produce the specification
  • Provide a clear, structured spec with concrete behaviors and impacted areas.
  • Do not propose code or patches.

Required Spec Format

Include these sections in order:

  • Summary
  • Scope (In/Out)
  • Functional Requirements
  • Non-Functional Requirements
  • UX / Messaging / Localization
  • Logging / Telemetry
  • Edge Cases / Error Handling
  • Affected Components (files/areas)
  • Test Plan (unit/integration/e2e)
  • Migration / Compatibility (if applicable)
  • Open Questions
  • Risks

Operational Notes

  • Always use gh issue view (no browser).
  • Always use rg for discovery before opening files.
  • Prefer short file excerpts and paraphrase; avoid pasting large blocks.
  • Keep the spec actionable and grounded in the current codebase.

Example Trigger Phrases

  • "Analyze issue 260 and write a detailed spec"
  • "Deeply analyze this GitHub issue and the codebase"
  • "Create a specification from https://github.com/<org>/<repo>/issues/<id>"

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

Files

Just SKILL.md in skills/gh-issue-specifier of POW-Software/ByteSync.

Open the folder on GitHubat commit 397a1d1

Compare with similar skills

Gh Issue Specifier 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 Issue Specifier compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gh Issue Specifier this skillPOW-Software/ByteSync172—~643Automated safety check: PassMIT
GitDiagram Repository Overviewahmedkhaleel2004/gitdiagram18k—~427Automated safety check: PassMIT
GitDiagram Repo Architectureahmedkhaleel2004/gitdiagram18k—~429Automated safety check: PassMIT
Octocode Code Researchbgauryy/octocode949—~1.5kAutomated safety check: PassMIT
Releaseyoanbernabeu/grepai1.9k—~918Automated safety check: PassMIT
BTCA Local Repo Searchstickerdaniel/linkedin-mcp-server3.8k—~660Automated safety check: PassApache-2.0

Similar skills

  • GitDiagram Repository Overview

    ahmedkhaleel2004/gitdiagram

    Explains the architecture of a public GitHub repository through GitDiagram: how the code is organized, the main components with paths, and a Mermaid diagram.

    18k GitHub stars~427 tokensUpdated today
    DevelopmentAuto-check passed
  • GitDiagram Repo Architecture

    ahmedkhaleel2004/gitdiagram

    Explains how a public GitHub repository is built by fetching its GitDiagram architecture diagram, components and optional explainer video.

    18k GitHub stars~429 tokensUpdated today
    DevelopmentAuto-check passed
  • Octocode Code Research

    bgauryy/octocode

    Researches code with evidence: traces callers, imports and cross-repo links, diagnoses failures and reports findings with exact file and line references and a confidence label.

    949 GitHub stars~1.5k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Release

    yoanbernabeu/grepai

    Create a new release for grepai. An agent skill from yoanbernabeu/grepai.

    1.9k GitHub stars~918 tokensUpdated 17 days ago
    DevelopmentAuto-check passed
  • BTCA Local Repo Search

    stickerdaniel/linkedin-mcp-server

    Searches git repositories cloned locally under a sandbox folder to answer questions with cited links and complete code snippets.

    3.8k GitHub stars~660 tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Walks through reserving a directory for a team in the Databricks CLI repo and wiring GitHub CODEOWNERS so that team's approvals are required for its area.

    404 GitHub stars~851 tokensUpdated today
    DevelopmentAuto-check: notes

More from POW-Software/ByteSync

  • Create PR

    POW-Software/ByteSync

    Push the current branch and create a Pull Request for ByteSync.

    172 GitHub stars~327 tokensUpdated 5 mo ago
    Auto-check passed
  • Perform Implement Plan

    POW-Software/ByteSync

    Execute an implementation plan end-to-end in the ByteSync repo.

    172 GitHub stars~426 tokensUpdated 5 mo ago
    Auto-check passed
  • Implementation Plan

    POW-Software/ByteSync

    Produce a structured implementation plan (no code) from an existing specification or deep analysis.

    172 GitHub stars~391 tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Gh Issue Specifier

What does Gh Issue Specifier do?

Analyze a GitHub issue in depth and produce a detailed specification based on codebase analysis. Gh Issue Specifier is an agent skill from POW-Software/ByteSync. Analyze a GitHub issue in depth and produce a detailed specification based on codebase analysis.

When should I use Gh Issue Specifier?

Gh Issue Specifier fits situations like: given a GitHub issue URL; number and asked to deeply analyze requirements; scan the repository; write a structured spec (no code changes).

How do I install Gh Issue Specifier in Claude Code?

Run `npx skills add POW-Software/ByteSync --skill gh-issue-specifier -a claude-code`. Or copy the skill folder (skills/gh-issue-specifier in POW-Software/ByteSync) into .claude/skills/gh-issue-specifier in your project. Claude Code loads it when a task matches its description.

How do I install Gh Issue Specifier in Codex?

Run `npx skills add POW-Software/ByteSync --skill gh-issue-specifier -a codex`. Or copy the skill folder (skills/gh-issue-specifier in POW-Software/ByteSync) into .agents/skills/gh-issue-specifier in your project. Codex loads it when a task matches its description.

Can I use Gh Issue Specifier 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 POW-Software/ByteSync --skill gh-issue-specifier -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-issue-specifier, .gemini/skills/gh-issue-specifier, .github/skills/gh-issue-specifier and .opencode/skills/gh-issue-specifier in your project.

What does Gh Issue Specifier need to run?

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

Does Gh Issue Specifier access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Gh Issue Specifier 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 Issue Specifier use?

Gh Issue Specifier 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 Issue Specifier use?

About 643 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gh Issue Specifier?

Skills that share tags, products or a category with Gh Issue Specifier: GitDiagram Repository Overview (ahmedkhaleel2004/gitdiagram, 18k stars), GitDiagram Repo Architecture (ahmedkhaleel2004/gitdiagram, 18k stars), Octocode Code Research (bgauryy/octocode, 949 stars) and Release (yoanbernabeu/grepai, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gh Issue Specifier?

POW-Software (a GitHub organization) maintains it in POW-Software/ByteSync, which has 172 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on May 7, 2026.

Source: POW-Software/ByteSync on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.