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_skills flag 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) ✅ Merged
2 Add Skills project sidebar menu item !267449 (merged) ✅ Merged
3 Register skill as an AI catalog item type !267460 (merged) ✅ Merged
4 Fall back to the git author name in item attribution !267461 (merged) ✅ 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) ✅ Merged
7 Add Skills tab to the Explore AI catalog 👈 You are here
8 Add the skill details page !268788 (merged)

References

Screenshots or screen recordings

Before After (Empty state) After (With items)
Explore skills before.png Explore skills empty state.png Explore skills after.png

How to set up and validate locally

  1. In the Rails console, run Feature.enable(:ai_catalog_skills).

  2. 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
  3. Run bin/rake "gitlab:ai_catalog:publish_skills[<project_path>]".

  4. Visit /explore/ai-catalog/skills. The Skills tab is active, and the skill shows without a usage count.

  5. Select the skill. The details page opens without an error.

  6. Delete the file and run the rake task again. The Skills tab shows the empty state.

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

🤖 Generated with Claude Code

Edited by Justin Ho Tuan Duong

Merge request reports

Loading
Loading