# Issue > Create or update a GitHub issue following verl project conventions. Use when this capability is needed. - Skill: `tomevault-io/issue-4` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/issue-4` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/issue-4/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/issue-4 --- When the user asks to create or update an issue, follow these steps: ### 1. Gather Context Read the following to understand available issue types and their required fields: - [`bug-report.yml`](.github/ISSUE_TEMPLATE/bug-report.yml) - [`feature-request.yml`](.github/ISSUE_TEMPLATE/feature-request.yml) If updating an existing issue, read its current title, body, labels, and comments first. ### 2. Determine Issue Type Based on the user's description, select the appropriate template: - **Bug report** ([`bug-report.yml`](.github/ISSUE_TEMPLATE/bug-report.yml)) — something is broken or behaves unexpectedly - **Feature request** ([`feature-request.yml`](.github/ISSUE_TEMPLATE/feature-request.yml)) — a new capability or enhancement - **Blank issue** — if neither template fits ### 3. Compose the Issue Fill in the template fields based on information from the user and the codebase. For bug reports, run `python scripts/diagnose.py` to gather system info if possible. When updating, ensure the title and body still accurately reflect the current state of the issue. ### 4. Check for Duplicates Search for existing issues before creating: ``` gh issue list --repo verl-project/verl --state open --search "" ``` If a duplicate exists, inform the user instead of creating a new one. ### 5. Create or Update the Issue - **Create**: add `good first issue` and/or `call for contribution` labels if the issue is straightforward and suitable for new contributors. - **Update**: update title, body, and labels as needed. Return the issue URL when done. --- > Source: [verl-project/verl](https://github.com/verl-project/verl) — distributed by [TomeVault](https://tomevault.io).