--- 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: ```bash python .\/scripts\/nxs_gh_create_epic.py "" ``` ### Optional Flags | Flag | Description | | -------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `--project ""` | 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 ```bash # Basic usage (auto-discovers project from repo) python .\/scripts\/nxs_gh_create_epic.py "" # Specify target project explicitly python .\/scripts\/nxs_gh_create_epic.py --project "acme-corp\/backend-roadmap" "" # Skip confirmation for existing links python .\/scripts\/nxs_gh_create_epic.py -y "" # Create issue without adding to any project python .\/scripts\/nxs_gh_create_epic.py --no-project "" ``` ## 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 "" --label "" --body-file ` 4. Extracts issue number from returned URL 5. Adds the issue to the specified project (or auto-discovered project) 6. Updates frontmatter with `link: "#"` 7. Cleans up temp file ## Expected Frontmatter ```yaml --- 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` |