Skip to content

Add AI Catalog generation for .well-known manifest#2060

Open
aaronpowell wants to merge 1 commit into
stagedfrom
aaronpowell-agentic-resource-discovery
Open

Add AI Catalog generation for .well-known manifest#2060
aaronpowell wants to merge 1 commit into
stagedfrom
aaronpowell-agentic-resource-discovery

Conversation

@aaronpowell

Copy link
Copy Markdown
Contributor

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the staged branch for this pull request.

Description

This adds phase 1 ARD support by publishing an AI Catalog manifest from the repository's existing metadata pipeline. The goal is to make Awesome Copilot resources discoverable by external ARD-compatible discovery services (for example, Agent Finder) without introducing a new runtime API service.

Implementation details:

  • Extend eng/generate-website-data.mjs to build AI Catalog entries from existing generated resource sets: agents, instructions, skills, hooks, workflows, and plugins.
  • Add normalized URL and identifier helpers, including stable URN-style identifiers for entries.
  • Handle plugin URLs for both local and external plugins.
  • Add host and collection metadata in the AI Catalog output.
  • Write output to website/public/.well-known/ai-catalog.json during npm run website:data.

Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • New canvas extension.
  • Update to existing instruction, prompt, agent, plugin, skill, workflow, or canvas extension.
  • Other (please specify): Build/data generation enhancement for website discovery metadata.

Additional Notes

This PR intentionally focuses on static publication only. It does not add ARD POST /search or POST /explore endpoints, which would require a separate hosted service beyond the current static website model.


By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings June 19, 2026 05:40

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds phase 1 ARD support by generating and publishing an AI Catalog manifest (.well-known/ai-catalog.json) from the repository’s existing website metadata pipeline, enabling static discovery without introducing a runtime API service.

Changes:

  • Added AI Catalog generation that aggregates agents, instructions, skills, hooks, workflows, and plugins into a single manifest.
  • Introduced helpers for normalized URLs and stable URN-style identifiers.
  • Wrote the AI Catalog output into website/public/.well-known/ai-catalog.json during npm run website:data.
Show a summary per file
File Description
eng/generate-website-data.mjs Generates an AI Catalog manifest from existing resource metadata and writes it to website/public/.well-known/ai-catalog.json.

Copilot's findings

  • Files reviewed: 1/1 changed files
  • Comments generated: 2

Comment on lines +152 to +158
return {
identifier: `urn:ai:awesome-copilot.github.com:${category}:${toUrnSegment(id)}`,
displayName: normalizeText(displayName, id),
type,
url,
description: normalizeDescription(description),
};
Comment on lines +259 to +262
host: {
displayName: "Awesome GitHub Copilot",
identifier: "awesome-copilot.github.com",
},
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants