create-issue

name: create-issue trigger: create GitHub issues description: Creates GitHub issues for the package repository. Use when asked to create, file, or open a GitHub issue, or when planning new features or functions that need to be tracked. compatibility: Requires the gh CLI and an authenticated GitHub session.

Create a GitHub issue

Use gh api graphql with the createIssue mutation to create issues. This sets the issue type in a single step. Write the body to a temp file first, then pass it via $(cat ...).

If gh is not authenticated, stop and ask the user to authenticate before continuing.

Looking up IDs

The hardcoded IDs below are correct for this repo as of 2026-03-24 11:11:01 UTC. If they ever change, or if you're working in a fork, re-run these queries to get fresh values:

# Repository node ID
gh api graphql -f query='{ repository(owner: "wranglezone", name: "stbl") { id } }'

# Available issue type IDs
gh api graphql -f query='{ repository(owner: "wranglezone", name: "stbl") { issueTypes(first: 20) { nodes { id name description } } } }'

Issue type

Choose the type that best fits the issue:

Issue title

Titles use conventional commit prefixes:

• feat: my_function() — new exported function or feature
• fix: short description — bug fix
• docs: short description — documentation
• chore: short description — maintenance or task

Issue body structure

Which sections to include depends on the issue type:

## Summary (all types)

A single user story sentence (no other content in this section):

> As a [role], in order to [goal], I would like to [feature].

Example:

## Summary

> As a package developer, in order to set up agent skills quickly, I would like to generate a skill template from a single function call.

## Details (optional, all types)

For information that's important to capture but doesn't fit naturally into any other section, including implementation details such as packages to add to Imports in DESCRIPTION or files to add to inst. Use sparingly — if the content belongs in ## Behavior, ## Proposed signature, or ## References, put it there instead.

## Proposed signature (Feature only)

The proposed R function signature, arguments table, and return value description:

## Proposed signature

```r
function_name(arg1, arg2)
```

**Arguments**

- `arg1` (`TYPE`) — Description.
- `arg2` (`TYPE`) — Description.

**Returns** a `TYPE` with description.

## Behavior (Feature and Bug)

• Feature: bullet points describing expected behavior, edge cases, and any internal helpers to implement as part of this issue.
• Bug: describe the current (broken) behavior, the expected behavior, and steps to reproduce if known.

## References (optional, all types)

Only include when there are specific reference implementations, external URLs, or related code to link to. Omit it entirely when there are none.

Creating the issue

Use the repoId and the typeId for the chosen issue type from the table above.

gh api graphql \
  -f query='mutation($repoId:ID!, $title:String!, $body:String!, $typeId:ID!) {
    createIssue(input:{repositoryId:$repoId, title:$title, body:$body, issueTypeId:$typeId}) {
      issue { url }
    }
  }' \
  -f repoId="R_kgDOKC_ILg" \
  -f title="feat: my_function()" \
  -f body="$(cat /tmp/issue_body.md)" \
  -f typeId="{typeId}"