diff --git a/.vscode/tasks.json b/.vscode/tasks.json
index cb16ba28..6a50e1ab 100644
--- a/.vscode/tasks.json
+++ b/.vscode/tasks.json
@@ -22,12 +22,12 @@
"dependsOn": "npm install"
},
{
- "label": "validate-collections",
+ "label": "validate-plugins",
"type": "shell",
- "command": "npm run collection:validate",
+ "command": "npm run plugin:validate",
"problemMatcher": [],
"group": "build",
- "detail": "Validates all collection manifest files.",
+ "detail": "Validates all plugin manifest files.",
"dependsOn": "npm install"
},
{
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3d8fba7c..de6cf1bc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -9,8 +9,7 @@ Thank you for your interest in contributing to the Awesome GitHub Copilot reposi
- [Quality Guidelines](#quality-guidelines)
- [How to Contribute](#how-to-contribute)
- [Adding Instructions](#adding-instructions)
- - [Adding Prompts](#adding-prompts)
- - [Adding Agents](#adding-agents)
+ - [Adding Agents](#adding-an-agent)
- [Adding Skills](#adding-skills)
- [Adding Plugins](#adding-plugins)
- [Adding Hooks](#adding-hooks)
diff --git a/agents/terminal-helper.agent.md b/agents/terminal-helper.agent.md
new file mode 100644
index 00000000..3d2c7935
--- /dev/null
+++ b/agents/terminal-helper.agent.md
@@ -0,0 +1,53 @@
+---
+description: 'Fast terminal syntax and command helper for PowerShell and Bash'
+name: 'terminal-helper'
+tools: ['execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection']
+model: GPT-4.1 (copilot)
+---
+
+# Terminal Helper
+
+You are a concise terminal specialist focused on shell syntax, command construction, and fast troubleshooting.
+
+## Scope
+- Support PowerShell and Bash.
+- Make sure you are aware of the current terminal context (Windows PowerShell or WSL Linux Bash or macOS zsh) before answering.
+- Help with one-liners, flags, pipes, quoting, redirection, environment variables, and command composition.
+- Prefer short, copy-pasteable answers that are ready to run.
+
+## Core Behavior
+- Default to command-first answers. Put the exact command in a fenced code block, then add brief notes only when they help.
+- If the user asks why a command failed, inspect the current terminal context first with the terminal tools before guessing.
+- Prefer safe read-only diagnostics before suggesting a fix when the failure mode is unclear.
+- Avoid unrelated code or file changes. This agent is for terminal help, not general implementation work.
+
+## Safety Rules
+- Call out destructive or high-impact commands before suggesting them.
+- Provide a safer alternative first for delete, reset, overwrite, or bulk-modification operations.
+- Do not invent output. If terminal context is unavailable, say so and ask for the missing command or output.
+
+## Shell Guidance
+
+### PowerShell
+- Prefer idiomatic cmdlets when they improve correctness or readability.
+- Respect quoting and interpolation rules, especially the differences between single and double quotes.
+- Prefer object-pipeline patterns over fragile text parsing when practical.
+
+### Bash
+- Prefer portable syntax unless the user explicitly wants Bash-only features.
+- Prefer `rg` over `grep` when available.
+- Use defensive script patterns such as `set -euo pipefail` when giving script examples that should fail fast.
+
+## Tool Usage
+- Prefer answering directly without tool calls for pure syntax or command-construction questions.
+- Use `read/terminalLastCommand` and `execute/getTerminalOutput` when debugging a recent terminal failure.
+- Use `execute/runInTerminal` only when execution is necessary to verify behavior or collect diagnostics.
+
+## Response Format
+- Start with the exact command or commands.
+- Follow with concise notes covering what it does, any important flags, and one likely pitfall when relevant.
+
+## Example Requests
+- PowerShell: find files changed today larger than 10MB
+- Bash: extract the top 20 IPs from access.log
+- Why did this command fail?
diff --git a/docs/README.agents.md b/docs/README.agents.md
index c8a2640d..a4335a3f 100644
--- a/docs/README.agents.md
+++ b/docs/README.agents.md
@@ -214,6 +214,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to
| [Technical Content Evaluator](../agents/technical-content-evaluator.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftechnical-content-evaluator.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftechnical-content-evaluator.agent.md) | Elite technical content editor and curriculum architect for evaluating technical training materials, documentation, and educational content. Reviews for technical accuracy, pedagogical excellence, content flow, code validation, and ensures A-grade quality standards. | |
| [Technical Debt Remediation Plan](../agents/tech-debt-remediation-plan.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftech-debt-remediation-plan.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftech-debt-remediation-plan.agent.md) | Generate technical debt remediation plans for code, tests, and documentation. | |
| [Technical spike research mode](../agents/research-technical-spike.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fresearch-technical-spike.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fresearch-technical-spike.agent.md) | Systematically research and validate technical spike documents through exhaustive investigation and controlled experimentation. | |
+| [Terminal Helper](../agents/terminal-helper.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterminal-helper.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterminal-helper.agent.md) | Fast terminal syntax and command helper for PowerShell and Bash | |
| [Terraform Agent](../agents/terraform.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md) | Terraform infrastructure specialist with automated HCP Terraform workflows. Leverages Terraform MCP server for registry integration, workspace management, and run orchestration. Generates compliant code using latest provider/module versions, manages private registries, automates variable sets, and orchestrates infrastructure deployments with proper validation and security practices. | [terraform](https://github.com/mcp/io.github.hashicorp/terraform-mcp-server)
[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=terraform&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22TFE_TOKEN%253D%2524%257BCOPILOT_MCP_TFE_TOKEN%257D%22%2C%22-e%22%2C%22TFE_ADDRESS%253D%2524%257BCOPILOT_MCP_TFE_ADDRESS%257D%22%2C%22-e%22%2C%22ENABLE_TF_OPERATIONS%253D%2524%257BCOPILOT_MCP_ENABLE_TF_OPERATIONS%257D%22%2C%22hashicorp%252Fterraform-mcp-server%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)
[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=terraform&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22TFE_TOKEN%253D%2524%257BCOPILOT_MCP_TFE_TOKEN%257D%22%2C%22-e%22%2C%22TFE_ADDRESS%253D%2524%257BCOPILOT_MCP_TFE_ADDRESS%257D%22%2C%22-e%22%2C%22ENABLE_TF_OPERATIONS%253D%2524%257BCOPILOT_MCP_ENABLE_TF_OPERATIONS%257D%22%2C%22hashicorp%252Fterraform-mcp-server%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)
[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22TFE_TOKEN%253D%2524%257BCOPILOT_MCP_TFE_TOKEN%257D%22%2C%22-e%22%2C%22TFE_ADDRESS%253D%2524%257BCOPILOT_MCP_TFE_ADDRESS%257D%22%2C%22-e%22%2C%22ENABLE_TF_OPERATIONS%253D%2524%257BCOPILOT_MCP_ENABLE_TF_OPERATIONS%257D%22%2C%22hashicorp%252Fterraform-mcp-server%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D) |
| [Terraform IaC Reviewer](../agents/terraform-iac-reviewer.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-iac-reviewer.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-iac-reviewer.agent.md) | Terraform-focused agent that reviews and creates safer IaC changes with emphasis on state safety, least privilege, module patterns, drift detection, and plan/apply discipline | |
| [Terratest Module Testing](../agents/terratest-module-testing.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterratest-module-testing.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterratest-module-testing.agent.md) | Generate and refactor Go Terratest suites for Terraform modules, including CI-safe patterns, staged tests, and negative-path validation. | |