Standardise Naming and Description fields #582
Closed
+276
−236
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
There was a problem hiding this comment.
Pull request overview
This PR standardizes the naming and description format across all agent definition files to ensure consistent display in VS Code and other environments. The changes enforce a uniform structure where agent definitions begin with a name field in Title Case, followed by a description field in Sentence case, with both values enclosed in double quotes instead of single quotes.
Changes:
- Standardized quote style from single quotes to double quotes for
nameanddescriptionfields - Ensured
namefield appears beforedescriptionfield in the front matter - Added missing
namefields to agent definitions that lacked them - Applied Title Case formatting to agent names and Sentence case to descriptions
Reviewed changes
Copilot reviewed 135 out of 135 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| agents/wg-code-sentinel.agent.md | Added name field and standardized quotes |
| agents/wg-code-alchemist.agent.md | Added name field and standardized quotes |
| agents/voidbeast-gpt41enhanced.agent.md | Added name field and standardized quotes |
| agents/typescript-mcp-expert.agent.md | Reordered fields to place name before description |
| agents/terraform.agent.md | Changed quotes from none to double quotes |
| agents/terraform-iac-reviewer.agent.md | Changed quotes from single to double quotes |
| agents/terraform-azure-planning.agent.md | Reordered fields to place name before description |
| agents/terraform-azure-implement.agent.md | Reordered fields to place name before description |
| agents/technical-content-evaluator.agent.md | Changed name value to Title Case and standardized quotes |
| agents/tech-debt-remediation-plan.agent.md | Added name field and standardized quotes |
| agents/tdd-refactor.agent.md | Reordered fields to place name before description |
| agents/tdd-red.agent.md | Reordered fields to place name before description |
| agents/tdd-green.agent.md | Reordered name and description fields, standardized quotes |
| agents/task-researcher.agent.md | Reordered fields to place name before description |
| agents/task-planner.agent.md | Reordered fields to place name before description |
| agents/swift-mcp-expert.agent.md | Reordered fields to place name before description |
| agents/stackhawk-security-onboarding.agent.md | Changed name to Title Case and standardized quotes |
| agents/specification.agent.md | Added name field and standardized quotes |
| agents/software-engineer-agent-v1.agent.md | Added name field and standardized quotes |
| agents/simple-app-idea-generator.agent.md | Added name field and standardized quotes |
| agents/shopify-expert.agent.md | Added name field and standardized quotes |
| agents/semantic-kernel-python.agent.md | Added name field and standardized quotes |
| agents/semantic-kernel-dotnet.agent.md | Added name field and standardized quotes |
| agents/search-ai-optimization-expert.agent.md | Added name field and standardized quotes |
| agents/se-ux-ui-designer.agent.md | Changed quotes from single to double quotes |
| agents/se-technical-writer.agent.md | Changed quotes from single to double quotes |
| agents/se-system-architecture-reviewer.agent.md | Changed quotes from single to double quotes |
| agents/se-security-reviewer.agent.md | Changed quotes from single to double quotes |
| agents/se-responsible-ai-code.agent.md | Changed quotes from single to double quotes |
| agents/se-product-manager-advisor.agent.md | Changed quotes from single to double quotes |
| agents/se-gitops-ci-specialist.agent.md | Changed quotes from single to double quotes |
| agents/salesforce-expert.agent.md | Reordered fields to place name before description |
| agents/rust-mcp-expert.agent.md | Reordered fields to place name before description |
| agents/rust-gpt-4.1-beast-mode.agent.md | Reordered fields and removed empty line |
| agents/ruby-mcp-expert.agent.md | Reordered fields to place name before description |
| agents/research-technical-spike.agent.md | Changed name to Title Case and reordered fields |
| agents/refine-issue.agent.md | Added name field and standardized quotes |
| agents/python-mcp-expert.agent.md | Reordered fields to place name before description |
| agents/prompt-engineer.agent.md | Added name field |
| agents/prompt-builder.agent.md | Added name field and standardized quotes |
| agents/principal-software-engineer.agent.md | Added name field and standardized quotes |
| agents/prd.agent.md | Reordered fields to place name before description |
| agents/power-platform-mcp-integration-expert.agent.md | Reordered fields to place name before description |
| agents/power-platform-expert.agent.md | Reordered fields to place name before description |
| agents/power-bi-visualization-expert.agent.md | Reordered fields to place name before description |
| agents/power-bi-performance-expert.agent.md | Reordered fields to place name before description |
| agents/power-bi-dax-expert.agent.md | Reordered fields to place name before description |
| agents/power-bi-data-modeling-expert.agent.md | Reordered fields to place name before description |
| agents/postgresql-dba.agent.md | Reordered fields to place name before description |
| agents/playwright-tester.agent.md | Reordered fields to place name before description |
| agents/platform-sre-kubernetes.agent.md | Changed quotes from single to double quotes |
| agents/planner.agent.md | Changed name to Title Case and reordered fields |
| agents/plan.agent.md | Reordered fields and adjusted name format |
| agents/pimcore-expert.agent.md | Added name field and standardized quotes |
| agents/php-mcp-expert.agent.md | Reordered fields to place name before description |
| agents/pagerduty-incident-responder.agent.md | Standardized quotes |
| agents/octopus-deploy-release-notes-mcp.agent.md | Changed name to Title Case and standardized quotes |
| agents/neon-optimization-analyzer.agent.md | Standardized quotes |
| agents/neon-migration-specialist.agent.md | Standardized quotes |
| agents/neo4j-docker-client-generator.agent.md | Changed name to Title Case and standardized quotes |
| agents/ms-sql-dba.agent.md | Changed name to standardize format and reordered fields |
| agents/mongodb-performance-advisor.agent.md | Changed name to Title Case and standardized quotes |
| agents/monday-bug-fixer.agent.md | Standardized quotes |
| agents/modernization.agent.md | Added name field and standardized quotes |
| agents/microsoft_learn_contributor.agent.md | Added name field and standardized quotes |
| agents/microsoft-study-mode.agent.md | Added name field and standardized quotes |
| agents/microsoft-agent-framework-python.agent.md | Added name field |
| agents/microsoft-agent-framework-dotnet.agent.md | Added name field |
| agents/meta-agentic-project-scaffold.agent.md | Reordered fields to place name before description |
| agents/mentor.agent.md | Added name field and standardized quotes |
| agents/mcp-m365-agent-expert.agent.md | Reordered fields to place name before description |
| agents/lingodotdev-i18n.agent.md | Standardized quotes |
| agents/launchdarkly-flag-cleanup.agent.md | Changed name to Title Case, standardized quotes, and simplified description |
| agents/laravel-expert-agent.agent.md | Added name field and standardized quotes |
| agents/kusto-assistant.agent.md | Added name field |
| agents/kotlin-mcp-expert.agent.md | Reordered fields to place name and description before model |
| agents/jfrog-sec.agent.md | Standardized quotes |
| agents/java-mcp-expert.agent.md | Reordered fields to place name before description |
| agents/janitor.agent.md | Added name field and standardized quotes |
| agents/implementation-plan.agent.md | Reordered fields to place name before description |
| agents/hlbpa.agent.md | Added name field and standardized quotes |
| agents/gpt-5-beast-mode.agent.md | Added name field, standardized quotes, and removed duplicate name field |
| agents/go-mcp-expert.agent.md | Reordered fields to place name and description before model |
| agents/github-actions-expert.agent.md | Changed quotes from single to double quotes |
| agents/gilfoyle.agent.md | Added name field and standardized quotes |
| agents/expert-react-frontend-engineer.agent.md | Reordered fields to place name before description |
| agents/expert-nextjs-developer.agent.md | Added name field |
| agents/expert-dotnet-software-engineer.agent.md | Changed name to Title Case and reordered fields |
| agents/expert-cpp-software-engineer.agent.md | Added name field and standardized quotes |
| agents/electron-angular-native.agent.md | Reordered fields to place name before description |
| agents/elasticsearch-observability.agent.md | Changed name to Title Case and standardized quotes |
| agents/dynatrace-expert.agent.md | Standardized quotes |
| agents/drupal-expert.agent.md | Added name field and standardized quotes |
| agents/droid.agent.md | Changed name to Title Case and standardized quotes |
| agents/dotnet-upgrade.agent.md | Added name field and standardized quotes |
| agents/dotnet-maui.agent.md | Standardized quotes |
| agents/diffblue-cover.agent.md | Standardized quotes |
| agents/devops-expert.agent.md | Changed quotes from single to double quotes |
| agents/demonstrate-understanding.agent.md | Added name field and standardized quotes |
| agents/declarative-agents-architect.agent.md | Added name and description fields |
| agents/debug.agent.md | Added name field and standardized quotes |
| agents/custom-agent-foundry.agent.md | Reordered fields and standardized quotes |
| agents/csharp-mcp-expert.agent.md | Reordered fields to place name before description |
| agents/csharp-dotnet-janitor.agent.md | Added name field and standardized quotes |
| agents/critical-thinking.agent.md | Added name field and standardized quotes |
| agents/context7.agent.md | Changed name format and standardized quotes |
| agents/comet-opik.agent.md | Standardized quotes |
| agents/code-tour.agent.md | Reordered fields and standardized quotes |
| agents/clojure-interactive-programming.agent.md | Reordered fields to place name before description |
| agents/blueprint-mode.agent.md | Added name field, reordered fields, and standardized quotes |
| agents/blueprint-mode-codex.agent.md | Added name field, reordered fields, and standardized quotes |
| agents/bicep-plan.agent.md | Added name field and standardized quotes |
| agents/bicep-implement.agent.md | Added name field and standardized quotes |
| agents/azure-verified-modules-terraform.agent.md | Changed name to Title Case and reordered fields |
| agents/azure-verified-modules-bicep.agent.md | Changed name to Title Case and reordered fields |
| agents/azure-saas-architect.agent.md | Changed name to Title Case and reordered fields |
| agents/azure-principal-architect.agent.md | Changed name to Title Case and reordered fields |
| agents/azure-logic-apps-expert.agent.md | Reordered fields to place name before description |
| agents/azure-iac-generator.agent.md | Changed name to Title Case |
| agents/azure-iac-exporter.agent.md | Changed name to Title Case |
| agents/atlassian-requirements-to-jira.agent.md | Added name field and standardized quotes |
| agents/arm-migration.agent.md | Changed name to Title Case |
| agents/arch.agent.md | Removed empty line and standardized quotes |
| agents/apify-integration-expert.agent.md | Changed name to Title Case |
| agents/api-architect.agent.md | Added name field and standardized quotes |
| agents/amplitude-experiment-implementation.agent.md | Standardized quotes |
| agents/aem-frontend-specialist.agent.md | Added name field and standardized quotes |
| agents/adr-generator.agent.md | Standardized quotes |
| agents/address-comments.agent.md | Added name field |
| agents/accessibility.agent.md | Added name field and standardized quotes |
| agents/WinFormsExpert.agent.md | Standardized quotes |
| agents/Ultimate-Transparent-Thinking-Beast-Mode.agent.md | Changed quotes from single to double quotes |
| agents/Thinking-Beast-Mode.agent.md | Reordered fields and standardized quotes |
| agents/CSharpExpert.agent.md | Standardized quotes |
| agents/4.1-Beast.agent.md | Added name field, standardized quotes, and reordered fields |
Contributor
|
As I mentioned on #563 I don't see these changes providing a large amount of added value relative to the overhead that is added. There are just shy of 150 files changed in this PR alone, and while they are "small changes" it's still changes that need to be reviewed. A quick scan on some of the changes and they aren't doing much more than wrapping values in double quotes or changing the order of fields in the front matter. A change like this represents a point-in-time change to the repo, but what happens on the next PR adding an agent? Should it be reviewed to force the consistency? That has the potential for some back-and-forth with the contributor that are purely stylistic and provide no difference in behaviour to the end user. There might be changes that are addressing something that's incorrect, like an unfriendly name being displayed for an agent, and if that's the case let's get a PR to fix that rather than having it in amongst what is really a lot of changes that don't have any really tangible benefit. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Agent definitions should follow a standard format at the top of each agent file so that they display consistently in e.g. VSCode
Agent definition starts with Name, followed by Description
Agent name is in Title Case
Agent description is in Sentence case
Name and Description values are both enclosed in double quotes