Add Skills tab to the Explore AI catalog
What does this MR do and why?
Add a Skills tab to the Explore AI catalog, based on the iteration 1 designs in #630405 (closed) (screens 1a and 1b):
- The Skills tab shows between Flows and MCP. It shows only when the
ai_catalog_skillsflag is on. - The skills list has its own empty state, with a link to the Agent Skills documentation. It has no New skill button, because creating a skill from the UI is #630883.
- Skill rows do not show the usage count. Nothing consumes a skill yet, so the count is always 0.
This MR also maps skills to the custom_skill event item type, the same value that the backend sends. Without it, the skill details page throws an error when it mounts.
The skill details page still shows the shared header only. MR 8 adds the skill details.
This is MR 7 of the split of !260396 (closed). All parts are behind the ai_catalog_skills flag (default off).
| # | MR | Status |
|---|---|---|
| 1 | Add routes for AI catalog skills | !266269 (merged) |
| 2 | Add Skills project sidebar menu item | !267449 (merged) |
| 3 | Register skill as an AI catalog item type | !267460 (merged) |
| 4 | Fall back to the git author name in item attribution | !267461 (merged) |
| 5 | Support skills in the version alert and enable disclaimer | !268927 (merged) |
| 6 | Add skills routes to the Explore and project Vue routers | !267907 (merged) |
| 7 | Add Skills tab to the Explore AI catalog | |
| 8 | Add the skill details page | !268788 (merged) |
References
- Related #630880 (closed)
- Epic: gitlab-org#22961
- Design issue: #630405 (closed)
- Designs
- Rollout issue: #630885
- Split from !260396 (closed)
Screenshots or screen recordings
| Before | After (Empty state) | After (With items) |
|---|---|---|
![]() |
![]() |
![]() |
How to set up and validate locally
-
In the Rails console, run
Feature.enable(:ai_catalog_skills). -
In a project, add
skills/security-review/SKILL.md:--- name: security-review description: Checks merge request changes against the team security checklist. metadata: gitlab.visibility: public --- # Security review -
Run
bin/rake "gitlab:ai_catalog:publish_skills[<project_path>]". -
Visit
/explore/ai-catalog/skills. The Skills tab is active, and the skill shows without a usage count. -
Select the skill. The details page opens without an error.
-
Delete the file and run the rake task again. The Skills tab shows the empty state.
-
Run
Feature.disable(:ai_catalog_skills). The Skills tab is gone.
MR acceptance checklist
Evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.


