Skip to main content
skill CX Codex

create-issue · fcakyon — Claude Code skill: create GitHub issues

create-issue is a Claude Code skill for drafting or revising issues about bugs and missing features. It can also refine an issue title or body before publication.

Apache-2.0 ★ 1,216 updated 2026-10-24

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install github-dev@claude-settings
Open on GitHub

What create-issue does

The skill turns a problem into an issue with reproduction steps, observed behavior, and the outcome being requested. It follows the repository’s issue template when one exists; otherwise, it uses a compact structure. For a feature request, it describes the current workflow that exposes the gap. It does not invent reproduction steps for a problem that has not been reproduced.

Before publishing, the skill checks repository guidance, searches for an existing issue, and verifies claims. It creates or edits issues with gh issue create or gh issue edit, using --title and --body-file, then reads back the published text. Publishing or editing requires the GitHub CLI gh. When revising an issue, it keeps useful attachments, links, and user edits, and does not broaden the scope without direction.

What it helps with

  • write a bug report with reproducible steps
  • describe a missing feature through the current workflow
  • revise an existing issue title and body
  • remove repeated explanations and diagnostic clutter

Example prompts for the agent

  • Create an issue for the bug where checkout returns to the wrong page.
  • Rewrite this issue’s title and body to follow the repository template.
  • Draft a feature issue based on the current workflow.

How to install create-issue

1Plugin marketplace

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install github-dev@claude-settings

This installs the whole github-dev plugin with all its skills

2Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill create-issue -a claude-code

3Manually: put the files in place

~/.claude/skills/create-issue/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/create-issue/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about create-issue

How do I install create-issue in Claude Code?

Add the marketplace with /plugin marketplace add fcakyon/claude-codex-settings, then install the plugin with /plugin install github-dev@claude-settings.

What does create-issue do?

It drafts or revises issues about bugs and missing features. Before publishing, it checks repository guidance, looks for an existing issue, and verifies claims.

What is required to publish an issue with create-issue?

Creating or editing an issue uses the GitHub CLI gh.

Source text

SKILL.md · Apache-2.0
---
name: create-issue
description: This skill should be used when the user asks to "create an issue", "file a bug", "report a problem", "rewrite an issue", or "improve an issue title or body".
---

# Create or revise an issue

An issue describes a problem or missing capability. A PR describes a proposed change.
Keep their writing rules separate. For PRs, use [create-pr](../create-pr/SKILL.md).

## Title

Use a concise statement of the problem, naming the affected behavior. Do not use an
imperative change request such as "Fix", "Add", "Enable", or "Keep" as the default.

- "Visitor country is unavailable to upstream apps"
- "GeoIP data becomes stale on running installations"
- "Login returns to the wrong page after checkout"

## Body

Follow the repository's issue template and the user's requested format. Otherwise use:

```markdown
## Problem
One or two sentences naming the failure and its effect.

## Reproduction
1. The relevant setup or version.
2. The smallest steps that demonstrate the problem.

## Current behavior
What was observed, with a short error or result when useful.

## Desired behavior
The outcome the reporter needs.
```

For a missing feature, reproduce the current workflow that exposes the gap. If the
problem was not reproduced, say so instead of inventing steps or results. Add environment
details, evidence, or a proposed approach only when they help a maintainer act. Keep a
possible implementation separate from the desired outcome.

Remove repeated explanations, promotional claims, conversation history, full diagnostic
dumps, and details that do not help reproduce or resolve the issue. A few useful sections
are better than a long narrative or a checklist of every investigation step.

## Publish or update

Inspect repository guidance and templates, search for an existing issue, and verify the
claims before publishing. When revising, read the current issue and preserve useful
attachments, links, and user edits. Do not expand an issue's scope without user direction.

Use `gh issue create` or `gh issue edit` with `--title` and `--body-file`. Read back the
published title and body. Link related PRs, but use a closing reference only when the PR
addresses the issue's complete desired outcome.

© Fatih C. Akyon · Apache-2.0 · fcakyon/claude-codex-settings

Similar skills

All skills for Git and GitHub →

create-issue by other authors comes first.

create-issue dyoshikawa create-issue — a skill that walks through issue creation step by step: gathers context, checks the codebase, drafts English text, and assigns labels. Handy when you want a tidy issue without doing it manually. CX Codex +1 ★ 1,636repo stars github-issue-creator microsoft github-issue-creator is a Claude Code skill that turns bug notes, error logs, and screenshots into structured GitHub issues. It activates when a bug report needs to be drafted from informal input. CX Codex +1 63installs create-github-issue-feature-from-specification official github The create-github-issue-feature-from-specification skill turns a specification file into a GitHub issue, checking for similar issues first. Use it when a feature request should cover the complete specification. CX Codex +1 8,900installs create-issue-with-websearch dyoshikawa create-issue-with-websearch turns fuzzy feature concepts into well-researched GitHub issues. It investigates web sources, cross-checks project code, and generates a structured spec. CX Codex +1 ★ 1,636repo stars issue-create terrylica issue-create turns a rough description into a formatted GitHub issue: detects the type, picks labels that exist in the repo, and warns about duplicates before you post. CX Codex +1 129installs create-scrap-issue dyoshikawa The create-scrap-issue skill turns notes and findings into one GitHub issue with context, details, and next steps. Use it when you want to keep project scraps for later. CX Codex +1 ★ 1,636repo stars feat-issue ThinkFlowLab feat-issue is a Claude Code skill that turns feature requests into GitHub Issues with an actionable plan. It runs when invoked by name or asked to plan a feature and create an Issue. CX Codex +1 ★ 413repo stars

From the same set113

The whole set →
rerender-no-inline-components The rerender-no-inline-components rule flags React components declared inside other components, a pattern that causes remounts on parent renders. Use it when state, focus, or scroll position keeps resetting. CX Codex +1 ★ 1,216repo stars state-ground-truth state-ground-truth — a rule that stops agents from storing derived visual values in state. Keeps React and Reanimated logic centered on facts. CX Codex +1 ★ 1,216repo stars ui-styling ui-styling enforces modern React Native styling practices: smooth continuous borders, gap spacing, CSS boxShadow syntax, and native gradients. CX Codex +1 ★ 1,216repo stars ui-measure-views ui-measure-views guides agents to measure React Native view dimensions using useLayoutEffect alongside onLayout without triggering unneeded re-renders. CX Codex +1 ★ 1,216repo stars list-performance-item-memo list-performance-item-memo — a rule for React list rows: split the item into primitive props so memo() can compare them shallowly and skip a render when nothing changed. CX Codex +1 ★ 1,216repo stars react-state-dispatcher react-state-dispatcher enforces functional dispatch updaters in React setState calls whenever state depends on current values. Prevents stale closures in callbacks. CX Codex +1 ★ 1,216repo stars setup Skill for Claude Code configures real integration testing and user QA journeys across project codebases. It triggers when asked to set up QA or generate end-to-end testing flows. CX Codex +1 ★ 1,216repo stars list-performance-inline-objects list-performance-inline-objects — a rule that prevents creating objects inside renderItem for props. Inline objects create new references on every render and break memoization. CX Codex +1 ★ 1,216repo stars

Project sponsors

Companies that keep this analytics open