VS Code extension for managing, sharing, and installing AI primitives (Agents, Skills, Prompts, Instructions, MCP) collections for GitHub Copilot and other AI assistants
See the codeREADME
π¨ AI Primitives Hub
A monorepo for the AI Primitives Hub: a VS Code marketplace and a shared set of ports-and-adapters packages for discovering, installing, and managing GitHub Copilot prompt libraries.
AI Primitives Hub lets users discover and manage GitHub Copilot prompts through a VS Code extension, while providing reusable domain libraries, adapters, and a CLI for building, installing, and transforming prompt collections across multiple targets.
βΉοΈ Note: This project was formerly known as Prompt Registry. The VS Code extension ID (
AmadeusITGroup.prompt-registry) and lockfile names remain unchanged for compatibility β seeingprompt-registryin paths is expected.
π Table of Contents
π Quick Start
As a VS Code user:
Search "AI Primitives Hub" in the Extensions panel, or build from source using apps/vscode-extension/README.md.
As a collection author: See the Author Guide.
As a contributor:
Requires Node.js 24 or newer and pnpm 11 or newer. See CONTRIBUTING.md for the complete development setup.
git clone https://github.com/AmadeusITGroup/ai-primitives-hub.git
cd ai-primitives-hub
pnpm install
pnpm build # build all workspace packages
pnpm test # run all workspace tests
pnpm lint
π Repository Structure
| Path | Purpose |
|---|---|
apps/vscode-extension/ | VS Code extension: UI, commands, services, adapters |
packages/core/ | Domain types and port interfaces |
packages/infra/ | Adapter implementations: sources, stores, writers, scaffolding |
packages/app/ | Use-case orchestration: install, registry, discovery, transforms |
packages/cli/ | Terminal interface calling app |
lib/ | Legacy collection scripts (deprecated in place) |
github-actions/validate-collections/ | Reusable GitHub Action for validating collections in CI |
docs/ | User, author, and contributor documentation |
website/ | Docusaurus documentation site |
packages/infra/src/hub/ | Shared Hub resolution, validation, and default-Hub definitions |
ποΈ Architecture
The monorepo is organized around a shared core domain, with infra adapters, an app orchestration layer, and thin delivery layers for the VS Code extension and the CLI.
flowchart TD
subgraph "Delivery"
VSC[VS Code extension<br/>apps/vscode-extension]
CLI[CLI<br/>packages/cli]
end
VSC --> APP[packages/app]
CLI --> APP
APP --> CORE[packages/core]
APP --> INF[packages/infra]
INF --> CORE
INF --> AD[Adapters<br/>GitHub / Local / APM / Skills / Awesome Copilot / Azure DevOps]
For extension details, see the Contributor Architecture Guide.
π Documentation
See the full index: docs/README.md.
π€ Contributing
See CONTRIBUTING.md and CODE_OF_CONDUCT.md. For security, see SECURITY.md.
π License
Significant stargazers
401 followers Β· starred Dec 2025
Similar repos
Languages
TypeScript
95.7%
JavaScript
3.3%
VS Code extension for managing, sharing, and installing AI primitives (Agents, Skills, Prompts, Instructions, MCP) collections for GitHub Copilot and other AI assistants
See the codeREADME
π¨ AI Primitives Hub
A monorepo for the AI Primitives Hub: a VS Code marketplace and a shared set of ports-and-adapters packages for discovering, installing, and managing GitHub Copilot prompt libraries.
AI Primitives Hub lets users discover and manage GitHub Copilot prompts through a VS Code extension, while providing reusable domain libraries, adapters, and a CLI for building, installing, and transforming prompt collections across multiple targets.
βΉοΈ Note: This project was formerly known as Prompt Registry. The VS Code extension ID (
AmadeusITGroup.prompt-registry) and lockfile names remain unchanged for compatibility β seeingprompt-registryin paths is expected.
π Table of Contents
π Quick Start
As a VS Code user:
Search "AI Primitives Hub" in the Extensions panel, or build from source using apps/vscode-extension/README.md.
As a collection author: See the Author Guide.
As a contributor:
Requires Node.js 24 or newer and pnpm 11 or newer. See CONTRIBUTING.md for the complete development setup.
git clone https://github.com/AmadeusITGroup/ai-primitives-hub.git
cd ai-primitives-hub
pnpm install
pnpm build # build all workspace packages
pnpm test # run all workspace tests
pnpm lint
π Repository Structure
| Path | Purpose |
|---|---|
apps/vscode-extension/ | VS Code extension: UI, commands, services, adapters |
packages/core/ | Domain types and port interfaces |
packages/infra/ | Adapter implementations: sources, stores, writers, scaffolding |
packages/app/ | Use-case orchestration: install, registry, discovery, transforms |
packages/cli/ | Terminal interface calling app |
lib/ | Legacy collection scripts (deprecated in place) |
github-actions/validate-collections/ | Reusable GitHub Action for validating collections in CI |
docs/ | User, author, and contributor documentation |
website/ | Docusaurus documentation site |
packages/infra/src/hub/ | Shared Hub resolution, validation, and default-Hub definitions |
ποΈ Architecture
The monorepo is organized around a shared core domain, with infra adapters, an app orchestration layer, and thin delivery layers for the VS Code extension and the CLI.
flowchart TD
subgraph "Delivery"
VSC[VS Code extension<br/>apps/vscode-extension]
CLI[CLI<br/>packages/cli]
end
VSC --> APP[packages/app]
CLI --> APP
APP --> CORE[packages/core]
APP --> INF[packages/infra]
INF --> CORE
INF --> AD[Adapters<br/>GitHub / Local / APM / Skills / Awesome Copilot / Azure DevOps]
For extension details, see the Contributor Architecture Guide.
π Documentation
See the full index: docs/README.md.
π€ Contributing
See CONTRIBUTING.md and CODE_OF_CONDUCT.md. For security, see SECURITY.md.
π License
Similar repos
Significant stargazers
401 followers Β· starred Dec 2025
Languages
TypeScript
95.7%
JavaScript
3.3%