feat: add Skills and VS Code Extension categories to issue/PR templates (#410)

Copilot · katriendg · WilliamBerryiii · web-flow · commit 108e160c4c34 · 2026-02-04T10:54:29.000-08:00
## Implementation Plan - [x] Update bug-report.yml to add "Skills" and "VS Code Extension" to Component dropdown - [x] Create new skill-request.yml template following the pattern of existing request templates - [x] Update PULL_REQUEST_TEMPLATE.md to add Skills checkbox and reference link - [x] Remove single-platform options from skill-request.yml (only cross-platform allowed) - [x] Remove platform requirements section entirely (doesn't add value) - [x] Update AI artifact checklist to include "skill" in the comment - [x] Add PR template to frontmatter validation exclusion list to prevent CI failures - [x] Sync package.json frontmatter exclusions with workflow for consistent dev/CI experience - [x] Run validation (lint:yaml, lint:md, lint:frontmatter) to ensure templates pass all checks - [x] Verify all changes are correctly implemented  <details> <summary>Original prompt</summary> > > ---- > > *This section details on the original issue you should resolve* > > <issue_title>[Issue]: add VS Code Extension and Skills categories to issue and PR templates</issue_title> > <issue_description>### Issue Description > > ## Background > > The repository recently added Skills as a new AI artifact type (`.github/skills/*/SKILL.md`) alongside agents, prompts, and instructions. The `video-to-gif` skill exists and is documented at `docs/contributing/skills.md`, but the issue templates and PR template do not recognize Skills as a contribution type. > > Additionally, the VS Code Extension (`extension/`) is a core deliverable but is missing from the bug report component list, preventing users from categorizing extension-specific bugs correctly. > > ## Current State > > | Template | Issue | > |----------|-------| > | `.github/ISSUE_TEMPLATE/bug-report.yml` | Missing "Skills" and "VS Code Extension" in Component dropdown | > | `.github/ISSUE_TEMPLATE/skill-request.yml` | Does not exist | > | `.github/PULL_REQUEST_TEMPLATE.md` | Missing Skills checkbox in AI Artifacts section | > > ## Work Required > > ### 1. Update Bug Report Template > > **File:** `.github/ISSUE_TEMPLATE/bug-report.yml` > > Add two new options to the Component dropdown: > > ```yaml > options: > - Instruction Files > - Prompts > - Custom Agents > - Skills # ADD > - VS Code Extension # ADD > - Scripts > - Documentation > - Other > ``` > > ### 2. Create Skill Request Issue Template > > **File:** `.github/ISSUE_TEMPLATE/skill-request.yml` (new file) > > Create template with: > > - **name:** `Skill Request` > - **description:** `Request a new skill package` > - **title:** `[Skill]: ` > - **labels:** `skill`, `needs-triage` > - **Fields:** > - Skill Name (input, required) > - Purpose (textarea, required) > - Platform Requirements (dropdown: Both bash and PowerShell, Bash only, PowerShell only) > - Prerequisites (textarea, optional) - external tools needed > - Requirements (textarea, optional) > > ### 3. Update PR Template > > **File:** `.github/PULL_REQUEST_TEMPLATE.md` > > Add Skills checkbox to AI Artifacts section: > > ```markdown > **AI Artifacts:** > > - [ ] Reviewed contribution with `prompt-builder` agent and addressed all feedback > - [ ] Copilot instructions (`.github/instructions/*.instructions.md`) > - [ ] Copilot prompt (`.github/prompts/*.prompt.md`) > - [ ] Copilot agent (`.github/agents/*.agent.md`) > - [ ] Copilot skill (`.github/skills/*/SKILL.md`) # ADD > ``` > > Add Skills reference to the note section: > > ```markdown > > - **Skills**: Must include both bash and PowerShell scripts. See [Skills](../docs/contributing/skills.md). > ``` > > ## Acceptance Criteria > > - [ ] Bug report template includes Skills and VS Code Extension options > - [ ] New `skill-request.yml` template exists and matches pattern of other request templates > - [ ] PR template includes Skills checkbox and reference link > - [ ] All templates pass `npm run lint:yaml` validation > > > ### Additional Context > > _No response_</issue_description> > > <agent_instructions>Start implementation, ensure you run the available validation tools like `npm run lint:md``, and `npm run lint:frontmatter` or other applicable ones to the types of files changed. Only finish and report back once validation passes.</agent_instructions> > > ## Comments on the Issue (you are @copilot in this section) > > <comments> > </comments> > </details>  - Fixes #409  --- ✨ Let Copilot coding agent [set things up for you](https://github.com/microsoft/hve-core/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot) — coding agent works faster and does higher quality work when set up for your repo. --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: katriendg <838216+katriendg@users.noreply.github.com> Co-authored-by: Katrien De Graeve <katriendg@users.noreply.github.com> Co-authored-by: Bill Berry <WilliamBerryiii@users.noreply.github.com>
diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml
@@ -17,6 +17,8 @@ body:
         - Instruction Files
         - Prompts
         - Custom Agents
+        - Skills
+        - VS Code Extension
         - Scripts
         - Documentation
         - Other
diff --git a/.github/ISSUE_TEMPLATE/skill-request.yml b/.github/ISSUE_TEMPLATE/skill-request.yml
@@ -0,0 +1,45 @@
+name: Skill Request
+description: Request a new skill package
+title: "[Skill]: "
+labels: ["skill", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Request a new skill package for GitHub Copilot.
+  
+  - type: input
+    id: skill-name
+    attributes:
+      label: Skill Name
+      description: What should this skill be named?
+      placeholder: e.g., "docker-compose-gen"
+    validations:
+      required: true
+  
+  - type: textarea
+    id: purpose
+    attributes:
+      label: Purpose
+      description: What problem does this skill solve?
+      placeholder: Describe when and why this skill would be used
+    validations:
+      required: true
+  
+  - type: textarea
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      description: What external tools or dependencies are needed?
+      placeholder: List any required installations (e.g., ffmpeg, docker, jq)
+    validations:
+      required: false
+  
+  - type: textarea
+    id: requirements
+    attributes:
+      label: Requirements
+      description: What specific behaviors should this skill enable?
+      placeholder: List the key capabilities or features needed
+    validations:
+      required: false
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -31,10 +31,12 @@ Select all that apply:
 - [ ] Copilot instructions (`.github/instructions/*.instructions.md`)
 - [ ] Copilot prompt (`.github/prompts/*.prompt.md`)
 - [ ] Copilot agent (`.github/agents/*.agent.md`)
+- [ ] Copilot skill (`.github/skills/*/SKILL.md`)
 
 > **Note for AI Artifact Contributors**:
 >
 > - **Agents**: Research, indexing/referencing other project (using standard VS Code GitHub Copilot/MCP tools), planning, and general implementation agents likely already exist. Review `.github/agents/` before creating new ones.
+> - **Skills**: Must include both bash and PowerShell scripts. See [Skills](../docs/contributing/skills.md).
 > - **Model Versions**: Only contributions targeting the **latest Anthropic and OpenAI models** will be accepted. Older model versions (e.g., GPT-3.5, Claude 3) will be rejected.
 > - See [Agents Not Accepted](../docs/contributing/custom-agents.md#agents-not-accepted) and [Model Version Requirements](../docs/contributing/ai-artifacts-common.md#model-version-requirements).
 
@@ -66,6 +68,7 @@ For detailed contribution requirements, see:
 - **Agents**: [docs/contributing/custom-agents.md](../docs/contributing/custom-agents.md) - Agent configurations with tools and behavior patterns
 - **Prompts**: [docs/contributing/prompts.md](../docs/contributing/prompts.md) - Workflow-specific guidance with template variables
 - **Instructions**: [docs/contributing/instructions.md](../docs/contributing/instructions.md) - Technology-specific standards with glob patterns
+- **Skills**: [docs/contributing/skills.md](../docs/contributing/skills.md) - Task execution utilities with cross-platform scripts
 
 ## Testing
 <!-- Describe how you tested these changes -->
@@ -80,7 +83,7 @@ For detailed contribution requirements, see:
 - [ ] Tests added for new functionality (if applicable)
 
 ### AI Artifact Contributions
-<!-- If contributing an agent, prompt, or instruction, complete these checks -->
+<!-- If contributing an agent, prompt, instruction, or skill, complete these checks -->
 - [ ] Used `/prompt-analyze` to review contribution
 - [ ] Addressed all feedback from `prompt-builder` review
 - [ ] Verified contribution follows common standards and type-specific requirements
diff --git a/.github/workflows/frontmatter-validation.yml b/.github/workflows/frontmatter-validation.yml
@@ -78,7 +78,8 @@ jobs:
           
           # Exclude test fixture files (intentionally invalid frontmatter for testing)
           # and extension/README.md (uses VS Code marketplace format, not repo docs standards)
-          $params['ExcludePaths'] = @('scripts/tests/Fixtures/**', 'extension/README.md')
+          # and .github/PULL_REQUEST_TEMPLATE.md (GitHub template, not a documentation file)
+          $params['ExcludePaths'] = @('scripts/tests/Fixtures/**', 'extension/README.md', '.github/PULL_REQUEST_TEMPLATE.md')
           
           & scripts/linting/Validate-MarkdownFrontmatter.ps1 @params
         continue-on-error: true
diff --git a/package.json b/package.json
@@ -13,7 +13,7 @@
     "lint:yaml": "pwsh -File scripts/linting/Invoke-YamlLint.ps1",
     "lint:links": "pwsh -NoProfile -Command \"& scripts/linting/Invoke-LinkLanguageCheck.ps1 -ExcludePaths 'scripts/tests/**'\"",
     "lint:md-links": "pwsh -File scripts/linting/Markdown-Link-Check.ps1",
-    "lint:frontmatter": "pwsh -NoProfile -Command \"& scripts/linting/Validate-MarkdownFrontmatter.ps1 -WarningsAsErrors -EnableSchemaValidation -ExcludePaths 'scripts/tests/Fixtures/**'\"",
+    "lint:frontmatter": "pwsh -NoProfile -Command \"& scripts/linting/Validate-MarkdownFrontmatter.ps1 -WarningsAsErrors -EnableSchemaValidation -ExcludePaths 'scripts/tests/Fixtures/**', 'extension/README.md', '.github/PULL_REQUEST_TEMPLATE.md'\"",
     "lint:all": "npm run format:tables && npm run lint:md && npm run lint:ps && npm run lint:yaml && npm run lint:links && npm run lint:frontmatter",
     "format:tables": "markdown-table-formatter \"**/*.md\"",
     "extension:prepare": "pwsh ./scripts/extension/Prepare-Extension.ps1",
