Claude Code Plugins

Community-maintained marketplace

Feedback

nxs-gh-create-epic

@sameera/nexus
0
0

Create a GitHub issue from an Epic document. Use when the user wants to create a GitHub issue from an epic.md file, sync an epic to GitHub, or link an epic document to a GitHub issue. The skill extracts the epic title and type from YAML frontmatter, creates an issue via `gh issue create`, and updates the frontmatter with the issue link.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name nxs-gh-create-epic
description Create a GitHub issue from an Epic document. Use when the user wants to create a GitHub issue from an epic.md file, sync an epic to GitHub, or link an epic document to a GitHub issue. The skill extracts the epic title and type from YAML frontmatter, creates an issue via `gh issue create`, and updates the frontmatter with the issue link.

GitHub Epic Issue Creator

Create a GitHub issue from an Epic document's content and link it back to the epic.

Prerequisites

  • GitHub CLI (gh) installed and authenticated
  • Running within a git repository connected to GitHub

Workflow

  1. Locate the Epic document from user reference, open file, or argument
  2. Run the script to create the issue and update frontmatter:
python scripts/nxs_gh_create_epic.py "<path-to-epic.md>"

Use -y flag to skip confirmation if a link already exists:

python scripts/nxs_gh_create_epic.py -y "<path-to-epic.md>"

Script Behavior

The script (scripts/nxs_gh_create_epic.py):

  1. Parses YAML frontmatter for epic (title) and type (label, defaults to "epic")
  2. Creates temp file with markdown body (frontmatter stripped)
  3. Executes gh issue create --title "<epic>" --label "<type>" --body-file <temp>
  4. Extracts issue number from returned URL
  5. Updates frontmatter with link: "#<issue-number>"
  6. Cleans up temp file

Expected Frontmatter

---
feature: "Feature Name"
epic: "Epic Title" # Required - becomes issue title
created: 2025-01-02
status: draft
type: enhancement # Optional - becomes GitHub label (default: "epic")
---

After execution, link: "#123" is added to frontmatter.

Error Handling

Error Resolution
gh: command not found Install GitHub CLI: https://cli.github.com
gh: not logged in Run gh auth login
label does not exist Create label in GitHub or use existing label
not a git repository Navigate to project root
No 'epic' field found Add epic: "Title" to frontmatter