dev-issue

Publishes slot feature requests and bug reports as GitHub issues via gh CLI.

154|57|Updated Feb 7, 2020
One-click install
npx skills add https://github.com/FHIR/fhir-codegen --skill dev-issue-fhir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-issue
Source: https://github.com/FHIR/fhir-codegen/tree/main/.github/skills/dev-issue
Command: npx skills add https://github.com/FHIR/fhir-codegen --skill dev-issue-fhir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a locally authored feature request or bug report into a GitHub issue by hand risks duplicate issues, wrong repositories, and lost synchronization between the local artifact and the published issue. This Skill automates that publishing step with strict safeguards so each slot maps to exactly one issue that stays in sync. ## Core Features & Use Cases - Duplicate-safe issue creation: Searches existing issues by slot marker and title before creating, and binds the issue number back into the slot's artifacts immediately after creation. - Idempotent updates and managed plan comments: Republishes refined artifacts as edits to the existing issue and maintains a finalized plan as exactly one marker-tagged comment, never touching human-authored content. - Opt-in GitHub integration with recorded settings: Reads repository, label, and enablement settings from the AGENTS.md GitHub Integration section, resolving missing values once through a Resolve-and-Record Protocol. - Use Case: After finishing a bug report in scratch/0423-02/bugreport.md with status Ready-for-plan, invoke the skill to publish it as a labeled GitHub issue in the correct repository, with the issue number written back into the slot. ## Quick Start Publish the feature request in today's slot 2 as a GitHub issue using the dev-issue skill.

Frequently Asked Questions about dev-issue

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

FAQPage Schema
How do I publish a local feature request as a GitHub issue?▼

Invoke the skill with a slot number or a full path to featurerequest.md or bugreport.md. It renders a problem-first title and body, shows them for approval, creates the issue with gh issue create, and writes the issue number back into the slot artifacts.

How does the skill prevent duplicate GitHub issues?▼

Before creating, it searches all issues for the devskills:slot marker and the artifact title. If a candidate exists it stops and offers the update path instead, and republishing always edits the bound issue rather than creating a new one.

Does the skill work without enabling GitHub integration?▼

No. It is opt-in and off by default. The repository's AGENTS.md must contain a GitHub Integration section with Enabled set to yes; otherwise the skill offers to enable it and stops cleanly if declined.

What happens if the recorded repository does not match the git remote?▼

The skill stops and asks. It parses owner/repo from git remote get-url origin and compares it to the recorded Repository row, refusing to proceed on any mismatch so work is never published to the wrong repository, such as an upstream of a fork.

Why does the skill refuse to publish my artifact?▼

Publishing is gated on terminal status. A feature request or bug report must have Status Ready-for-plan, and a plan must be Ready-to-execute, In-progress, or Complete; anything earlier is a clean refusal, not an error.

Can the skill edit or close existing GitHub issues and comments?▼

It edits only the issue it created and the single plan comment marked with the devskills:plan marker. It never edits human-authored comments, never closes issues, and never stages, commits, or pushes anything to git.