gemini-cli - 💡(How to fix) Fix Add path-based skill visibility controls for .agents/skills [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
google-gemini/gemini-cli#25833Fetched 2026-04-23 07:44:40
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
0
Participants
Timeline (top)
issue_type_added ×1labeled ×1

Gemini CLI discovers skills from both .gemini/skills and .agents/skills. That works for shared skills, but it breaks down in mixed-tool repos where .agents/skills contains some skills that should be shared and some that should only be used by another tool such as Codex. Today the workaround is skills.disabled, but that is name-based and external to the repo layout.

Root Cause

Gemini CLI discovers skills from both .gemini/skills and .agents/skills. That works for shared skills, but it breaks down in mixed-tool repos where .agents/skills contains some skills that should be shared and some that should only be used by another tool such as Codex. Today the workaround is skills.disabled, but that is name-based and external to the repo layout.

Fix Action

Fix / Workaround

Summary

Gemini CLI discovers skills from both .gemini/skills and .agents/skills. That works for shared skills, but it breaks down in mixed-tool repos where .agents/skills contains some skills that should be shared and some that should only be used by another tool such as Codex. Today the workaround is skills.disabled, but that is name-based and external to the repo layout.

Code Example

{
  "skills": {
    "excludeGlobs": [
      ".agents/skills/codex-only/**"
    ]
  }
}

---

{
  "skills": {
    "includePaths": [
      ".gemini/skills",
      ".agents/skills/shared"
    ]
  }
}
RAW_BUFFERClick to expand / collapse

What would you like to be added?

Summary

Gemini CLI discovers skills from both .gemini/skills and .agents/skills. That works for shared skills, but it breaks down in mixed-tool repos where .agents/skills contains some skills that should be shared and some that should only be used by another tool such as Codex. Today the workaround is skills.disabled, but that is name-based and external to the repo layout.

Why is this needed?

Problem

A common setup is:

  • .agents/skills for shared skills
  • .gemini/skills for Gemini-specific skills The issue is that Gemini also discovers repo-local skills in .agents/skills that are not intended for Gemini. This is manageable in small setups, but it becomes awkward as the number of skills grows or when the repo is used across multiple machines/users.

Request

Please add a more precise way to control skill visibility, ideally path-based include/exclude rules for discovery. For example:

{
  "skills": {
    "excludeGlobs": [
      ".agents/skills/codex-only/**"
    ]
  }
}

or:

{
  "skills": {
    "includePaths": [
      ".gemini/skills",
      ".agents/skills/shared"
    ]
  }
}

A metadata-based approach on individual skills would also work.

Why this would help

This would let users cleanly express:

  • shared skills
  • Gemini-only skills
  • non-Gemini skills

without relying on a denylist by skill name.

Minimal feature that would solve it

Path/glob-based exclude support for skill discovery.

Non-goal

I am not asking to change the default discovery behavior.

I am asking for an opt-in way to make skill visibility more precise in mixed-tool repos.

Additional context

No response

extent analysis

TL;DR

Implementing path-based include/exclude rules for skill discovery would allow for more precise control over skill visibility in mixed-tool repositories.

Guidance

  • Introduce a configuration option to specify include or exclude paths for skill discovery, such as excludeGlobs or includePaths, to filter skills based on their location.
  • Consider using glob patterns to match skill paths, allowing for flexible and expressive rules.
  • Evaluate the trade-offs between include-based and exclude-based approaches to determine the best fit for the use case.
  • Assess the potential impact on existing workflows and repositories when introducing this new feature.

Example

{
  "skills": {
    "excludeGlobs": [
      ".agents/skills/codex-only/**"
    ]
  }
}

This example demonstrates how a user could exclude skills in the .agents/skills/codex-only directory and its subdirectories from being discovered by Gemini.

Notes

The proposed solution focuses on introducing a new configuration option to control skill visibility, without altering the default discovery behavior. This approach should be compatible with existing repositories and workflows.

Recommendation

Apply a workaround by introducing a configuration option for path-based include/exclude rules, as this would provide a more precise way to control skill visibility in mixed-tool repositories.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING