claude-code - 💡(How to fix) Fix Feature request: customizable skill display order in / menu [1 comments, 2 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
anthropics/claude-code#49626Fetched 2026-04-17 08:35:51
View on GitHub
Comments
1
Participants
2
Timeline
3
Reactions
0
Author
Timeline (top)
labeled ×2commented ×1

Code Example

---
name: session-start
description: Session start protocol
order: 1
---
RAW_BUFFERClick to expand / collapse

Feature Request

Is your feature request related to a problem?

When typing / to invoke skills, the menu displays skills in an order that cannot be customized. Frequently used automation skills (e.g., cron-triggered bookmark processing) appear at the top, pushing manually-invoked skills (like session-start / session-end) further down.

Describe the solution you'd like

Add an optional order or priority field to SKILL.md frontmatter that controls the display position in the / skill menu.

Example:

---
name: session-start
description: Session start protocol
order: 1
---

Lower order values appear first. Skills without order are sorted after ordered skills using the current default logic.

Describe alternatives you've considered

  • Typing partial names (e.g., /ses) to filter — works but adds friction for daily-use skills
  • Renaming skill directories with numeric prefixes (e.g., 01-session-start) — changes the invocation name, poor UX

Additional context

In our setup, we have 14+ user-invocable skills. The two most important (session-start, session-end) are buried below automation skills that happen to have higher usage frequency. A simple numeric sort field in frontmatter would solve this cleanly.

extent analysis

TL;DR

Adding an optional order or priority field to the SKILL.md frontmatter could allow for customizing the display position of skills in the / skill menu.

Guidance

  • Consider the proposed solution of adding an order field to the frontmatter of SKILL.md files to control the display order in the / skill menu.
  • Evaluate the impact of adding this feature on the existing skill invocation logic and user experience.
  • Review the current sorting logic for skills without an order field to ensure they are properly integrated with the new ordering system.
  • Assess the potential for conflicts or inconsistencies in the ordering when multiple skills have the same order value.

Example

---
name: session-start
description: Session start protocol
order: 1
---

This example shows how the proposed order field could be added to a SKILL.md file to specify its display position.

Notes

The implementation of this feature would require changes to the skill menu rendering logic to respect the order field. Additionally, consideration should be given to how skills with missing or duplicate order values are handled.

Recommendation

Apply workaround: Implement the proposed order field in the SKILL.md frontmatter to allow for customizable skill display order, as it directly addresses the described problem and provides a straightforward solution.

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

claude-code - 💡(How to fix) Fix Feature request: customizable skill display order in / menu [1 comments, 2 participants]