🎨 Prompt Registry

A visual marketplace for discovering, installing, and managing GitHub Copilot prompt libraries from multiple sources.

📋 Table of Contents

Overview
Features
Installation
Quick Start
Usage
Supported Sources
Architecture
Configuration
Troubleshooting
Contributing
License

🌟 Overview

Prompt Registry transforms how you discover and manage GitHub Copilot prompts. Instead of manually copying prompt files or cloning repositories, browse a visual marketplace, search by tags, and install curated prompt libraries with a single click.

Why Prompt Registry?

🎯 Discover - Browse curated prompt collections from multiple sources
⚡ Install - One-click installation with automatic Copilot sync
🔄 Manage - Update, organize, and uninstall bundles easily
👥 Share - Create and distribute your own prompt libraries
🌍 Multi-Platform - Works on macOS, Linux, and Windows

✨ Features

🎨 Visual Marketplace

Browse prompt bundles in a modern, tile-based interface inspired by VS Code's extension marketplace:

Rich Metadata: See descriptions, tags, content breakdown, and installation status
Search & Filter: Find prompts by keywords, tags, or content type
Content Preview: View detailed information before installing
One-Click Install: Install bundles instantly from the marketplace

🔌 Multi-Source Support

Connect to various prompt sources:

Source Type	Description	Use Case
Awesome Copilot	Curated community collections	Discover popular prompts
Local Awesome Copilot	Local awesome-copilot collections	Develop/test collections locally
GitHub	Direct from GitHub repositories	Team/project-specific prompts
GitLab	GitLab repositories and releases	Enterprise GitLab users
HTTP	Any HTTP/HTTPS URL	Custom hosting
Local	File system directories	Private/offline prompts

📦 Bundle Management

Install/Uninstall: Manage bundles through UI or commands
Version Control: Track installed versions
Auto-Sync: Automatic synchronization with GitHub Copilot
Conflict Resolution: Handle duplicate bundles gracefully

👥 Profile Management

Organize prompts by project, team, or environment:

Work Projects Profile
  ├── testing-automation (v1.0.0)
  ├── code-review (v2.1.0)
  └── api-documentation (v1.5.0)

Personal Profile
  ├── creative-writing (v1.0.0)
  └── learning-resources (v0.9.0)

⚙️ Settings Management

Export and import your entire Prompt Registry configuration:

📤 Export - Save sources, profiles, and settings to JSON/YAML
📥 Import - Restore configuration with merge or replace strategies
🔄 Backup - Keep configuration safe before changes
👥 Share - Distribute team configurations easily
💾 Version Control - Track settings in Git with YAML format

🌍 Cross-Platform

Automatically detects and uses the correct directories:

macOS: ~/Library/Application Support/Code/User/prompts
Linux: ~/.config/Code/User/prompts
Windows: %APPDATA%/Code/User/prompts

Supports all VS Code flavors: Stable, Insiders, and Windsurf.

📦 Installation

From VS Code Marketplace

Open VS Code
Press Ctrl+Shift+X (or Cmd+Shift+X on macOS)
Search for "Prompt Registry"
Click Install

From VSIX

# Download the latest .vsix file
code --install-extension prompt-registry-2.0.0.vsix

From Source

git clone https://github.com/AmadeusITGroup/prompt-registry.git
cd prompt-registry
npm install
npm run compile
code --install-extension .

🚀 Quick Start

1. Add a Source

First, add a prompt source to the registry:

Ctrl+Shift+P → "Prompt Registry: Add Source"

Choose a source type:

Awesome Copilot Collection - Pre-configured curated prompts
GitHub Repository - Enter repository URL
Local Directory - Select a folder

2. Browse the Marketplace

Open the Prompt Registry Marketplace:

Click "MARKETPLACE" in the Prompt Registry sidebar

Or use the command:

Ctrl+Shift+P → "Prompt Registry: Open Marketplace"

3. Install a Bundle

Click on any bundle tile to view details, then click Install.

Your prompts are now available in GitHub Copilot! 🎉

📖 Usage

Browsing the Marketplace

The marketplace provides multiple ways to discover prompts:

Search

Type in the search box to filter by:
- Bundle name
- Description keywords
- Tags

Filter by Content Type

Click filter buttons to show only:
- Prompts
- Instructions
- Chat Modes
- Agents

View Details

Click on any bundle tile to see:
- Full description
- Content breakdown (prompts, instructions, etc.)
- Installation information
- Tags and metadata
- List of included files

Installing Bundles

From Marketplace

Browse - Find a bundle in the marketplace
Review - Click the tile to view details
Install - Click the Install button
Verify - Check the installed badge appears

From Tree View

Navigate - Go to Registry Explorer in sidebar
Find - Locate a bundle under a source
Install - Right-click → "Install Bundle"

From Command Palette

Ctrl+Shift+P → "Prompt Registry: Install Bundle"
# Select source → Select bundle → Confirm

Managing Sources

Add Source

Ctrl+Shift+P → "Prompt Registry: Add Source"

Awesome Copilot Collection (Recommended for beginners):

Pre-configured
Curated community prompts
Automatically updated

GitHub Repository:

Repository URL: https://github.com/owner/repo
Branch: main (optional)
Collections Path: collections (optional)

Local Directory:

Select a folder containing deployment-manifest.yml

Edit Source

Right-click source in tree view → "Edit Source"

🎨 Creating Prompt Projects

Scaffold Command

Quickly create a new GitHub Copilot prompt project with proper structure:

Ctrl+Shift+P → "Prompt Registry: Scaffold Awesome Copilot Project"

The scaffold will create:

Prompts - Sample prompt files
Instructions - Getting started guides
Chat Modes - Conversation configurations
Collections - Organized prompt collections
Workflows - Validation scripts
Documentation - README and best practices

Project Types

Type	Description	Status
Awesome Copilot	Full-featured template with all resource types	✅ Available
Basic	Minimal template for quick starts	🔜 Coming Soon
Enterprise	Advanced template with governance	🔜 Coming Soon

Collection Validation

Validate your collections against the schema:

Ctrl+Shift+P → "Prompt Registry: Validate Collections"

Features:

✅ JSON Schema Validation - Ensures proper structure
🔍 File Reference Checking - Verifies all files exist
⚠️ Best Practice Warnings - Helpful suggestions
📊 Detailed Reports - Clear error messages

Learn more in the Scaffolding and Validation Guide.

Remove Source

Right-click source in tree view → "Remove Source"

Working with Profiles

Profiles help organize bundles by project, team, or environment.

Create Profile

Ctrl+Shift+P → "Prompt Registry: Create Profile"
# Enter profile name (e.g., "Work Projects")

Install to Profile

When installing a bundle:
1. Choose "Profile" scope
2. Select target profile
3. Bundle installs only to that profile

Switch Profile

Ctrl+Shift+P → "Prompt Registry: Switch Profile"
# Select active profile

View Profile Contents

Sidebar → "My Profiles" → Select profile
# See all bundles in that profile

Using Registry Explorer

The Registry Explorer sidebar provides a comprehensive view of your Prompt Registry ecosystem.

Overview

Access via the sidebar icon or:

Ctrl+Shift+P → "View: Show Prompt Registry Explorer"

Features

📦 Installed Bundles

View all installed bundles by scope (User/Workspace)
Right-click for actions: View Details, Update, Uninstall, Check Updates
See installation status and version information

👥 My Profiles

Manage profile-based installations
Right-click for actions: Activate, Edit, Export, Delete
Quick profile switching

📡 Sources

View all configured sources with priority and status
Right-click context menu for quick actions:
- Edit Source - Modify configuration, change priority, toggle enabled/disabled
- Sync Source - Refresh bundle listings from source
- Toggle Enabled/Disabled - Quick enable/disable without editing
- Remove Source - Delete source configuration
Status indicators: ✓ (enabled) or ○ (disabled)

⚙️ Settings Management

Export Settings - Save complete configuration (sources, profiles, settings)
- JSON format: Pretty-printed, easy to read
- YAML format: Human-friendly, version control compatible
Import Settings - Restore or share configuration
- Merge strategy: Add new sources/profiles, keep existing
- Replace strategy: Clear all, restore from file
- Format auto-detection from file extension

Settings Export/Import

Export your entire Prompt Registry configuration for backup, sharing, or migration:

# Export
1. Click Export button in Registry Explorer toolbar
2. Choose format: JSON or YAML
3. Select save location
4. Optionally open file after export

# Import
1. Click Import button in Registry Explorer toolbar
2. Select settings file (.json, .yaml, .yml)
3. Choose strategy:
   - Merge: Add new items, keep existing
   - Replace: Clear all, restore from file
4. Confirm operation

What's Included in Export:

All sources with URLs, types, priorities, and credentials
All profiles with their bundle associations
Extension settings (auto-updates, logging, etc.)
Timestamp and version information

Use Cases:

🔄 Backup - Save configuration before major changes
👥 Team Sharing - Distribute standard source configurations
�� Multi-Machine - Sync settings across workstations
🔧 Version Control - Track configuration changes in Git

Learn more in the Settings Export/Import Guide.

🔌 Supported Sources

Awesome Copilot Collection

Pre-configured curated source for community prompts.

Type: awesome-copilot
URL: https://github.com/microsoft/prompt-bundle-spec
Collections Path: examples

Features:

✅ Community-curated collections
✅ Well-tested prompts
✅ Regular updates
✅ Wide variety of use cases

Local Awesome Copilot Collection

Local filesystem-based awesome-copilot collections for development and testing.

Type: local-awesome-copilot
URL: /path/to/collections  # or file:///path/to/collections
Collections Path: collections (default)

Features:

✅ Develop collections locally before publishing
✅ Test collection structure and content
✅ No network dependencies
✅ Fast iteration during development
✅ Same format as awesome-copilot adapter

Directory Structure:

/path/to/collections/
├── collections/
│   ├── azure-cloud.collection.yml
│   └── python-dev.collection.yml
├── prompts/
│   ├── azure-resource-health.prompt.md
│   └── python-testing.prompt.md
└── instructions/
    └── bicep-best-practices.instructions.md

Collection File Format (.collection.yml):

id: my-collection
name: My Collection
description: Description of your collection
tags: [tag1, tag2, tag3]
items:
  - path: prompts/example.prompt.md
    kind: prompt
  - path: instructions/guidelines.instructions.md
    kind: instruction
  - path: chatmodes/mode.chatmode.md
    kind: chat-mode

Add Local Collection Source:

Open Command Palette (Ctrl+Shift+P)
Run Prompt Registry: Add Source
Select type: local-awesome-copilot
Enter path: /path/to/your/collections
Bundles appear in Registry Explorer

Use Cases:

🔧 Development - Build and test collections locally
🧪 Testing - Validate structure before GitHub push
🚀 Prototyping - Quick experimentation with prompts
📝 Documentation - Create examples for contributors

GitHub Repository

Any GitHub repository with collections.

Type: github
URL: https://github.com/owner/repo
Branch: main
Collections Path: prompts/collections

Requirements:

Repository must be public (or provide authentication)
Collections directory with .collection.yml files
Each collection references prompt files

GitLab Repository

GitLab repositories and releases.

Type: gitlab
URL: https://gitlab.com/owner/repo
Branch: main

HTTP/HTTPS Source

Any web-accessible ZIP bundles.

Type: http
URL: https://example.com/bundles/

Bundles must:

Be ZIP files
Contain deployment-manifest.yml
Be accessible via HTTPS (recommended)

Local Directory

File system directories.

Type: local
Path: /path/to/prompts

Useful for:

Private prompt libraries
Offline development
Testing custom bundles

🏗️ Architecture

High-Level Overview

graph TB
    subgraph "User Interface"
        MV[Marketplace View]
        TV[Tree View]
    end
    
    subgraph "Core Services"
        RM[Registry Manager]
        BI[Bundle Installer]
        CS[Copilot Sync]
    end
    
    subgraph "Adapters"
        ACA[Awesome Copilot]
        GHA[GitHub]
        GLA[GitLab]
        HTA[HTTP]
        LCA[Local]
    end
    
    MV --> RM
    TV --> RM
    RM --> BI
    BI --> CS
    RM --> ACA
    RM --> GHA
    RM --> GLA
    RM --> HTA
    RM --> LCA
    
    style RM fill:#4CAF50
    style BI fill:#2196F3
    style CS fill:#FF9800

For detailed architecture, see ARCHITECTURE.md

Key Components

Registry Manager: Orchestrates sources, bundles, and installations
Bundle Installer: Handles extraction, validation, and installation
Copilot Sync: Syncs bundles to GitHub Copilot directories
Adapters: Source-specific implementations (GitHub, GitLab, etc.)
UI Providers: Marketplace and tree view interfaces

Installation Flow

sequenceDiagram
    participant User
    participant Marketplace
    participant Adapter
    participant Installer
    participant Copilot
    
    User->>Marketplace: Click Install
    Marketplace->>Adapter: Download bundle
    Adapter-->>Installer: ZIP archive
    Installer->>Installer: Extract & validate
    Installer->>Copilot: Sync prompts
    Copilot-->>User: Ready to use

⚙️ Configuration

Extension Settings

Access via File → Preferences → Settings → Extensions → Prompt Registry

Setting	Description	Default
`promptRegistry.autoSync`	Auto-sync to Copilot on install	`true`
`promptRegistry.cacheTimeout`	Bundle cache TTL (minutes)	`5`
`promptRegistry.defaultScope`	Default installation scope	`user`
`promptRegistry.showNotifications`	Show success notifications	`true`

Source Configuration

Sources are stored in ~/.vscode/extensions/.../registry.json:

{
  "sources": [
    {
      "id": "awesome-copilot",
      "name": "Awesome Copilot Collection",
      "type": "awesome-copilot",
      "url": "https://github.com/microsoft/prompt-bundle-spec",
      "enabled": true
    }
  ]
}

Bundle Manifest

Bundles must include deployment-manifest.yml:

version: "1.0"
id: "testing-automation"
name: "Testing & Test Automation"
version: "1.0.0"
description: "Comprehensive prompts for testing"
author: "github"
tags:
  - testing
  - automation
  - qa

prompts:
  - id: "unit-tests"
    name: "Unit Test Generator"
    type: "prompt"
    file: "prompts/unit-tests.prompt.md"
    tags:
      - unit-testing
      - tdd

🔧 Troubleshooting

Common Issues

Bundles Not Showing in Copilot

Problem: Installed bundles don't appear in GitHub Copilot.

Solution:

Check sync completed: View extension logs
Verify directory: Check OS-specific path exists
Restart VS Code: Reload window (Ctrl+R)
Manual sync: Run "Prompt Registry: Sync All Bundles"

Installation Fails

Problem: "Failed to install bundle" error.

Solutions:

Network Error: Check internet connection
Permission Error: Ensure write access to user directory
Invalid Bundle: Verify bundle has valid manifest
Disk Space: Check available storage

Source Connection Failed

Problem: Cannot fetch bundles from source.

Solutions:

GitHub: Check repository URL and visibility
Authentication: Add access token if needed
Network: Verify HTTPS access not blocked
Rate Limiting: Wait before retrying

Wrong Installation Path (macOS)

Problem: Prompts install to ~/.config/Code instead of ~/Library/Application Support/Code.

Solution: Update to latest version (2.0.0+) with proper macOS support.

Debug Mode

Enable debug logging:

{
  "promptRegistry.debug": true
}

View logs in Output panel: View → Output → Prompt Registry

Getting Help

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

# Clone repository
git clone https://github.com/AmadeusITGroup/prompt-registry.git
cd prompt-registry

# Install dependencies
npm install

# Compile
npm run compile

# Watch mode (auto-compile)
npm run watch

# Run tests
npm test

# Package extension
vsce package

Creating a New Adapter

See ARCHITECTURE.md#extension-points for details on implementing custom adapters.

Project Structure

prompt-registry/
├── src/
│   ├── adapters/          # Source adapters
│   ├── commands/          # Command implementations
│   ├── services/          # Core services
│   ├── ui/               # UI providers
│   ├── types/            # TypeScript types
│   └── utils/            # Utilities
├── docs/                  # Documentation
├── test/                  # Test suites
└── package.json          # Extension manifest

📚 Documentation

Architecture Guide - Detailed system architecture
API Reference - Extension API documentation
Bundle Format - Creating custom bundles
Adapter Development - Building new adapters
Awesome Copilot Implementation - Awesome Copilot adapter details

🗺️ Roadmap

Current Version (2.0.0)

✅ Visual marketplace interface
✅ Multi-source support (6 adapter types)
✅ Profile management
✅ Cross-platform support (macOS, Linux, Windows)
✅ Auto-sync with GitHub Copilot
✅ Search and filtering
✅ Clickable marketplace tiles

Upcoming (2.1.0)

🔄 Automatic bundle updates
🔄 Bundle versioning and rollback
🔄 Dependency management
🔄 Bundle analytics

Future (3.0.0)

📋 Bundle authoring tools
📋 Community ratings and reviews
📋 AI-powered recommendations
📋 Collaborative prompt sharing
📋 Marketplace API for third-party tools

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🙏 Acknowledgments

Microsoft - For GitHub Copilot and VS Code
Awesome Copilot Community - For curated prompt collections
Contributors - Everyone who has contributed to this project

📊 Stats

Supported Source Types: 6 (GitHub, GitLab, HTTP, Local, Awesome Copilot, Local Awesome Copilot)
Platforms: macOS, Linux, Windows
VS Code Flavors: Stable, Insiders, Windsurf
Architecture: Adapter pattern with extensible design
Bundle Format: YAML-based deployment manifest

🔗 Links

Homepage: https://prompt-registry.dev
Documentation: https://docs.prompt-registry.dev
GitHub: https://github.com/AmadeusITGroup/prompt-registry
Issues: https://github.com/AmadeusITGroup/prompt-registry/issues
Marketplace: VS Code Marketplace

Made with ❤️ by the Prompt Registry Team

Report Bug · Request Feature · Documentation

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
.github		.github
.vscode		.vscode
docs		docs
schemas		schemas
scripts		scripts
src		src
templates		templates
test		test
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.vscodeignore		.vscodeignore
.vscodeignore.development		.vscodeignore.development
.vscodeignore.production		.vscodeignore.production
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.txt		LICENSE.txt
README.md		README.md
SECURITY.md		SECURITY.md
icon.png		icon.png
icon.svg		icon.svg
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
tsconfig.test.json		tsconfig.test.json
webpack.config.js		webpack.config.js

License

AmadeusITGroup/prompt-registry

Folders and files

Latest commit

History

Repository files navigation

🎨 Prompt Registry

📋 Table of Contents

🌟 Overview

Why Prompt Registry?

✨ Features

🎨 Visual Marketplace

🔌 Multi-Source Support

📦 Bundle Management

👥 Profile Management

⚙️ Settings Management

🌍 Cross-Platform

📦 Installation

From VS Code Marketplace

From VSIX

From Source

🚀 Quick Start

1. Add a Source

2. Browse the Marketplace

3. Install a Bundle

📖 Usage

Browsing the Marketplace

Search

Filter by Content Type

View Details

Installing Bundles

From Marketplace

From Tree View

From Command Palette

Managing Sources

Add Source

Edit Source

🎨 Creating Prompt Projects

Scaffold Command

Project Types

Collection Validation

Remove Source

Working with Profiles

Create Profile

Install to Profile

Switch Profile

View Profile Contents

Using Registry Explorer

Overview

Features

Settings Export/Import

🔌 Supported Sources

Awesome Copilot Collection

Local Awesome Copilot Collection

GitHub Repository

GitLab Repository

HTTP/HTTPS Source

Local Directory

🏗️ Architecture

High-Level Overview

Key Components

Installation Flow

⚙️ Configuration

Extension Settings

Source Configuration

Bundle Manifest

🔧 Troubleshooting

Common Issues

Bundles Not Showing in Copilot

Installation Fails

Source Connection Failed

Wrong Installation Path (macOS)

Debug Mode

Getting Help

🤝 Contributing

Development Setup

Creating a New Adapter

Project Structure

📚 Documentation

🗺️ Roadmap

Packages