Claude Code Plugins

Community-maintained marketplace

Feedback

nxs-gh-create-epic

@majiayu000/claude-skill-registry
27
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

Shared

Installs to .agents/skills, used by Codex, Amp, Warp, Cursor, OpenCode, and more.

CodexAmp
WarpCursorOpenCode
ClineGemini CLI
GitHub Copilot
Personal

Available across projects.

$npx skills-installer add @majiayu000/claude-skill-registry/nxs-gh-create-epic --client shared
Project

Writes to .agents/skills.

$npx skills-installer add @majiayu000/claude-skill-registry/nxs-gh-create-epic -p --client shared
Note: Review the skill 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>"

Optional Flags

Flag Description
--project "<name>" Specify the GitHub project to add the issue to (e.g., my-org/my-project). If omitted, auto-discovers from repository.
-y, --yes Skip confirmation if a link already exists
--no-project Skip adding the issue to any project

Examples

# Basic usage (auto-discovers project from repo)
python ./scripts/nxs_gh_create_epic.py "<path-to-epic.md>"

# Specify target project explicitly
python ./scripts/nxs_gh_create_epic.py --project "acme-corp/backend-roadmap" "<path-to-epic.md>"

# Skip confirmation for existing links
python ./scripts/nxs_gh_create_epic.py -y "<path-to-epic.md>"

# Create issue without adding to any project
python ./scripts/nxs_gh_create_epic.py --no-project "<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. Adds the issue to the specified project (or auto-discovered project)
  6. Updates frontmatter with link: "#<issue-number>"
  7. 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
Project not found Verify project name or use --no-project