feat: add release automation, commit linting, template sync, and update to latest APIs

Author: trsdn

.githooks/commit-msg

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Git commit-msg hook to enforce Conventional Commits
+# Install via: ./scripts/setup-hooks.sh
+
+commit_msg_file="$1"
+commit_msg=$(head -1 "$commit_msg_file")
+
+# Skip merge commits
+if echo "$commit_msg" | grep -qE "^Merge "; then
+  exit 0
+fi
+
+# Skip [skip ci] only commits
+if echo "$commit_msg" | grep -qE "^\[skip ci\]$"; then
+  exit 0
+fi
+
+# Conventional Commits pattern
+pattern='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?(!)?: .+'
+
+if ! echo "$commit_msg" | grep -qE "$pattern"; then
+  echo ""
+  echo "❌ Commit message does not follow Conventional Commits format!"
+  echo ""
+  echo "  Your message:  $commit_msg"
+  echo ""
+  echo "  Required format: <type>(<optional scope>): <description>"
+  echo ""
+  echo "  Allowed types:"
+  echo "    feat     - A new feature"
+  echo "    fix      - A bug fix"
+  echo "    docs     - Documentation only"
+  echo "    style    - Formatting, no code change"
+  echo "    refactor - Code restructuring"
+  echo "    perf     - Performance improvement"
+  echo "    test     - Adding/updating tests"
+  echo "    build    - Build system changes"
+  echo "    ci       - CI configuration changes"
+  echo "    chore    - Maintenance tasks"
+  echo "    revert   - Reverting a previous commit"
+  echo ""
+  echo "  Examples:"
+  echo "    feat: add new copilot skill for debugging"
+  echo "    fix(agents): correct yaml frontmatter parsing"
+  echo "    docs: update contributing guidelines"
+  echo "    feat!: redesign skill format (BREAKING CHANGE)"
+  echo ""
+  exit 1
+fi

.github/agents/copilot-customization-builder.agent.md

@@ -2,7 +2,8 @@
 description: Create and maintain Copilot customizations (agents, prompt files, instructions, skills, MCP) for VS Code and GitHub Copilot
 name: Copilot Customization Builder
 tools: ['search', 'fetch', 'editFiles', 'runCommand', 'runSubagent']
-infer: true
+user-invokable: true
+disable-model-invocation: false
 ---
 # Copilot Customization Builder
 
@@ -39,7 +40,7 @@ When a user asks for a new customization, do this:
    - Match naming, tool naming, and tone.
 
 3. **Design before writing files**
-   - Draft the frontmatter: `name`, `description`, `tools`, optional `model`, optional `infer`, optional `target`, optional `handoffs`.
+   - Draft the frontmatter: `name`, `description`, `tools`, optional `model`, optional `user-invokable`, optional `disable-model-invocation`, optional `agents`, optional `target`, optional `handoffs`.
    - Keep tool lists small; if omitted, the agent gets *all* tools (avoid that unless explicitly requested).
 
 4. **Implement incrementally**
@@ -60,12 +61,20 @@ When a user asks for a new customization, do this:
 - The filename should be a stable slug.
 
 Frontmatter guidelines:
+
 - `description` is required.
 - `name` is strongly recommended.
 - `tools` is recommended to be explicit.
+- `agents` controls which agents can be used as subagents (use `*` for all, `[]` for none).
+- `user-invokable` (default `true`) controls visibility in the agents dropdown. Set to `false` for subagent-only agents.
+- `disable-model-invocation` (default `false`) prevents the agent from being invoked as a subagent.
+- `argument-hint` provides hint text in the chat input field.
 - `target` can be `vscode` or `github-copilot` to restrict availability; omit to allow both.
+- `mcp-servers` can specify MCP server configs for GitHub Copilot coding agent.
 - Agent prompt text must remain under the applicable limits (keep it tight and modular).
 
+> **Deprecated:** `infer` is deprecated. Use `user-invokable` and `disable-model-invocation` instead.
+
 ### Prompt files
 
 - Stored as `.prompt.md` in `.github/prompts/`.
@@ -88,10 +97,12 @@ Agent Skills are portable folders of instructions, scripts, and resources that A
 - Personal skills: `~/.copilot/skills/<skill-name>/SKILL.md` (recommended) or `~/.claude/skills/<skill-name>/SKILL.md` (legacy)
 
 SKILL.md frontmatter:
+
 - `name` (required): Unique identifier, lowercase with hyphens, max 64 chars (e.g., `webapp-testing`)
 - `description` (required): What the skill does and when to use it, max 1024 chars. Be specific to help Copilot decide when to load.
 
 Skill body should include:
+
 - What the skill accomplishes
 - When to use it (specific triggers and use cases)
 - Step-by-step procedures
@@ -117,7 +128,7 @@ VS Code supports **context-isolated subagents** via the `runSubagent` tool. To u
 
 - Ensure `runSubagent` is enabled (either via the tools picker, or via `tools: [...]` in the agent/prompt frontmatter).
 - If you want a subagent to run as a *specific custom agent*, enable the experimental setting `chat.customAgentInSubagent.enabled`.
-- A custom agent can be blocked from subagent usage by setting `infer: false` in its `*.agent.md` frontmatter.
+- A custom agent can be blocked from subagent usage by setting `disable-model-invocation: true` in its `*.agent.md` frontmatter.
 
 ### Handoffs (VS Code)
 
@@ -127,39 +138,43 @@ VS Code custom agents support a `handoffs:` frontmatter property to guide users
 
 Some frontmatter fields have different behavior depending on where the agent runs.
 
-- `infer`:
-   - In **VS Code**, `infer` controls whether the agent can be used as a subagent (defaults to `true`).
-   - In **GitHub Copilot coding agent**, `infer: false` disables automatic agent selection (the agent must be chosen manually).
+- `user-invokable` / `disable-model-invocation`:
+  - In **VS Code**, these separately control picker visibility and subagent availability.
+  - In **GitHub Copilot coding agent**, `disable-model-invocation: true` disables automatic agent selection.
 - `handoffs`:
-   - Supported in **VS Code**.
-   - Currently **ignored** by **GitHub Copilot coding agent** for compatibility.
+  - Supported in **VS Code**.
+  - Currently **ignored** by **GitHub Copilot coding agent** for compatibility.
+- `mcp-servers`:
+  - Used by **GitHub Copilot coding agent** (`target: github-copilot`) to configure MCP servers.
+  - In **VS Code**, MCP servers are configured via `mcp.json` or VS Code settings.
 
 ## Reference docs
 
-- VS Code Copilot overview: https://code.visualstudio.com/docs/copilot/overview
-- Customize chat overview: https://code.visualstudio.com/docs/copilot/customization/overview
-- Custom agents (VS Code): https://code.visualstudio.com/docs/copilot/customization/custom-agents
-- Prompt files (VS Code): https://code.visualstudio.com/docs/copilot/customization/prompt-files
-- Custom instructions (VS Code): https://code.visualstudio.com/docs/copilot/customization/custom-instructions
-- Agent Skills (VS Code): https://code.visualstudio.com/docs/copilot/customization/agent-skills
-- Agent Skills standard: https://agentskills.io/
-- Language models (VS Code): https://code.visualstudio.com/docs/copilot/customization/language-models
-- MCP servers (VS Code): https://code.visualstudio.com/docs/copilot/customization/mcp-servers
-- Chat tools & approvals (VS Code): https://code.visualstudio.com/docs/copilot/chat/chat-tools
-- Chat sessions (VS Code): https://code.visualstudio.com/docs/copilot/chat/chat-sessions
-- Manage context (VS Code): https://code.visualstudio.com/docs/copilot/chat/copilot-chat-context
-- Copilot feature reference / cheat sheet (VS Code): https://code.visualstudio.com/docs/copilot/reference/copilot-vscode-features
-- Agents overview (local/background/cloud): https://code.visualstudio.com/docs/copilot/agents/overview
-- Background agents: https://code.visualstudio.com/docs/copilot/agents/background-agents
-- Cloud agents: https://code.visualstudio.com/docs/copilot/agents/cloud-agents
-- Context engineering guide: https://code.visualstudio.com/docs/copilot/guides/context-engineering-guide
-- Prompt engineering guide: https://code.visualstudio.com/docs/copilot/guides/prompt-engineering-guide
-- Security considerations (VS Code): https://code.visualstudio.com/docs/copilot/security
-- Subagents / chat sessions (VS Code): https://code.visualstudio.com/docs/copilot/chat/chat-sessions
+- VS Code Copilot overview: <https://code.visualstudio.com/docs/copilot/overview>
+- Customize chat overview: <https://code.visualstudio.com/docs/copilot/customization/overview>
+- Custom agents (VS Code): <https://code.visualstudio.com/docs/copilot/customization/custom-agents>
+- Prompt files (VS Code): <https://code.visualstudio.com/docs/copilot/customization/prompt-files>
+- Custom instructions (VS Code): <https://code.visualstudio.com/docs/copilot/customization/custom-instructions>
+- Agent Skills (VS Code): <https://code.visualstudio.com/docs/copilot/customization/agent-skills>
+- Agent Skills standard: <https://agentskills.io/>
+- Language models (VS Code): <https://code.visualstudio.com/docs/copilot/customization/language-models>
+- MCP servers (VS Code): <https://code.visualstudio.com/docs/copilot/customization/mcp-servers>
+- Chat tools & approvals (VS Code): <https://code.visualstudio.com/docs/copilot/chat/chat-tools>
+- Chat sessions (VS Code): <https://code.visualstudio.com/docs/copilot/chat/chat-sessions>
+- Manage context (VS Code): <https://code.visualstudio.com/docs/copilot/chat/copilot-chat-context>
+- Copilot feature reference / cheat sheet (VS Code): <https://code.visualstudio.com/docs/copilot/reference/copilot-vscode-features>
+- Agents overview (local/background/cloud): <https://code.visualstudio.com/docs/copilot/agents/overview>
+- Background agents: <https://code.visualstudio.com/docs/copilot/agents/background-agents>
+- Cloud agents: <https://code.visualstudio.com/docs/copilot/agents/cloud-agents>
+- Context engineering guide: <https://code.visualstudio.com/docs/copilot/guides/context-engineering-guide>
+- Prompt engineering guide: <https://code.visualstudio.com/docs/copilot/guides/prompt-engineering-guide>
+- Security considerations (VS Code): <https://code.visualstudio.com/docs/copilot/security>
+- Subagents / chat sessions (VS Code): <https://code.visualstudio.com/docs/copilot/chat/chat-sessions>
 
 GitHub Copilot (cloud) custom agents:
-- Creating custom agents (GitHub docs): https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents
-- Custom agents configuration (GitHub reference): https://docs.github.com/en/copilot/reference/custom-agents-configuration
+
+- Creating custom agents (GitHub docs): <https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents>
+- Custom agents configuration (GitHub reference): <https://docs.github.com/en/copilot/reference/custom-agents-configuration>
 
 ## Deliverables style
 

.github/copilot-instructions.md

@@ -0,0 +1,36 @@
+# Copilot Instructions
+
+These instructions are automatically applied to every Copilot Chat session in this workspace.
+
+## Project Context
+
+This is a **GitHub Copilot Customization Blueprint** — a template repository for bootstrapping
+Copilot agents, prompt files, instructions, and skills in any project.
+
+## Conventions
+
+- All customization files live under `.github/` (agents, prompts, skills, instructions)
+- Use **Conventional Commits** for all commit messages: `<type>(<scope>): <description>`
+- Allowed types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+- Agent files: `.agent.md` with YAML frontmatter (`name`, `description`, `tools` required)
+- Prompt files: `.prompt.md` with YAML frontmatter (`name`, `description` required)
+- Skill files: `SKILL.md` in a named directory under `.github/skills/<name>/`
+- Use `user-invokable` and `disable-model-invocation` instead of the deprecated `infer` field
+
+## File Structure
+
+```
+.github/
+├── agents/           # Custom agent profiles (.agent.md)
+├── prompts/          # Prompt templates (.prompt.md)
+├── skills/           # Agent Skills (each in its own directory with SKILL.md)
+├── workflows/        # GitHub Actions (release, validate, commit-lint)
+└── copilot-instructions.md  # This file
+```
+
+## Code Style
+
+- Markdown: ATX-style headings, fenced code blocks with language identifiers
+- YAML frontmatter: quote strings that contain special characters
+- Shell scripts: use `set -e`, add color output, include usage help
+- Keep lines under 120 characters where practical

.github/workflows/commit-lint.yml

@@ -0,0 +1,105 @@
+name: Validate Commit Messages
+
+on:
+  pull_request:
+    branches:
+      - main
+    types: [opened, synchronize, reopened, edited]
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  commit-lint:
+    name: Conventional Commits Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Validate commit messages
+        run: |
+          echo "## 📋 Commit Message Validation" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+
+          # Conventional commit regex pattern
+          PATTERN='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?(!)?: .+'
+
+          ERROR_COUNT=0
+          TOTAL_COUNT=0
+
+          # Get commits in this PR
+          COMMITS=$(git log origin/${{ github.base_ref }}..HEAD --pretty=format:"%H %s")
+
+          if [ -z "$COMMITS" ]; then
+            echo "ℹ️  No commits to validate" >> $GITHUB_STEP_SUMMARY
+            exit 0
+          fi
+
+          while IFS= read -r line; do
+            HASH=$(echo "$line" | cut -d' ' -f1)
+            MSG=$(echo "$line" | cut -d' ' -f2-)
+            SHORT_HASH=$(echo "$HASH" | cut -c1-7)
+            TOTAL_COUNT=$((TOTAL_COUNT + 1))
+
+            # Skip merge commits
+            if echo "$MSG" | grep -qE "^Merge "; then
+              echo "⏭️ \`$SHORT_HASH\` - Merge commit (skipped)" >> $GITHUB_STEP_SUMMARY
+              continue
+            fi
+
+            if echo "$MSG" | grep -qE "$PATTERN"; then
+              echo "✅ \`$SHORT_HASH\` - $MSG" >> $GITHUB_STEP_SUMMARY
+            else
+              echo "❌ \`$SHORT_HASH\` - $MSG" >> $GITHUB_STEP_SUMMARY
+              ERROR_COUNT=$((ERROR_COUNT + 1))
+            fi
+          done <<< "$COMMITS"
+
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "---" >> $GITHUB_STEP_SUMMARY
+
+          if [ $ERROR_COUNT -gt 0 ]; then
+            echo "### ❌ $ERROR_COUNT of $TOTAL_COUNT commit(s) do not follow Conventional Commits" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "**Required format:** \`<type>(<optional scope>): <description>\`" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "**Allowed types:** \`feat\`, \`fix\`, \`docs\`, \`style\`, \`refactor\`, \`perf\`, \`test\`, \`build\`, \`ci\`, \`chore\`, \`revert\`" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "**Examples:**" >> $GITHUB_STEP_SUMMARY
+            echo "- \`feat: add new copilot skill for debugging\`" >> $GITHUB_STEP_SUMMARY
+            echo "- \`fix(agents): correct yaml frontmatter parsing\`" >> $GITHUB_STEP_SUMMARY
+            echo "- \`docs: update contributing guidelines\`" >> $GITHUB_STEP_SUMMARY
+            echo "- \`feat!: redesign skill file format (BREAKING)\`" >> $GITHUB_STEP_SUMMARY
+            exit 1
+          else
+            echo "### ✅ All $TOTAL_COUNT commit(s) follow Conventional Commits!" >> $GITHUB_STEP_SUMMARY
+          fi
+
+  pr-title-lint:
+    name: PR Title Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate PR title
+        run: |
+          PR_TITLE="${{ github.event.pull_request.title }}"
+          PATTERN='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?(!)?: .+'
+
+          echo "## 📋 PR Title Validation" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Title:** $PR_TITLE" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+
+          if echo "$PR_TITLE" | grep -qE "$PATTERN"; then
+            echo "### ✅ PR title follows Conventional Commits format" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "### ❌ PR title does not follow Conventional Commits format" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "**Required format:** \`<type>(<optional scope>): <description>\`" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "**Allowed types:** \`feat\`, \`fix\`, \`docs\`, \`style\`, \`refactor\`, \`perf\`, \`test\`, \`build\`, \`ci\`, \`chore\`, \`revert\`" >> $GITHUB_STEP_SUMMARY
+            exit 1
+          fi

.github/workflows/release.yml

@@ -217,12 +217,10 @@ jobs:
 
       - name: Create Release
         if: steps.check_release.outputs.needs_release == 'true'
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ steps.new_version.outputs.new_version }}
-          release_name: Release ${{ steps.new_version.outputs.new_version }}
+          name: Release ${{ steps.new_version.outputs.new_version }}
           body: ${{ steps.changelog.outputs.changelog }}
           draft: false
           prerelease: false