Skip to content

fix(caretaker-agent): use spec-valid names for two triage-worker skills - #28742

Open
bechor25 wants to merge 1 commit into
google-gemini:mainfrom
bechor25:fix/triage-worker-skill-names
Open

fix(caretaker-agent): use spec-valid names for two triage-worker skills#28742
bechor25 wants to merge 1 commit into
google-gemini:mainfrom
bechor25:fix/triage-worker-skill-names

Conversation

@bechor25

@bechor25 bechor25 commented Aug 9, 2026

Copy link
Copy Markdown

What

Two of the four skills under tools/caretaker-agent/cloudrun/triage-worker/.gemini/skills/ use underscores in their name:

name: code_explorer
name: spec_generator

Why it matters

The Agent Skills specification constrains the name field:

The required name field: … May only contain unicode lowercase alphanumeric characters (a-z, 0-9) and hyphens (-)Must match the parent directory name
https://agentskills.io/specification#name-field

Underscores are outside that set, so skills-ref validate rejects both skills and a strict loader can refuse to register them.

The set is already inconsistent with itself

skill name: valid?
effort effort
quality quality
code_explorer code_explorer ❌ underscore
spec_generator spec_generator ❌ underscore

The change

For each of the two skills, the name field and its directory are renamed together, so the name stays valid and keeps matching its parent directory:

  • code_explorercode-explorer
  • spec_generatorspec-generator

Both skills are invoked by name from .gemini/triage_orchestrator.md, so those three references are updated in the same commit. git grep code_explorer and git grep spec_generator both return nothing afterwards.


Found with AgentCompass, an offline static analyzer for AI-agent repo readiness. Verified by hand against the spec before opening.

`code_explorer` and `spec_generator` contain underscores, which the Agent
Skills spec does not allow in the `name` field — only lowercase
alphanumerics and hyphens. `skills-ref validate` rejects both.

The other two skills in the same directory, `effort` and `quality`,
are already valid, so this brings the set in line with itself.

Renamed the field and the directory for each (the spec also requires the
name to match its parent directory), plus the three invocations in
.gemini/triage_orchestrator.md that address the skills by name.
`git grep` for either old name now returns nothing.

Spec: https://agentskills.io/specification#name-field
@bechor25
bechor25 requested a review from a team as a code owner August 9, 2026 13:09
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request addresses a non-compliance issue where two agent skills contained underscores in their names, violating the Agent Skills specification. By renaming these skills and updating their associated directory paths and internal references, the changes ensure that the skills are correctly validated and registered by the system.

Highlights

  • Compliance with Agent Skills Specification: Renamed two skills, 'code_explorer' and 'spec_generator', to 'code-explorer' and 'spec-generator' to comply with the Agent Skills specification which forbids underscores in names.
  • Directory and Reference Updates: Updated the corresponding skill directories and all references within 'triage_orchestrator.md' to ensure consistency and prevent registration failures.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@github-actions github-actions Bot added the size/s A small PR label Aug 9, 2026
@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown

📊 PR Size: size/S

  • Lines changed: 10
  • Additions: +5
  • Deletions: -5
  • Files changed: 3

@google-cla

google-cla Bot commented Aug 9, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request renames the code_explorer and spec_generator skills to code-explorer and spec-generator respectively, updating both their definition files and the orchestrator markdown file to use hyphens instead of underscores. There are no review comments, and I have no additional feedback to provide.

Note: Security Review has been skipped due to the limited scope of the PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/s A small PR status/need-issue Pull requests that need to have an associated issue.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant