Merge pull request #26 from amd/dholanda/template_fix

Improve issue template

Author: danielholanda

.github/ISSUE_TEMPLATE/skill-bug-or-improvement.yml

@@ -7,16 +7,13 @@ body:
   - type: markdown
     attributes:
       value: |
-        Thanks for helping us improve an existing skill! Use this form for **existing** skills only.
-        If you want to propose a brand-new skill, use the *Skill proposal* template instead.
-
-        Fill out the short fields below, then describe the issue in detail at the end.
+        For a brand-new skill, use the *Skill proposal* template instead.
 
   - type: dropdown
     id: skill_name
     attributes:
       label: Which skill?
-      description: Pick the existing skill this issue is about. One issue per skill, please. If your skill isn't listed (e.g. it was just added), pick **Other** and name it in the details below.
+      description: One issue per skill. Pick **Other** if it isn't listed yet.
       options:
         - local-ai-app-integration
         - local-ai-use
@@ -27,78 +24,45 @@ body:
   - type: dropdown
     id: issue_kind
     attributes:
-      label: What kind of issue is this?
-      description: |
-        Pick the option that best matches what you're reporting. The fields below are tailored to each kind. A matching label (`bug`, `improvement`, `scope`) will be applied automatically when the issue is created.
-          - **Improvement** — the skill works, but its strategy/instructions should change.
-          - **Bug** — the skill is broken, gives wrong output, or fails to fire when it should.
-          - **Scope** — the skill's scope should grow, shrink, or shift.
-          - **Something else** — none of the above.
+      label: Kind
       options:
         - "Improvement — existing skill should behave differently"
         - "Bug — existing skill is broken"
         - "Scope — scope of existing skill should change"
-        - "Something else"
     validations:
       required: true
 
   - type: textarea
-    id: improvement_details
-    attributes:
-      label: "Improvement: how should the skill's strategy change?"
-      description: Only fill in if you picked **Improvement**. Suggest concretely how the skill's strategy, instructions, or behavior should change, and why.
-      placeholder: |
-        e.g. The skill currently always uses SD-Turbo at 512x512. It should pick a larger size when
-        the user asks for a "wallpaper" or "poster" because the current default looks pixelated.
-
-  - type: textarea
-    id: bug_details
+    id: details
     attributes:
-      label: "Bug: what is broken, and how do we reproduce it?"
+      label: Describe the issue
       description: |
-        Only fill in if you picked **Bug**. Cover:
-          - What you asked the agent to do.
-          - What you expected the skill to do.
-          - What actually happened (full agent output / error message helps).
-          - Minimal reproduction steps.
+        Fill in the section that matches what you picked above. Delete the rest.
+
+        - **Improvement** — how should the skill's strategy, instructions, or behavior change, and why?
+        - **Bug** — what you asked the agent to do, what you expected the skill to do, what actually happened (full agent output / error helps), and minimal repro steps.
+        - **Scope** — should the skill's scope be **decreased**, **increased**, or **shifted**? Be specific about which triggers/use cases to add or remove.
+        - **Something else** — describe what's going on and what you'd like to see happen.
       placeholder: |
         Steps to reproduce:
           1. ...
           2. ...
         Expected: ...
         Actual: ...
-
-  - type: textarea
-    id: scope_details
-    attributes:
-      label: "Scope: how should the scope change?"
-      description: |
-        Only fill in if you picked **Scope**. Describe how the scope of this skill should change to be more useful — should it be **decreased**, **increased**, or **shifted**? Be specific about which triggers/use cases to add or remove.
-      placeholder: |
-        e.g. Decrease scope: stop firing on plain chat questions about local models — only fire
-        when the user actually asks to generate an image, transcribe audio, or speak text.
-
-  - type: textarea
-    id: other_details
-    attributes:
-      label: "Something else: describe the issue"
-      description: Only fill in if you picked **Something else**. Describe what's going on and what you'd like to see happen.
+    validations:
+      required: true
 
   - type: markdown
     attributes:
       value: |
         ---
-        ### Environment
-
-        The fields below are **required for Improvement, Bug, and Something else** so we can reproduce what you saw.
-        For **Scope** issues you can leave them blank.
+        ### Environment (required for Improvement and Bug; optional for Scope)
 
   - type: input
     id: system
     attributes:
       label: System / hardware
-      description: The machine you ran the agent on. Include the AMD product name and key accelerator(s) if relevant.
-      placeholder: e.g. AMD Ryzen™ AI Max+ 395, or MI300X server, or Ryzen 9 7950X + Radeon RX 7900 XTX
+      placeholder: e.g. AMD Ryzen™ AI Max+ 395, or MI300X, or Ryzen 9 7950X + RX 7900 XTX
 
   - type: input
     id: os
@@ -110,24 +74,16 @@ body:
     id: agent
     attributes:
       label: Which agent did you use?
-      description: The coding agent / assistant that loaded the skill.
       options:
         - "Cursor"
         - "Claude Code"
         - "Claude Desktop"
         - "Codex CLI"
         - "GitHub Copilot"
-        - "Other (describe in details below)"
+        - "Other (describe in details above)"
 
   - type: input
     id: model
     attributes:
-      label: Which model?
-      description: The underlying LLM the agent was using when the skill ran.
-      placeholder: e.g. Claude Opus 4.7, GPT-5.5, Sonnet 4.6
-
-  - type: textarea
-    id: anything_else
-    attributes:
-      label: Anything else?
-      description: Logs, screenshots, links to related issues/PRs, or extra context that didn't fit above.
+      label: Model
+      placeholder: e.g. Claude Opus 4.7

.github/workflows/label-skill-issues.yml

@@ -83,7 +83,7 @@ jobs:
 
             if (templateLabels.includes("skill-issue")) {
               await applyGroup({
-                section: "What kind of issue is this\\?",
+                section: "Kind",
                 groupLabels: ["bug", "improvement", "scope"],
                 pick: (answer) => {
                   if (/^Improvement\b/i.test(answer)) return "improvement";