website

.github/workflows/deploy-website.yml

@@ -0,0 +1,82 @@
+# GitHub Pages deployment workflow
+# Builds the Astro website and deploys to GitHub Pages
+
+name: Deploy Website to GitHub Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+    paths:
+      - "website/**"
+      - "agents/**"
+      - "prompts/**"
+      - "instructions/**"
+      - "skills/**"
+      - "collections/**"
+      - "cookbook/**"
+      - "eng/generate-website-data.mjs"
+      - ".github/workflows/deploy-website.yml"
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install root dependencies
+        run: npm ci
+
+      - name: Install website dependencies
+        run: npm ci
+        working-directory: ./website
+
+      - name: Generate website data
+        run: npm run website:data
+
+      - name: Build Astro site
+        run: npm run build
+        working-directory: ./website
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "./website/dist"
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -6,3 +6,8 @@ reports/
 # macOS system files
 .DS_Store
 *.tmp
+
+# Website build artifacts
+website/dist/
+website/.astro/
+website/public/data/*

.schemas/cookbook.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Cookbook Manifest",
+  "description": "Schema for cookbook.yml manifest defining cookbooks and recipes",
+  "type": "object",
+  "required": ["cookbooks"],
+  "properties": {
+    "cookbooks": {
+      "type": "array",
+      "description": "List of cookbooks",
+      "items": {
+        "type": "object",
+        "required": ["id", "name", "description", "path", "languages", "recipes"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique identifier for the cookbook",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "name": {
+            "type": "string",
+            "description": "Display name for the cookbook"
+          },
+          "description": {
+            "type": "string",
+            "description": "Brief description of the cookbook"
+          },
+          "path": {
+            "type": "string",
+            "description": "Relative path to the cookbook folder"
+          },
+          "featured": {
+            "type": "boolean",
+            "description": "Whether this cookbook should be featured",
+            "default": false
+          },
+          "languages": {
+            "type": "array",
+            "description": "Programming languages supported by this cookbook",
+            "items": {
+              "type": "object",
+              "required": ["id", "name"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "Language identifier (folder name)",
+                  "pattern": "^[a-z0-9-]+$"
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Display name for the language"
+                },
+                "icon": {
+                  "type": "string",
+                  "description": "Emoji icon for the language"
+                },
+                "extension": {
+                  "type": "string",
+                  "description": "File extension for runnable examples",
+                  "pattern": "^\\.[a-z]+$"
+                }
+              }
+            }
+          },
+          "recipes": {
+            "type": "array",
+            "description": "List of recipes in this cookbook",
+            "items": {
+              "type": "object",
+              "required": ["id", "name", "description"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "Recipe identifier (matches markdown filename without extension)",
+                  "pattern": "^[a-z0-9-]+$"
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Display name for the recipe"
+                },
+                "description": {
+                  "type": "string",
+                  "description": "Brief description of what the recipe covers"
+                },
+                "tags": {
+                  "type": "array",
+                  "description": "Tags for filtering and categorization",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

.schemas/tools.schema.json

@@ -0,0 +1,151 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Tools Catalog",
+  "description": "Schema for the awesome-copilot tools catalog (website/data/tools.yml)",
+  "type": "object",
+  "required": ["tools"],
+  "additionalProperties": false,
+  "properties": {
+    "tools": {
+      "type": "array",
+      "description": "List of tools in the catalog",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "name", "description", "category"],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique identifier for the tool",
+            "pattern": "^[a-z0-9-]+$",
+            "minLength": 1,
+            "maxLength": 50
+          },
+          "name": {
+            "type": "string",
+            "description": "Display name for the tool",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "description": {
+            "type": "string",
+            "description": "Description of what this tool does",
+            "minLength": 1,
+            "maxLength": 1000
+          },
+          "category": {
+            "type": "string",
+            "description": "Category for grouping tools",
+            "minLength": 1,
+            "maxLength": 50,
+            "examples": ["MCP Servers", "VS Code Extensions", "CLI Tools", "Visual Studio Extensions"]
+          },
+          "featured": {
+            "type": "boolean",
+            "description": "Whether this tool is featured (shown first)",
+            "default": false
+          },
+          "requirements": {
+            "type": "array",
+            "description": "List of requirements to use this tool",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "maxItems": 10
+          },
+          "features": {
+            "type": "array",
+            "description": "List of key features",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "maxItems": 20
+          },
+          "links": {
+            "type": "object",
+            "description": "Links related to this tool",
+            "additionalProperties": false,
+            "properties": {
+              "blog": {
+                "type": "string",
+                "description": "Link to a blog post about the tool",
+                "format": "uri"
+              },
+              "documentation": {
+                "type": "string",
+                "description": "Link to documentation",
+                "format": "uri"
+              },
+              "github": {
+                "type": "string",
+                "description": "Link to GitHub repository",
+                "format": "uri"
+              },
+              "marketplace": {
+                "type": "string",
+                "description": "Link to VS Code or Visual Studio Marketplace",
+                "format": "uri"
+              },
+              "npm": {
+                "type": "string",
+                "description": "Link to npm package",
+                "format": "uri"
+              },
+              "pypi": {
+                "type": "string",
+                "description": "Link to PyPI package",
+                "format": "uri"
+              },
+              "vscode": {
+                "type": "string",
+                "description": "VS Code install link (vscode: URI or aka.ms link)"
+              },
+              "vscode-insiders": {
+                "type": "string",
+                "description": "VS Code Insiders install link"
+              },
+              "visual-studio": {
+                "type": "string",
+                "description": "Visual Studio install link"
+              }
+            }
+          },
+          "configuration": {
+            "type": "object",
+            "description": "Configuration snippet for the tool",
+            "required": ["type", "content"],
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "type": "string",
+                "description": "Type of configuration (for syntax highlighting)",
+                "enum": ["json", "yaml", "bash", "toml", "ini"]
+              },
+              "content": {
+                "type": "string",
+                "description": "The configuration content"
+              }
+            }
+          },
+          "tags": {
+            "type": "array",
+            "description": "Tags for filtering and discovery",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9-]+$",
+              "minLength": 1,
+              "maxLength": 30
+            },
+            "uniqueItems": true,
+            "maxItems": 15
+          }
+        }
+      }
+    }
+  }
+}

.vscode/settings.json

@@ -15,6 +15,7 @@
     "*.prompt.md": "prompt"
   },
   "yaml.schemas": {
-    "./.schemas/collection.schema.json": "*.collection.yml"
+    "./.schemas/collection.schema.json": "*.collection.yml",
+    "./.schemas/tools.schema.json": "website/data/tools.yml",
   }
 }