YMSLI AI Registry Marketplace Extension

Browse and install AI Agents, Skills, Instructions, and Plugins directly inside VS Code.

An enhanced VS Code extension that provides a marketplace interface for discovering, installing, and managing AI-powered components within your workspace.

Features

Browse AI Components - Explore Agents, Skills, Instructions, and Plugins in a unified marketplace view.

One-Click Installation - Install components to your workspace or globally with a single button click.

Advanced Search and Filtering - Find components by keyword, category, version, and tags.

Installation Management - Track all installed items in your workspace and view available updates.

Update Notifications - Get notified when new versions of installed components become available.

Flexible Installation Scopes - Install locally per-project or globally for use across all projects.

Component Types

The extension supports four types of components:

Agents - AI-powered autonomous agents stored in .github/agents/

Skills - Reusable AI skill modules stored in .github/skills/

Instructions - Custom instructions for AI behavior stored in .github/instructions/

Plugins - VS Code extension plugins stored in .github/plugins/

Installation paths by scope:

Workspace (local): your-project/.github/<type>/

Global: ~/.copilot/<type>/ (Windows: C:\Users\<username>\.copilot\<type>\)

Getting Started

Prerequisites

VS Code version 1.80.0 or higher is required.

A GitHub Personal Access Token is needed for marketplace access. Create one at: https://github.com/settings/tokens/new with read access to repositories.

Install the Extension

Open VS Code and go to Extensions (Ctrl+Shift+X / Cmd+Shift+X).

Search for "YMSLI Marketplace".

Click Install.

Configure Your GitHub Token

When you first activate the extension, you will be prompted to enter your GitHub Personal Access Token. Tokens are securely stored in VS Code's secret storage and are never shared.

Using the Extension

Open the Marketplace

The marketplace panel appears automatically when you have a workspace folder open. You can manually activate it by pressing Ctrl+Shift+P (Cmd+Shift+P on Mac), typing "Open AI Marketplace", and pressing Enter.

Main Interface

The main interface displays component cards that you can interact with. Each component card shows:

Component name and type

Rating and number of reviews

Version information

Install button for easy installation

View Details button for comprehensive information

Search and Filter

Use the search box to find components by name or keyword.

Filter by component type: Agents, Skills, Instructions, or Plugins.

Filter by category to narrow down results.

Sort results by trending, recently added, most installed, or alphabetically.

Browsing Tabs

Agents Tab - View autonomous AI agents available for installation.

Skills Tab - Explore modular skill components for AI enhancement.

Instructions Tab - Browse custom instruction sets for AI behavior.

Plugins Tab - View VS Code extension plugins.

Installed Tab - See all components installed in your current workspace or globally.

Component Detail Page

Click View Details on any component to open the detail page. This page provides comprehensive information about the component:

Description - A complete overview of what the component does.

Features and Capabilities - List of key features and functionality.

Installation Information - Details about size, dependencies, permissions, and VS Code version requirements.

Configuration Example - Sample configuration in JSON format.

Support and Documentation Links - Official documentation, GitHub repository, and support resources.

Reviews and Ratings - User feedback and ratings.

Version History - Available versions and their changes.

Install Button

Click the Install button to begin the installation process. You'll be asked to choose between Workspace or Global installation scope before the installation begins.

Installing Components

Browse and Search

Open the marketplace and search for or browse the components you need.

Review Component Details

Click View Details on any component to review its full description, features, version history, user reviews, and requirements.

Choose Installation Scope

Workspace Installation - Components are installed in .github/<type>/<name>/ within your project. This is recommended for project-specific components that your team uses together.

Global Installation - Components are installed in ~/.copilot/<type>/<name>/ (Windows: C:\Users\<username>\.copilot\<type>/<name>/). This is recommended for personal tools and utilities you use across multiple projects.

Click Install

After selecting your scope, click the Install button. The extension will download the component, validate it, and extract it to the chosen location. A progress indicator shows the installation status.

Confirm Installation

Once installation completes successfully, you'll see a confirmation message. The component is now ready to use.

Managing Installed Components

View Installed Components

Go to the Installed tab to see all components installed in your workspace. You can filter by Workspace or Global scope. Each component shows its installation location, size, version, and installation date.

Check for Updates

In the Installed tab, components with available updates display an "Update Available" badge. Click the Update button to review changes and install the new version.

Uninstall Components

To remove a component, go to the Installed tab, find the component, and click the Uninstall button. You can also manually delete the component folder from your file system.

Manual File Management

You can also manage components directly in your file system:

Workspace components are in your project's .github/ folder.

Global components are in ~/.copilot/ (Windows: C:\Users\<username>\.copilot\).

Delete component folders directly to uninstall.

Copy components between machines by transferring the component folders.

Troubleshooting

Extension Won't Activate

Check your VS Code version is 1.80.0 or higher. Open Help > About VS Code to verify.

Try reloading the extension: Ctrl+Shift+P, then type "Developer: Reload Window".

Check the extension logs by opening the Output panel (Ctrl+Shift+P, type "Output: Show Output Channel") and selecting "YMSLI AI Registry".

If the problem persists, uninstall and reinstall the extension.

GitHub Token Issues

Verify your token has been created with repo (read access) scope at https://github.com/settings/tokens.

Tokens are stored securely and cannot be viewed after creation. If you forget your token, create a new one.

To update your token, clear the stored token in VS Code and re-enter it when prompted.

Installation Fails

Ensure you have sufficient disk space for the component and its dependencies.

Check your internet connection.

Verify the component is compatible with your VS Code version.

Try installing in Workspace scope first if Global installation fails.

Components Not Appearing

Refresh the marketplace view by closing and reopening the panel.

Check that your workspace folder is open and properly recognized by VS Code.

Verify your GitHub token is still valid.

Clear VS Code cache if needed: Delete the .vscode folder in your workspace and reload.

Search Not Working

Verify your GitHub token is active and has read access.

Try clearing the search box and performing a fresh search.

Check your internet connection.

Version

Version: 0.0.6