Skip to content

Hide convention and guideline skills from the slash-command menu - #140

Merged
Orrison merged 1 commit into
mainfrom
chore/hide-skills-from-slash-command-menu
Aug 11, 2026
Merged

Hide convention and guideline skills from the slash-command menu#140
Orrison merged 1 commit into
mainfrom
chore/hide-skills-from-slash-command-menu

Conversation

@mxm1070

@mxm1070 mxm1070 commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Ticket(s) or GitHub Issue

N/A

Technical Description

All of common's authored skills under .ai/skills/ are model-loaded convention/guideline modules — the agent activates them automatically by description match, and no human runs them directly. They were nonetheless showing up in the / slash-command menu.

This sets user-invocable: false (VS Code Agent Skills frontmatter, default true) on all 13 common skills, hiding them from the / menu while leaving automatic model invocation intact. Third-party Boost-bundled skills are untouched.

authoring-agent-guidance is also updated to document the two independent invocation axes so future skills are authored correctly:

  • user-invocable: false — model-only skill; hidden from the / menu (current default for common's skills).
  • disable-model-invocation: true — opts a skill out of automatic loading so a human / call is its only trigger (for genuinely human-invoked skills).

Any deployment steps required?

No

Are any Feature Flags and/or Data Migrations that can eventually be removed Added?

No

@mxm1070 mxm1070 added the documentation Improvements or additions to documentation label Aug 7, 2026
@mxm1070 mxm1070 self-assigned this Aug 7, 2026
@canyon-gbs-automation
canyon-gbs-automation Bot requested a lite review from Copilot August 7, 2026 22:02

Copilot AI 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.

Pull request overview

This PR updates all first-party common agent skills to be model-only by explicitly setting user-invocable: false in their YAML frontmatter, preventing them from appearing in the / slash-command menu while keeping automatic loading via description matching intact. It also documents the distinction between “shows in /” vs “auto-loadable by the model” in the authoring-agent-guidance skill to guide future skill authoring.

Changes:

  • Add user-invocable: false frontmatter to all 13 common-authored skills under .ai/skills/.
  • Update authoring-agent-guidance to document the two independent invocation controls: user-invocable and disable-model-invocation.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated no comments.

Show a summary per file
File Description
.ai/skills/writing-tests/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/writing-data-migrations/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/structuring-filament-code/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/managing-settings/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/managing-feature-flags/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/managing-cleanup-tasks/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/local-common-development/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/laravel-best-practices/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/handling-file-uploads/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/creating-permissions/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/code-style-and-static-analysis/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.
.ai/skills/authoring-agent-guidance/SKILL.md Marks the skill as model-only and documents the two invocation axes for future skill authoring.
.ai/skills/archiving-records/SKILL.md Marks the skill as model-only to hide it from the slash-command menu.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@mxm1070
mxm1070 marked this pull request as ready for review August 7, 2026 22:08
@mxm1070
mxm1070 requested a review from a team as a code owner August 7, 2026 22:08
@mxm1070
mxm1070 requested review from Orrison and payal-canyon and removed request for payal-canyon August 7, 2026 22:08
Set user-invocable: false on all common-authored skills so they no longer
appear in the / slash-command menu, while the agent can still load them
automatically by description match. Document the user-invocable /
disable-model-invocation invocation axes in authoring-agent-guidance.
@Orrison
Orrison force-pushed the chore/hide-skills-from-slash-command-menu branch from cdb3fe8 to 2c6556a Compare August 11, 2026 20:43
@Orrison
Orrison self-requested a review August 11, 2026 20:43
@canyon-gbs-automation
canyon-gbs-automation Bot requested a lite review from Copilot August 11, 2026 20:46

Copilot AI commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

One or more custom setup steps configured for this repository failed during this Copilot code review run:

Setup cache environment

Setup steps run before each review. If the review above is missing context, or no review was posted at all, the failing step above may be the cause. See the workflow run for failure details, fix your setup steps configuration, and re-request a review.

Note

You can configure setup steps for Copilot code review separately from Copilot cloud agent with a copilot-code-review.yml file. Read the docs for details.

Copilot AI 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.

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated no new comments.

@Orrison
Orrison merged commit 8be785c into main Aug 11, 2026
10 of 11 checks passed
@Orrison
Orrison deleted the chore/hide-skills-from-slash-command-menu branch August 11, 2026 21:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants