skills.rest
Gamaroff
GamaroffCOMMUNITY
Explore all skills by this author →
Website𝕏@gamaroffGitHub

create-issue

Creates tracker issues in Jira, GitHub, or Bitbucket with linked local issue documents.

2|Updated Feb 14, 2026
Search Tags:#pr review#issue tracking#jira#work items#create#bitbucket#github cli
One-click install
npx skills add https://github.com/Gamaroff/agent-skills --skill create-issue-gamaroff
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-issue
Source: https://github.com/Gamaroff/agent-skills/tree/main/skills/create-issue
Command: npx skills add https://github.com/Gamaroff/agent-skills --skill create-issue-gamaroff

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When bugs, improvements, or work items surface during PR reviews or development, they often go untracked or live only in chat. This Skill creates a properly tracked issue in the remote tracker (Jira, GitHub, or Bitbucket) plus a co-located local issue document, linked bidirectionally for traceability. ## Core Features & Use Cases - Multi-platform issue creation: Creates issues via the GitHub CLI, Bitbucket REST API, or Jira REST API, with platform auto-detection (Jira takes priority when JIRA_URL is set, otherwise detected from the git remote URL). - Local issue documents: Generates numbered issue files (e.g., story.180.3.issue.1.debounce-timing.md) co-located with the source story or task, with frontmatter, acceptance criteria, and status history. - Workflow integration: Updates the source document's Issues section and connects to branch creation, commit, and PR skills so merging a PR can auto-close the tracker issue. - Use Case: During a PR review you notice the search debounce timing is wrong. Run the skill against the story file with a title and description, and it creates GitHub issue #47 plus a local issue document ready for /create-branch. ## Quick Start Ask the agent to create an issue from a story or task file, for example: create an issue on story.180.3.quick-re-search.md titled "Search debounce should be 300ms not 500ms" from PR 123.

Frequently Asked Questions about create-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GitHub issue from a PR review finding?▼

Run the skill with the source story or task file, a title, a description, and the --from-pr flag with the PR number. It creates the issue via the GitHub CLI, writes a local issue document, and links both together.

How does the skill choose between Jira, GitHub, and Bitbucket?▼

Jira takes priority whenever JIRA_URL is set, regardless of the git remote. Otherwise the platform is detected from the git remote URL: github.com selects GitHub and bitbucket.org selects Bitbucket.

When should I use create-issue instead of create-bug-report?▼

Use create-issue for informal discoveries during PR reviews, enhancements, and tech debt. Use create-bug-report for bugs found during formal QA testing that need severity classification and the QA workflow.

What credentials are needed for Bitbucket issue creation?▼

Set BITBUCKET_ACCESS_TOKEN for Bearer authentication, or BITBUCKET_USERNAME plus BITBUCKET_API_TOKEN for Basic auth. Issues must also be enabled on the repository under Settings, Features, Issues.

Why did my GitHub issue creation fail because of labels?▼

The gh CLI rejects the entire create when one label is undefined in the repository. The skill routes every label through a filter that drops undefined labels with a warning so the issue itself is still created.

Can I use this skill for major new features?▼

No. Major new features should use create-story or create-epic instead. This skill is scoped to bugs, enhancements, and tasks that need tracking alongside an existing story or task.

Related Skills

Explore More Software Engineering Skills→
fsollafsolla

capture-review-debts

Capture and triage technical debt into structured GitHub issues.

Community
Advanced
smallnestsmallnest
207

ship-it

Commit changes, create and merge a pull request, and close the linked GitHub issue.

Community
Advanced
vercel-labsvercel-labs
41.7k

dogfood

Explores web applications with agent-browser to find bugs and produce evidence-backed QA reports.

Official
Advanced
DonchitosDonchitos
24.7k

team-qa

Orchestrates QA agents through test planning, manual testing, and sign-off reporting.

Community
Advanced