Improves agent formatting and minor fixes

[cogni-ai-ee]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• I have read and followed the Guidance for submissions involving paid services.
• My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
• I have run npm start and verified that README.md is up to date.
• I am targeting the staged branch for this pull request.

---

Description

This PR provides the following fixes:

• Formatting and linting fixes, a lot of them report issues (e.g. markdownlint, yamllint), split too long lines and other issues.
• Fixes invalid/outdated tools, I've tested them directly in recent VS Code.
• Simplify some of the instructions.

---

Type of Contribution

• New instruction file.
• New prompt file.
• New agent file.
• New plugin.
• New skill file.
• New agentic workflow.
• Update to existing instruction, prompt, agent, plugin, skill, or workflow.
• Other (please specify):

---

Additional Notes

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

[github-actions]

⚠️ This PR targets main, but PRs should target staged.

The main branch is auto-published from staged and should not receive direct PRs.
Please close this PR and re-open it against the staged branch.

You can change the base branch using the Edit button at the top of this PR,
or run: gh pr edit 1559 --base staged

[Copilot]

Pull request overview

This PR focuses on standardizing agent file formatting and updating agent tool declarations/documentation so the cataloged agents work with current GitHub Copilot/VS Code tool identifiers.

Changes:

• Reformats multiple .agent.md files (front matter wrapping, headings, spacing, code fences) to satisfy linting/markdown rules.
• Updates several agents’ tools: lists and related naming in docs/README.agents.md.
• Renames/retitles a few agents for clearer presentation in the agents README table.

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
docs/README.agents.md	Updates displayed agent names and adds/removes table entries to match updated agents.
agents/terraform.agent.md	Reformats content and pins Terraform MCP Docker image version in the embedded server config.
agents/terraform-iac-reviewer.agent.md	Updates tools list and restructures sections with clearer formatting.
agents/tech-debt-remediation-plan.agent.md	Renames agent and updates tool list to newer tool identifiers.
agents/task-researcher.agent.md	Updates tools list + updates the required web/githubRepo: / fetch: callout format.
agents/task-planner.agent.md	Updates tools list to newer identifiers and minor formatting tweaks.
agents/research-technical-spike.agent.md	Replaces older tool set with newer tool identifiers and adjusts formatting.
agents/refine-issue.agent.md	Renames agent and updates tools list to use web/githubRepo.
agents/prompt-engineer.agent.md	Wraps description and reformats guidance text/headings.
agents/prompt-builder.agent.md	Updates tools list and refactors formatting/structure throughout the instructions.
agents/platform-sre-kubernetes.agent.md	Updates tools list and improves section formatting.
agents/planner.agent.md	Updates tools list to newer identifiers.
agents/plan.agent.md	Consolidates tools list formatting and updates naming/punctuation (en dash) + wrapping.
agents/github-actions-expert.agent.md	Updates tools list and rewrites action pinning guidance/checklist wording.
agents/devops-expert.agent.md	Updates tools list and reformats content into clearer sections.
agents/critical-thinking.agent.md	Renames agent and updates tools list + formatting/punctuation.
agents/code-tour.agent.md	Line-wraps long text and modifies example snippets for markdown formatting.
agents/Thinking-Beast-Mode.agent.md	Adds tools list + reformats headings and long lines throughout.

[github-actions]

🔍 Skill Validator Results

⛔ Findings need attention

Scope	Checked
Skills	1
Agents	18
Total	19
Severity	Count
---	---:
❌ Errors	36
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
❌	[agent:Accessibility Runtime Tester] Agent name 'Accessibility Runtime Tester' does not match filename 'accessibility-runtime-tester.agent.md' (expected 'Accessibility Runtime Tester.agent.md').
❌	[agent:Accessibility Runtime Tester] Agent name 'Accessibility Runtime Tester' contains invalid characters — must be lowercase alphanumeric and hyphens only.
❌	[agent:VSCode Tour Expert] Agent name 'VSCode Tour Expert' does not match filename 'code-tour.agent.md' (expected 'VSCode Tour Expert.agent.md').
❌	[agent:VSCode Tour Expert] Agent name 'VSCode Tour Expert' contains invalid characters — must be lowercase alphanumeric and hyphens only.
❌	[agent:Critical Thinking Assistant] Agent name 'Critical Thinking Assistant' does not match filename 'critical-thinking.agent.md' (expected 'Critical Thinking Assistant.agent.md').
❌	[agent:Critical Thinking Assistant] Agent name 'Critical Thinking Assistant' contains invalid characters — must be lowercase alphanumeric and hyphens only.
❌	[agent:DevOps Expert] Agent name 'DevOps Expert' does not match filename 'devops-expert.agent.md' (expected 'DevOps Expert.agent.md').
❌	[agent:DevOps Expert] Agent name 'DevOps Expert' contains invalid characters — must be lowercase alphanumeric and hyphens only.
❌	[agent:GitHub Actions Expert] Agent name 'GitHub Actions Expert' does not match filename 'github-actions-expert.agent.md' (expected 'GitHub Actions Expert.agent.md').
❌	[agent:GitHub Actions Expert] Agent name 'GitHub Actions Expert' contains invalid characters — must be lowercase alphanumeric and hyphens only.

Full validator output

```text Found 18 agent(s) ❌ [agent:Accessibility Runtime Tester] Agent name 'Accessibility Runtime Tester' does not match filename 'accessibility-runtime-tester.agent.md' (expected 'Accessibility Runtime Tester.agent.md'). ❌ [agent:Accessibility Runtime Tester] Agent name 'Accessibility Runtime Tester' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:VSCode Tour Expert] Agent name 'VSCode Tour Expert' does not match filename 'code-tour.agent.md' (expected 'VSCode Tour Expert.agent.md'). ❌ [agent:VSCode Tour Expert] Agent name 'VSCode Tour Expert' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Critical Thinking Assistant] Agent name 'Critical Thinking Assistant' does not match filename 'critical-thinking.agent.md' (expected 'Critical Thinking Assistant.agent.md'). ❌ [agent:Critical Thinking Assistant] Agent name 'Critical Thinking Assistant' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:DevOps Expert] Agent name 'DevOps Expert' does not match filename 'devops-expert.agent.md' (expected 'DevOps Expert.agent.md'). ❌ [agent:DevOps Expert] Agent name 'DevOps Expert' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:GitHub Actions Expert] Agent name 'GitHub Actions Expert' does not match filename 'github-actions-expert.agent.md' (expected 'GitHub Actions Expert.agent.md'). ❌ [agent:GitHub Actions Expert] Agent name 'GitHub Actions Expert' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Plan Mode – Strategic Planning & Architecture] Agent name 'Plan Mode – Strategic Planning & Architecture' does not match filename 'plan.agent.md' (expected 'Plan Mode – Strategic Planning & Architecture.agent.md'). ❌ [agent:Plan Mode – Strategic Planning & Architecture] Agent name 'Plan Mode – Strategic Planning & Architecture' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Planning mode instructions] Agent name 'Planning mode instructions' does not match filename 'planner.agent.md' (expected 'Planning mode instructions.agent.md'). ❌ [agent:Planning mode instructions] Agent name 'Planning mode instructions' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Platform SRE for Kubernetes] Agent name 'Platform SRE for Kubernetes' does not match filename 'platform-sre-kubernetes.agent.md' (expected 'Platform SRE for Kubernetes.agent.md'). ❌ [agent:Platform SRE for Kubernetes] Agent name 'Platform SRE for Kubernetes' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Prompt Builder] Agent name 'Prompt Builder' does not match filename 'prompt-builder.agent.md' (expected 'Prompt Builder.agent.md'). ❌ [agent:Prompt Builder] Agent name 'Prompt Builder' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Prompt Engineer] Agent name 'Prompt Engineer' does not match filename 'prompt-engineer.agent.md' (expected 'Prompt Engineer.agent.md'). ❌ [agent:Prompt Engineer] Agent name 'Prompt Engineer' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Issue Refinement Assistant] Agent name 'Issue Refinement Assistant' does not match filename 'refine-issue.agent.md' (expected 'Issue Refinement Assistant.agent.md'). ❌ [agent:Issue Refinement Assistant] Agent name 'Issue Refinement Assistant' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Technical spike research mode] Agent name 'Technical spike research mode' does not match filename 'research-technical-spike.agent.md' (expected 'Technical spike research mode.agent.md'). ❌ [agent:Technical spike research mode] Agent name 'Technical spike research mode' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Task Planner Instructions] Agent name 'Task Planner Instructions' does not match filename 'task-planner.agent.md' (expected 'Task Planner Instructions.agent.md'). ❌ [agent:Task Planner Instructions] Agent name 'Task Planner Instructions' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Task Researcher Instructions] Agent name 'Task Researcher Instructions' does not match filename 'task-researcher.agent.md' (expected 'Task Researcher Instructions.agent.md'). ❌ [agent:Task Researcher Instructions] Agent name 'Task Researcher Instructions' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Technical Debt Remediation Planner] Agent name 'Technical Debt Remediation Planner' does not match filename 'tech-debt-remediation-plan.agent.md' (expected 'Technical Debt Remediation Planner.agent.md'). ❌ [agent:Technical Debt Remediation Planner] Agent name 'Technical Debt Remediation Planner' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Terraform IaC Reviewer] Agent name 'Terraform IaC Reviewer' does not match filename 'terraform-iac-reviewer.agent.md' (expected 'Terraform IaC Reviewer.agent.md'). ❌ [agent:Terraform IaC Reviewer] Agent name 'Terraform IaC Reviewer' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Terraform Agent] Agent name 'Terraform Agent' does not match filename 'terraform.agent.md' (expected 'Terraform Agent.agent.md'). ❌ [agent:Terraform Agent] Agent name 'Terraform Agent' contains invalid characters — must be lowercase alphanumeric and hyphens only. ❌ [agent:Thinking Beast Mode] Agent name 'Thinking Beast Mode' does not match filename 'thinking-beast-mode.agent.md' (expected 'Thinking Beast Mode.agent.md'). ❌ [agent:Thinking Beast Mode] Agent name 'Thinking Beast Mode' contains invalid characters — must be lowercase alphanumeric and hyphens only. Validated 18 agent(s)

{Ansi.Red}Agent spec conformance failures — fix the errors above.{Ansi.Reset}

</details>
> **Note:** The validator returned a non-zero exit code. Please review the findings above before merge.

[cogni-ai-ee]

[agent:Thinking Beast Mode] Agent name 'Thinking Beast Mode' does not match filename 'Thinking-Beast-Mode.agent.md' (expected 'Thinking Beast Mode.agent.md').

I didn't change the agent names, why the tests are failing then?

[Copilot]

Pull request overview

Copilot reviewed 19 out of 19 changed files in this pull request and generated 4 comments.

Comments suppressed due to low confidence (1)

agents/refine-issue.agent.md:9

• The front matter name is now "Issue Refinement Assistant", but the H1 still says "Refine Requirement or Issue Chat Mode". Please update the heading (and optionally the first sentence) to match the new agent name for consistency.

name: 'Issue Refinement Assistant'
tools: ['list_issues', 'web/githubRepo', 'search', 'add_issue_comment', 'create_issue', 'create_issue_comment', 'update_issue', 'delete_issue', 'get_issue', 'search_issues']
---

# Refine Requirement or Issue Chat Mode

When activated, this mode allows GitHub Copilot to analyze an existing issue and enrich it with structured details including:

[aaronpowell]

There appears to be a lot of pointless noise in this PR, adding whitespace and line breaks with little to no value. While it could be argued that the updates to the tool names are useful, it's lost in the noise of the rest of the PR.