From 1928fb0fc0690e1a38c94c49600ee9e0fd9d9028 Mon Sep 17 00:00:00 2001
From: Jcardif <29174946+Jcardif@users.noreply.github.com>
Date: Thu, 29 Jan 2026 17:18:59 +0300
Subject: [PATCH 01/49] Add penpot-uiux-design skill

Adds a comprehensive UI/UX design skill for the Penpot MCP server.

Features:
- MCP tool reference (execute_code, export_shape, import_image, penpot_api_info)
- Design system discovery and handling
- Board positioning to avoid overlap
- Default design tokens (spacing, typography, colors)
- Component checklists (buttons, forms, navigation)
- Accessibility guidelines (WCAG compliance)
- Platform specifications (iOS, Android, responsive web)
---
 docs/README.skills.md                         |   1 +
 skills/penpot-uiux-design/SKILL.md            | 283 ++++++++++++++
 .../references/accessibility.md               | 329 ++++++++++++++++
 .../references/component-patterns.md          | 339 ++++++++++++++++
 .../references/platform-guidelines.md         | 367 ++++++++++++++++++
 5 files changed, 1319 insertions(+)
 create mode 100644 skills/penpot-uiux-design/SKILL.md
 create mode 100644 skills/penpot-uiux-design/references/accessibility.md
 create mode 100644 skills/penpot-uiux-design/references/component-patterns.md
 create mode 100644 skills/penpot-uiux-design/references/platform-guidelines.md

diff --git a/docs/README.skills.md b/docs/README.skills.md
index 45a9d055..8024842c 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -41,6 +41,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [microsoft-code-reference](../skills/microsoft-code-reference/SKILL.md) | Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs. | None |
 | [microsoft-docs](../skills/microsoft-docs/SKILL.md) | Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices. | None |
 | [nuget-manager](../skills/nuget-manager/SKILL.md) | Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions. | None |
+| [penpot-uiux-design](../skills/penpot-uiux-design/SKILL.md) | Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: 'design a UI', 'create interface', 'build layout', 'design dashboard', 'create form', 'design landing page', 'make it accessible', 'design system', 'component library'. | `references/accessibility.md`<br />`references/component-patterns.md`<br />`references/platform-guidelines.md` |
 | [plantuml-ascii](../skills/plantuml-ascii/SKILL.md) | Generate ASCII art diagrams using PlantUML text mode. Use when user asks to create ASCII diagrams, text-based diagrams, terminal-friendly diagrams, or mentions plantuml ascii, text diagram, ascii art diagram. Supports: Converting PlantUML diagrams to ASCII art, Creating sequence diagrams, class diagrams, flowcharts in ASCII format, Generating Unicode-enhanced ASCII art with -utxt flag | None |
 | [prd](../skills/prd/SKILL.md) | Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis. | None |
 | [refactor](../skills/refactor/SKILL.md) | Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements. | None |
diff --git a/skills/penpot-uiux-design/SKILL.md b/skills/penpot-uiux-design/SKILL.md
new file mode 100644
index 00000000..dac7dc85
--- /dev/null
+++ b/skills/penpot-uiux-design/SKILL.md
@@ -0,0 +1,283 @@
+---
+name: penpot-uiux-design
+description: "Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: 'design a UI', 'create interface', 'build layout', 'design dashboard', 'create form', 'design landing page', 'make it accessible', 'design system', 'component library'."
+---
+
+# Penpot UI/UX Design Guide
+
+Create professional, user-centered designs in Penpot using the `penpot/penpot-mcp` MCP server and proven UI/UX principles.
+
+## Available MCP Tools
+
+| Tool | Purpose |
+| ---- | ------- |
+| `mcp__penpot__execute_code` | Run JavaScript in Penpot plugin context to create/modify designs |
+| `mcp__penpot__export_shape` | Export shapes as PNG/SVG for visual inspection |
+| `mcp__penpot__import_image` | Import images (icons, photos, logos) into designs |
+| `mcp__penpot__penpot_api_info` | Retrieve Penpot API documentation |
+
+## Quick Reference
+
+| Task | Reference File |
+| ---- | -------------- |
+| Component specs (buttons, forms, nav) | [component-patterns.md](references/component-patterns.md) |
+| Accessibility (contrast, touch targets) | [accessibility.md](references/accessibility.md) |
+| Screen sizes & platform specs | [platform-guidelines.md](references/platform-guidelines.md) |
+
+## Core Design Principles
+
+### The Golden Rules
+
+1. **Clarity over cleverness**: Every element must have a purpose
+2. **Consistency builds trust**: Reuse patterns, colors, and components
+3. **User goals first**: Design for tasks, not features
+4. **Accessibility is not optional**: Design for everyone
+5. **Test with real users**: Validate assumptions early
+
+### Visual Hierarchy (Priority Order)
+
+1. **Size**: Larger = more important
+2. **Color/Contrast**: High contrast draws attention
+3. **Position**: Top-left (LTR) gets seen first
+4. **Whitespace**: Isolation emphasizes importance
+5. **Typography weight**: Bold stands out
+
+## Design Workflow
+
+1. **Check for design system first**: Ask user if they have existing tokens/specs, or discover from current Penpot file
+2. **Understand the page**: Call `mcp__penpot__execute_code` with `penpotUtils.shapeStructure()` to see hierarchy
+3. **Find elements**: Use `penpotUtils.findShapes()` to locate elements by type or name
+4. **Create/modify**: Use `penpot.createBoard()`, `penpot.createRectangle()`, `penpot.createText()` etc.
+5. **Apply layout**: Use `addFlexLayout()` for responsive containers
+6. **Validate**: Call `mcp__penpot__export_shape` to visually check your work
+
+## Design System Handling
+
+**Before creating designs, determine if the user has an existing design system:**
+
+1. **Ask the user**: "Do you have a design system or brand guidelines to follow?"
+2. **Discover from Penpot**: Check for existing components, colors, and patterns
+
+```javascript
+// Discover existing design patterns in current file
+const allShapes = penpotUtils.findShapes(() => true, penpot.root);
+
+// Find existing colors in use
+const colors = new Set();
+allShapes.forEach(s => {
+  if (s.fills) s.fills.forEach(f => colors.add(f.fillColor));
+});
+
+// Find existing text styles (font sizes, weights)
+const textStyles = allShapes
+  .filter(s => s.type === 'text')
+  .map(s => ({ fontSize: s.fontSize, fontWeight: s.fontWeight }));
+
+// Find existing components
+const components = penpot.library.local.components;
+
+return { colors: [...colors], textStyles, componentCount: components.length };
+```
+
+**If user HAS a design system:**
+
+- Use their specified colors, spacing, typography
+- Match their existing component patterns
+- Follow their naming conventions
+
+**If user has NO design system:**
+
+- Use the default tokens below as a starting point
+- Offer to help establish consistent patterns
+- Reference specs in [component-patterns.md](references/component-patterns.md)
+
+## Key Penpot API Gotchas
+
+- `width`/`height` are READ-ONLY → use `shape.resize(w, h)`
+- `parentX`/`parentY` are READ-ONLY → use `penpotUtils.setParentXY(shape, x, y)`
+- Use `insertChild(index, shape)` for z-ordering (not `appendChild`)
+- Flex children array order is REVERSED for `dir="column"` or `dir="row"`
+- After `text.resize()`, reset `growType` to `"auto-width"` or `"auto-height"`
+
+## Positioning New Boards
+
+**Always check existing boards before creating new ones** to avoid overlap:
+
+```javascript
+// Find all existing boards and calculate next position
+const boards = penpotUtils.findShapes(s => s.type === 'board', penpot.root);
+let nextX = 0;
+const gap = 100; // Space between boards
+
+if (boards.length > 0) {
+  // Find rightmost board edge
+  boards.forEach(b => {
+    const rightEdge = b.x + b.width;
+    if (rightEdge + gap > nextX) {
+      nextX = rightEdge + gap;
+    }
+  });
+}
+
+// Create new board at calculated position
+const newBoard = penpot.createBoard();
+newBoard.x = nextX;
+newBoard.y = 0;
+newBoard.resize(375, 812);
+```
+
+**Board spacing guidelines:**
+
+- Use 100px gap between related screens (same flow)
+- Use 200px+ gap between different sections/flows
+- Align boards vertically (same y) for visual organization
+- Group related screens horizontally in user flow order
+
+## Default Design Tokens
+
+**Use these defaults only when user has no design system. Always prefer user's tokens if available.**
+
+### Spacing Scale (8px base)
+
+| Token | Value | Usage |
+| ----- | ----- | ----- |
+| `spacing-xs` | 4px | Tight inline elements |
+| `spacing-sm` | 8px | Related elements |
+| `spacing-md` | 16px | Default padding |
+| `spacing-lg` | 24px | Section spacing |
+| `spacing-xl` | 32px | Major sections |
+| `spacing-2xl` | 48px | Page-level spacing |
+
+### Typography Scale
+
+| Level | Size | Weight | Usage |
+| ----- | ---- | ------ | ----- |
+| Display | 48-64px | Bold | Hero headlines |
+| H1 | 32-40px | Bold | Page titles |
+| H2 | 24-28px | Semibold | Section headers |
+| H3 | 20-22px | Semibold | Subsections |
+| Body | 16px | Regular | Main content |
+| Small | 14px | Regular | Secondary text |
+| Caption | 12px | Regular | Labels, hints |
+
+### Color Usage
+
+| Purpose | Recommendation |
+| ------- | -------------- |
+| Primary | Main brand color, CTAs |
+| Secondary | Supporting actions |
+| Success | #22C55E range (confirmations) |
+| Warning | #F59E0B range (caution) |
+| Error | #EF4444 range (errors) |
+| Neutral | Gray scale for text/borders |
+
+## Common Layouts
+
+### Mobile Screen (375×812)
+
+```text
+┌─────────────────────────────┐
+│ Status Bar (44px)           │
+├─────────────────────────────┤
+│ Header/Nav (56px)           │
+├─────────────────────────────┤
+│                             │
+│ Content Area                │
+│ (Scrollable)                │
+│ Padding: 16px horizontal    │
+│                             │
+├─────────────────────────────┤
+│ Bottom Nav/CTA (84px)       │
+└─────────────────────────────┘
+
+```
+
+### Desktop Dashboard (1440×900)
+
+```text
+┌──────┬──────────────────────────────────┐
+│      │ Header (64px)                    │
+│ Side │──────────────────────────────────│
+│ bar  │ Page Title + Actions             │
+│      │──────────────────────────────────│
+│ 240  │ Content Grid                     │
+│ px   │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │
+│      │ │Card │ │Card │ │Card │ │Card │ │
+│      │ └─────┘ └─────┘ └─────┘ └─────┘ │
+│      │                                  │
+└──────┴──────────────────────────────────┘
+
+```
+
+## Component Checklist
+
+### Buttons
+
+- [ ] Clear, action-oriented label (2-3 words)
+- [ ] Minimum touch target: 44×44px
+- [ ] Visual states: default, hover, active, disabled, loading
+- [ ] Sufficient contrast (3:1 against background)
+- [ ] Consistent border radius across app
+
+### Forms
+
+- [ ] Labels above inputs (not just placeholders)
+- [ ] Required field indicators
+- [ ] Error messages adjacent to fields
+- [ ] Logical tab order
+- [ ] Input types match content (email, tel, etc.)
+
+### Navigation
+
+- [ ] Current location clearly indicated
+- [ ] Consistent position across screens
+- [ ] Maximum 7±2 top-level items
+- [ ] Touch-friendly on mobile (48px targets)
+
+## Accessibility Quick Checks
+
+1. **Color contrast**: Text 4.5:1, Large text 3:1
+2. **Touch targets**: Minimum 44×44px
+3. **Focus states**: Visible keyboard focus indicators
+4. **Alt text**: Meaningful descriptions for images
+5. **Hierarchy**: Proper heading levels (H1→H2→H3)
+6. **Color independence**: Never rely solely on color
+
+## Design Review Checklist
+
+Before finalizing any design:
+
+- [ ] Visual hierarchy is clear
+- [ ] Consistent spacing and alignment
+- [ ] Typography is readable (16px+ body text)
+- [ ] Color contrast meets WCAG AA
+- [ ] Interactive elements are obvious
+- [ ] Mobile-friendly touch targets
+- [ ] Loading/empty/error states considered
+- [ ] Consistent with design system
+
+## Validating Designs
+
+Use these validation approaches with `mcp__penpot__execute_code`:
+
+| Check | Method |
+| ----- | ------ |
+| Elements outside bounds | `penpotUtils.analyzeDescendants()` with `isContainedIn()` |
+| Text too small (<12px) | `penpotUtils.findShapes()` filtering by `fontSize` |
+| Missing contrast | Call `mcp__penpot__export_shape` and visually inspect |
+| Hierarchy structure | `penpotUtils.shapeStructure()` to review nesting |
+
+### Export CSS
+
+Use `penpot.generateStyle(selection, { type: 'css', includeChildren: true })` via `mcp__penpot__execute_code` to extract CSS from designs.
+
+## Tips for Great Designs
+
+1. **Start with content**: Real content reveals layout needs
+2. **Design mobile-first**: Constraints breed creativity
+3. **Use a grid**: 8px base grid keeps things aligned
+4. **Limit colors**: 1 primary + 1 secondary + neutrals
+5. **Limit fonts**: 1-2 typefaces maximum
+6. **Embrace whitespace**: Breathing room improves comprehension
+7. **Be consistent**: Same action = same appearance everywhere
+8. **Provide feedback**: Every action needs a response
diff --git a/skills/penpot-uiux-design/references/accessibility.md b/skills/penpot-uiux-design/references/accessibility.md
new file mode 100644
index 00000000..2482b9da
--- /dev/null
+++ b/skills/penpot-uiux-design/references/accessibility.md
@@ -0,0 +1,329 @@
+# Accessibility Guidelines Reference (WCAG)
+
+## Quick Compliance Checklist
+
+### Level AA Requirements (Minimum Standard)
+
+- [ ] Color contrast 4.5:1 for normal text
+- [ ] Color contrast 3:1 for large text (18px+ or 14px bold)
+- [ ] Touch targets minimum 44×44px
+- [ ] All functionality available via keyboard
+- [ ] Visible focus indicators
+- [ ] No content flashes more than 3 times/second
+- [ ] Page has descriptive title
+- [ ] Link purpose clear from text
+- [ ] Form inputs have labels
+- [ ] Error messages are descriptive
+
+---
+
+## Color and Contrast
+
+### Contrast Ratios
+
+| Element | Minimum Ratio | Enhanced (AAA) |
+| ------- | ------------- | -------------- |
+| Body text | 4.5:1 | 7:1 |
+| Large text (18px+) | 3:1 | 4.5:1 |
+| UI components | 3:1 | - |
+| Graphical objects | 3:1 | - |
+
+### Color Independence
+
+Never use color as the only means of conveying information:
+
+```text
+✗ Error fields shown only in red
+✓ Error fields with red border + error icon + text message
+
+✗ Required fields marked only with red asterisk
+✓ Required fields labeled "(required)" or with icon + tooltip
+
+✗ Status shown only by color dots
+✓ Status with color + icon + label text
+
+```
+
+### Accessible Color Combinations
+
+**Safe text colors on backgrounds:**
+
+| Background | Text Color | Contrast |
+| ---------- | ---------- | -------- |
+| White (#FFFFFF) | Dark gray (#1F2937) | 15.5:1 ✓ |
+| Light gray (#F3F4F6) | Dark gray (#374151) | 10.9:1 ✓ |
+| Primary blue (#2563EB) | White (#FFFFFF) | 4.6:1 ✓ |
+| Dark (#111827) | White (#FFFFFF) | 18.1:1 ✓ |
+
+**Colors to avoid for text:**
+
+- Yellow on white (insufficient contrast)
+- Light gray on white
+- Orange on white (marginal at best)
+
+---
+
+## Keyboard Navigation
+
+### Requirements
+
+1. **All interactive elements** must be reachable via Tab key
+2. **Logical tab order** following visual layout
+3. **No keyboard traps** (user can always Tab away)
+4. **Focus visible** at all times during keyboard navigation
+5. **Skip links** to bypass repetitive navigation
+
+### Focus Indicators
+
+```css
+/* Example focus styles */
+:focus {
+  outline: 2px solid #2563EB;
+  outline-offset: 2px;
+}
+
+:focus:not(:focus-visible) {
+  outline: none; /* Hide for mouse users */
+}
+
+:focus-visible {
+  outline: 2px solid #2563EB;
+  outline-offset: 2px;
+}
+
+```
+
+### Keyboard Shortcuts
+
+| Key | Expected Behavior |
+| --- | ----------------- |
+| Tab | Move to next interactive element |
+| Shift+Tab | Move to previous element |
+| Enter | Activate button/link |
+| Space | Activate button, toggle checkbox |
+| Escape | Close modal/dropdown |
+| Arrow keys | Navigate within components |
+
+---
+
+## Screen Reader Support
+
+### Semantic HTML Elements
+
+Use appropriate elements for their purpose:
+
+| Purpose | Element | Not This |
+| ------- | ------- | -------- |
+| Navigation | `<nav>` | `<div class="nav">` |
+| Main content | `<main>` | `<div id="main">` |
+| Header | `<header>` | `<div class="header">` |
+| Footer | `<footer>` | `<div class="footer">` |
+| Button | `<button>` | `<div onclick>` |
+| Link | `<a href>` | `<span onclick>` |
+
+### Heading Hierarchy
+
+```text
+h1 - Page Title (one per page)
+  h2 - Major Section
+    h3 - Subsection
+      h4 - Sub-subsection
+    h3 - Another Subsection
+  h2 - Another Major Section
+
+```
+
+**Never skip levels** (h1 → h3 without h2)
+
+### Image Alt Text
+
+```text
+Decorative: alt="" (empty, not omitted)
+Informative: alt="Description of what image shows"
+Functional: alt="Action the image performs"
+Complex: alt="Brief description" + detailed description nearby
+
+```
+
+**Alt text examples:**
+
+```text
+✓ alt="Bar chart showing sales growth from $10M to $15M in Q4"
+✓ alt="Company logo"
+✓ alt="" (for decorative background pattern)
+
+✗ alt="image" or alt="photo"
+✗ alt="img_12345.jpg"
+✗ Missing alt attribute entirely
+
+```
+
+---
+
+## Touch and Pointer
+
+### Touch Target Sizes
+
+| Platform | Minimum | Recommended |
+| -------- | ------- | ----------- |
+| WCAG 2.1 | 44×44px | 48×48px |
+| iOS (Apple) | 44×44pt | - |
+| Android | 48×48dp | - |
+
+### Touch Target Spacing
+
+- Minimum 8px between adjacent targets
+- Prefer 16px+ for comfort
+- Larger targets for primary actions
+
+### Pointer Gestures
+
+- Complex gestures must have single-pointer alternatives
+- Drag operations need equivalent click actions
+- Avoid hover-only functionality on touch devices
+
+---
+
+## Forms Accessibility
+
+### Labels
+
+Every input must have an associated label:
+
+```text
+<label for="email">Email Address</label>
+<input type="email" id="email" name="email">
+
+```
+
+### Required Fields
+
+```text
+<!-- Announce to screen readers -->
+<label for="name">
+  Name <span aria-label="required">*</span>
+</label>
+<input type="text" id="name" required aria-required="true">
+
+```
+
+### Error Handling
+
+```text
+<label for="email">Email</label>
+<input type="email" id="email" aria-invalid="true" aria-describedby="email-error">
+<span id="email-error" role="alert">
+  Please enter a valid email address
+</span>
+
+```
+
+### Form Instructions
+
+- Provide format hints before input
+- Show password requirements before errors
+- Group related fields with fieldset/legend
+
+---
+
+## Dynamic Content
+
+### Live Regions
+
+For content that updates dynamically:
+
+```text
+aria-live="polite" - Announce when convenient
+aria-live="assertive" - Announce immediately (interrupts)
+role="alert" - Urgent messages (like assertive)
+role="status" - Status updates (like polite)
+
+```
+
+### Loading States
+
+```text
+<button aria-busy="true" aria-live="polite">
+  <span class="spinner"></span>
+  Loading...
+</button>
+
+```
+
+### Modal Dialogs
+
+- Focus moves into modal when opened
+- Focus trapped within modal
+- Escape key closes modal
+- Focus returns to trigger element when closed
+
+---
+
+## Testing Accessibility
+
+### Manual Testing Checklist
+
+1. **Keyboard only:** Navigate entire page with Tab/Enter
+2. **Screen reader:** Test with VoiceOver (Mac) or NVDA (Windows)
+3. **Zoom 200%:** Content remains readable and usable
+4. **High contrast:** Test with system high contrast mode
+5. **No mouse:** Complete all tasks without pointing device
+
+### Automated Tools
+
+- axe DevTools (browser extension)
+- WAVE (WebAIM browser extension)
+- Lighthouse (Chrome DevTools)
+- Color contrast checkers (WebAIM, Contrast Ratio)
+
+### Common Issues to Check
+
+- [ ] Missing or empty alt text
+- [ ] Empty links or buttons
+- [ ] Missing form labels
+- [ ] Insufficient color contrast
+- [ ] Missing language attribute
+- [ ] Incorrect heading structure
+- [ ] Missing skip navigation link
+- [ ] Inaccessible custom widgets
+
+---
+
+## ARIA Quick Reference
+
+### Roles
+
+| Role | Purpose |
+| ---- | ------- |
+| `button` | Clickable button |
+| `link` | Navigation link |
+| `dialog` | Modal dialog |
+| `alert` | Important message |
+| `navigation` | Navigation region |
+| `main` | Main content |
+| `search` | Search functionality |
+| `tab/tablist/tabpanel` | Tab interface |
+
+### Properties
+
+| Property | Purpose |
+| -------- | ------- |
+| `aria-label` | Accessible name |
+| `aria-labelledby` | Reference to labeling element |
+| `aria-describedby` | Reference to description |
+| `aria-hidden` | Hide from assistive tech |
+| `aria-expanded` | Expandable state |
+| `aria-selected` | Selection state |
+| `aria-disabled` | Disabled state |
+| `aria-required` | Required field |
+| `aria-invalid` | Invalid input |
+
+### Golden Rule
+
+**First rule of ARIA:** Don't use ARIA if native HTML works.
+
+```text
+✗ <div role="button" tabindex="0">Click</div>
+✓ <button>Click</button>
+
+```
diff --git a/skills/penpot-uiux-design/references/component-patterns.md b/skills/penpot-uiux-design/references/component-patterns.md
new file mode 100644
index 00000000..3ebc8044
--- /dev/null
+++ b/skills/penpot-uiux-design/references/component-patterns.md
@@ -0,0 +1,339 @@
+# UI Component Patterns Reference
+
+## Buttons
+
+### Button Types
+
+| Type | Purpose | Visual Treatment |
+| ---- | ------- | ---------------- |
+| Primary | Main action on page | Solid fill, brand color |
+| Secondary | Supporting actions | Outline or muted fill |
+| Tertiary | Low-emphasis actions | Text-only, underline optional |
+| Destructive | Delete/remove actions | Red color, confirmation required |
+| Ghost | Minimal UI, icon buttons | Transparent, subtle hover |
+
+### Button States
+
+```text
+Default    → Resting state, clearly interactive
+Hover      → Cursor over (desktop): darken 10%, subtle shadow
+Active     → Being pressed: darken 20%, slight scale down
+Focus      → Keyboard selected: visible outline ring
+Disabled   → Not available: 50% opacity, cursor: not-allowed
+Loading    → Processing: spinner replaces or accompanies label
+
+```
+
+### Button Specifications
+
+- **Minimum size:** 44×44px (touch target)
+- **Padding:** 12-16px horizontal, 8-12px vertical
+- **Border radius:** 4-8px (consistent across app)
+- **Font weight:** Medium or Semibold (600-700)
+- **Text:** Sentence case, 2-4 words max
+
+### Button Label Patterns
+
+```text
+✓ Save Changes        ✗ Submit
+✓ Add to Cart         ✗ Click Here
+✓ Create Account      ✗ OK
+✓ Download PDF        ✗ Go
+✓ Start Free Trial    ✗ Continue
+
+```
+
+---
+
+## Forms
+
+### Form Layout Guidelines
+
+- **Single column preferred:** Reduces cognitive load
+- **Top-aligned labels:** Fastest completion times
+- **Logical grouping:** Related fields together
+- **Smart defaults:** Pre-fill when possible
+
+### Input Field Anatomy
+
+```text
+┌─ Label (required) ─────────────────────────┐
+│                                            │
+│  ┌────────────────────────────────────┐   │
+│  │ Placeholder text...                 │   │
+│  └────────────────────────────────────┘   │
+│  Helper text or error message              │
+└────────────────────────────────────────────┘
+
+```
+
+### Input States
+
+| State | Border | Background | Additional |
+| ----- | ------ | ---------- | ---------- |
+| Default | Gray (#D1D5DB) | White | - |
+| Focus | Primary color | White | Shadow/glow |
+| Filled | Gray | White | Checkmark optional |
+| Error | Red (#EF4444) | Light red tint | Error icon + message |
+| Disabled | Light gray | Gray (#F3F4F6) | 50% opacity text |
+
+### Validation Timing
+
+- **On blur:** Validate when user leaves field
+- **On change (after error):** Clear error as user types correct input
+- **On submit:** Final validation before processing
+- **Never on focus:** Don't show errors before user types
+
+### Error Message Guidelines
+
+```text
+✓ "Email address is required"
+✓ "Password must be at least 8 characters"
+✓ "Please enter a valid phone number (e.g., 555-123-4567)"
+
+✗ "Invalid input"
+✗ "Error"
+✗ "This field is required" (generic)
+
+```
+
+### Form Best Practices
+
+- Mark optional fields, not required (fewer asterisks)
+- Show password requirements before errors occur
+- Use input masks for formatted data (phone, date)
+- Preserve data on errors (don't clear the form)
+- Provide clear success confirmation
+
+---
+
+## Navigation
+
+### Navigation Patterns
+
+#### Top Navigation Bar
+
+```text
+┌─────────────────────────────────────────────────────┐
+│ Logo    Nav Item  Nav Item  Nav Item    [Search] [User] │
+└─────────────────────────────────────────────────────┘
+
+```
+
+- **Best for:** Marketing sites, simple apps
+- **Max items:** 5-7 top-level links
+- **Mobile:** Collapse to hamburger menu
+
+#### Sidebar Navigation
+
+```text
+┌────────┬────────────────────────────────┐
+│ Logo   │ Content Area                   │
+├────────┤                                │
+│ Nav 1  │                                │
+│ Nav 2  │                                │
+│ Nav 3  │                                │
+│        │                                │
+│ ────── │                                │
+│ Nav 4  │                                │
+│ Nav 5  │                                │
+└────────┴────────────────────────────────┘
+
+```
+
+- **Best for:** Dashboards, complex apps
+- **Width:** 200-280px expanded, 64px collapsed
+- **Mobile:** Overlay drawer
+
+#### Bottom Navigation (Mobile)
+
+```text
+┌─────────────────────────────────────┐
+│           Content Area              │
+│                                     │
+├─────────────────────────────────────┤
+│  🏠    🔍    ➕    💬    👤        │
+│ Home  Search Add  Chat  Profile     │
+└─────────────────────────────────────┘
+
+```
+
+- **Max items:** 3-5 destinations
+- **Best for:** Primary app sections
+- **Always visible:** Persistent navigation
+
+#### Breadcrumbs
+
+```text
+Home > Products > Electronics > Headphones
+
+```
+
+- **Use for:** Deep hierarchies (3+ levels)
+- **Current page:** Not clickable, different style
+- **Separator:** > or / or chevron icon
+
+### Tab Navigation
+
+```text
+┌─────────┬─────────┬─────────┬─────────┐
+│ Tab 1   │ Tab 2   │ Tab 3   │ Tab 4   │
+└─────────┴─────────┴─────────┴─────────┘
+│                                       │
+│        Tab Content Area               │
+│                                       │
+└───────────────────────────────────────┘
+
+```
+
+- **Max tabs:** 3-5 for clarity
+- **Active indicator:** Underline or background
+- **Use for:** Related content within same page
+
+---
+
+## Cards
+
+### Card Anatomy
+
+```text
+┌─────────────────────────────────┐
+│ ░░░░░░░ Image/Media ░░░░░░░░░░ │
+├─────────────────────────────────┤
+│ Category Label                  │
+│ Card Title                      │
+│ Description text that may       │
+│ span multiple lines...          │
+│                                 │
+│ [Action Button]  [Secondary]    │
+└─────────────────────────────────┘
+
+```
+
+### Card Guidelines
+
+- **Consistent sizing:** Use grid, equal heights
+- **Content hierarchy:** Image → Title → Description → Actions
+- **Padding:** 16-24px internal spacing
+- **Border radius:** 8-12px (matching buttons)
+- **Shadow:** Subtle elevation (0 2px 4px rgba(0,0,0,0.1))
+
+---
+
+## Modals and Dialogs
+
+### Modal Structure
+
+```text
+┌─────────────────────────────────────┐
+│ Modal Title                    [×]  │
+├─────────────────────────────────────┤
+│                                     │
+│ Modal content goes here.            │
+│ Keep it focused on one task.        │
+│                                     │
+├─────────────────────────────────────┤
+│           [Cancel]  [Confirm]       │
+└─────────────────────────────────────┘
+
+```
+
+### Modal Guidelines
+
+- **Size:** 400-600px width (desktop), full-width minus margins (mobile)
+- **Overlay:** Semi-transparent dark background (rgba(0,0,0,0.5))
+- **Close options:** X button, overlay click, Escape key
+- **Focus trap:** Keep keyboard focus within modal
+- **Primary action:** Right-aligned, visually prominent
+
+---
+
+## Dashboards
+
+### Dashboard Layout Principles
+
+1. **Most important metrics at top:** KPIs, summary cards
+2. **Progressive detail:** Overview → Drill-down capability
+3. **Consistent card sizes:** Use grid system
+4. **Minimal chartjunk:** Only data-serving visuals
+5. **Actionable insights:** Highlight anomalies
+
+### Data Visualization Selection
+
+| Data Type | Chart Type |
+| --------- | ---------- |
+| Comparison across categories | Bar chart |
+| Trend over time | Line chart |
+| Part of whole | Pie (≤5 slices) or Donut |
+| Distribution | Histogram |
+| Correlation | Scatter plot |
+| Geographic | Map |
+| Single metric | Big number + sparkline |
+
+### Dashboard Best Practices
+
+- **Limit to 5-9 widgets** per view
+- **Align to grid:** Consistent gutters and sizing
+- **Filter controls:** Top or sidebar, always visible
+- **Date range selector:** Common need, make prominent
+- **Export options:** PDF, CSV for data tables
+- **Responsive:** Stack cards on smaller screens
+
+---
+
+## Empty States
+
+### Empty State Components
+
+```text
+┌─────────────────────────────────────┐
+│                                     │
+│         [Illustration/Icon]         │
+│                                     │
+│      No projects yet                │
+│                                     │
+│   Create your first project to      │
+│   start organizing your work.       │
+│                                     │
+│       [Create Project]              │
+│                                     │
+└─────────────────────────────────────┘
+
+```
+
+### Empty State Guidelines
+
+- **Friendly illustration:** Not just "No data"
+- **Explain value:** Why create something?
+- **Clear CTA:** Primary action to fix empty state
+- **Keep it brief:** 1-2 sentences max
+
+---
+
+## Loading States
+
+### Loading Patterns
+
+| Duration | Pattern |
+| -------- | ------- |
+| <1 second | No indicator (feels instant) |
+| 1-3 seconds | Spinner or progress indicator |
+| 3-10 seconds | Skeleton screens + progress |
+| >10 seconds | Progress bar + explanation |
+
+### Skeleton Screen
+
+```text
+┌─────────────────────────────────────┐
+│ ░░░░░░░░░░░░ ░░░░░░░░░░           │
+├─────────────────────────────────────┤
+│ ░░░░░░░░░░░░░░░░░░░░░░░░░         │
+│ ░░░░░░░░░░░░░░░░░░░               │
+│ ░░░░░░░░░░░░░░░░░░░░░░░           │
+└─────────────────────────────────────┘
+
+```
+
+- Match layout of loaded content
+- Use subtle animation (shimmer/pulse)
+- Show actual content structure
diff --git a/skills/penpot-uiux-design/references/platform-guidelines.md b/skills/penpot-uiux-design/references/platform-guidelines.md
new file mode 100644
index 00000000..2824becc
--- /dev/null
+++ b/skills/penpot-uiux-design/references/platform-guidelines.md
@@ -0,0 +1,367 @@
+# Platform Design Guidelines Reference
+
+## Mobile Design Fundamentals
+
+### Screen Sizes
+
+| Device | Size | Design At |
+| ------ | ---- | --------- |
+| iPhone SE | 375×667 | Small mobile |
+| iPhone 14/15 | 390×844 | Standard mobile |
+| iPhone 14 Pro Max | 430×932 | Large mobile |
+| Android small | 360×640 | Minimum target |
+| Android large | 412×915 | Large Android |
+
+### Safe Areas
+
+```text
+┌─────────────────────────────────┐
+│ ▓▓▓▓▓▓▓ Status Bar ▓▓▓▓▓▓▓▓▓▓ │ 44-47px
+├─────────────────────────────────┤
+│                                 │
+│      Safe Content Area          │
+│                                 │
+│                                 │
+├─────────────────────────────────┤
+│ ▓▓▓▓▓▓ Home Indicator ▓▓▓▓▓▓▓ │ 34px
+└─────────────────────────────────┘
+
+```
+
+### Touch Targets
+
+- **Minimum:** 44×44pt (iOS) / 48×48dp (Android)
+- **Recommended:** 48×48px for all platforms
+- **Spacing:** Minimum 8px between targets
+
+---
+
+## iOS Human Interface Guidelines (HIG)
+
+### Design Philosophy
+
+- **Clarity:** Text is legible, icons precise, adornments subtle
+- **Deference:** UI helps people understand content, never competes
+- **Depth:** Distinct visual layers convey hierarchy
+
+### Navigation Patterns
+
+| Pattern | When to Use |
+| ------- | ----------- |
+| Tab Bar | 3-5 top-level destinations |
+| Navigation Bar | Hierarchical content |
+| Sidebar | iPad, rich content apps |
+| Search | Content discovery |
+
+### Tab Bar Specifications
+
+```text
+┌─────────────────────────────────┐
+│  🏠    🔍    ➕    💬    👤    │
+│ Home  Search Add  Chat  Profile │ 49pt height
+└─────────────────────────────────┘
+
+```
+
+- Max 5 tabs
+- Icons 25×25pt with 10pt labels
+- Active tab uses fill/tint color
+- Inactive tabs use gray
+
+### Navigation Bar
+
+```text
+┌─────────────────────────────────┐
+│ ‹ Back    Page Title    Action │ 44pt minimum
+└─────────────────────────────────┘
+
+```
+
+- Left: Back button or cancel
+- Center: Title
+- Right: Primary action (text or icon)
+
+### Typography (SF Pro)
+
+| Style | Size | Weight |
+| ----- | ---- | ------ |
+| Large Title | 34pt | Bold |
+| Title 1 | 28pt | Bold |
+| Title 2 | 22pt | Bold |
+| Title 3 | 20pt | Semibold |
+| Headline | 17pt | Semibold |
+| Body | 17pt | Regular |
+| Callout | 16pt | Regular |
+| Subhead | 15pt | Regular |
+| Footnote | 13pt | Regular |
+| Caption | 12pt | Regular |
+
+### iOS Colors (System)
+
+| Color | Light | Dark |
+| ----- | ----- | ---- |
+| Label | #000000 | #FFFFFF |
+| Secondary Label | #3C3C43 @ 60% | #EBEBF5 @ 60% |
+| Tertiary Label | #3C3C43 @ 30% | #EBEBF5 @ 30% |
+| System Blue | #007AFF | #0A84FF |
+| System Green | #34C759 | #30D158 |
+| System Red | #FF3B30 | #FF453A |
+| System Orange | #FF9500 | #FF9F0A |
+
+### iOS-Specific Patterns
+
+- **Swipe gestures:** Delete, archive, actions
+- **Pull to refresh:** Standard list refresh
+- **Long press:** Context menus
+- **Haptic feedback:** Confirm actions
+- **Edge swipe:** Back navigation
+
+---
+
+## Android Material Design
+
+### Android Design Philosophy
+
+- **Material as metaphor:** Physical properties, elevation
+- **Bold, graphic, intentional:** Deliberate color, typography, space
+- **Motion provides meaning:** Feedback and continuity
+
+### Android Navigation Patterns
+
+| Pattern | When to Use |
+| ------- | ----------- |
+| Bottom Navigation | 3-5 top destinations |
+| Navigation Drawer | 5+ destinations, less frequent |
+| Navigation Rail | Tablet landscape |
+| Tabs | Related content groups |
+
+### Bottom Navigation
+
+```text
+┌─────────────────────────────────┐
+│  🏠    🔍    📷    💬    👤    │
+│ Home  Search Camera Chat Account│ 80dp height
+└─────────────────────────────────┘
+
+```
+
+- 3-5 destinations
+- Icons 24dp with 12sp labels
+- Active: filled icon + primary color
+- Inactive: outlined icon + on-surface
+
+### App Bar
+
+```text
+┌─────────────────────────────────┐
+│ ≡  App Title                🔍 │ 64dp height
+└─────────────────────────────────┘
+
+```
+
+- Left: Navigation icon (menu or back)
+- Center: Title (can be left-aligned)
+- Right: Action icons (max 3)
+
+### Floating Action Button (FAB)
+
+- **Size:** 56dp standard, 40dp mini
+- **Position:** Bottom right, 16dp from edges
+- **Purpose:** Primary action only
+- **Behavior:** Can hide on scroll
+
+### Typography (Roboto)
+
+| Style | Size | Weight | Tracking |
+| ----- | ---- | ------ | -------- |
+| Display Large | 57sp | Regular | -0.25 |
+| Display Medium | 45sp | Regular | 0 |
+| Display Small | 36sp | Regular | 0 |
+| Headline Large | 32sp | Regular | 0 |
+| Headline Medium | 28sp | Regular | 0 |
+| Headline Small | 24sp | Regular | 0 |
+| Title Large | 22sp | Regular | 0 |
+| Title Medium | 16sp | Medium | 0.15 |
+| Title Small | 14sp | Medium | 0.1 |
+| Body Large | 16sp | Regular | 0.5 |
+| Body Medium | 14sp | Regular | 0.25 |
+| Body Small | 12sp | Regular | 0.4 |
+| Label Large | 14sp | Medium | 0.1 |
+| Label Medium | 12sp | Medium | 0.5 |
+| Label Small | 11sp | Medium | 0.5 |
+
+### Material Colors
+
+| Role | Purpose |
+| ---- | ------- |
+| Primary | Main brand color |
+| On Primary | Text/icons on primary |
+| Primary Container | Filled buttons, active states |
+| Secondary | Less prominent components |
+| Tertiary | Contrast, balance |
+| Error | Error states |
+| Surface | Card backgrounds |
+| On Surface | Text on surfaces |
+| Outline | Borders, dividers |
+
+### Elevation (Shadows)
+
+| Level | Elevation | Use Case |
+| ----- | --------- | -------- |
+| 0 | 0dp | Flat surfaces |
+| 1 | 1dp | Cards, raised buttons |
+| 2 | 3dp | Elevated cards |
+| 3 | 6dp | FAB resting |
+| 4 | 8dp | Dialogs, pickers |
+| 5 | 12dp | FAB pressed |
+
+### Android-Specific Patterns
+
+- **Snackbar:** Brief feedback at bottom
+- **Bottom sheet:** Additional content/actions
+- **Chips:** Filter, input, choice, action
+- **Speed dial FAB:** Multiple related actions
+
+---
+
+## Responsive Web Design
+
+### Breakpoints
+
+| Name | Width | Typical Device |
+| ---- | ----- | -------------- |
+| xs | <576px | Mobile portrait |
+| sm | 576-767px | Mobile landscape |
+| md | 768-991px | Tablet |
+| lg | 992-1199px | Small desktop |
+| xl | 1200-1399px | Desktop |
+| xxl | ≥1400px | Large desktop |
+
+### Grid System
+
+- **Columns:** 12-column grid standard
+- **Gutters:** 16-24px between columns
+- **Margins:** 16px (mobile) to 64px (desktop)
+- **Max content width:** 1200-1440px
+
+### Responsive Typography
+
+```text
+Mobile (base):
+  Body: 16px
+  H1: 28-32px
+  H2: 22-24px
+  
+Tablet:
+  Body: 16px
+  H1: 32-40px
+  H2: 24-28px
+  
+Desktop:
+  Body: 16-18px
+  H1: 40-56px
+  H2: 28-36px
+
+```
+
+### Mobile-First Approach
+
+1. Design for smallest screen first
+2. Add complexity for larger screens
+3. Content priority: What's essential?
+4. Performance: Minimize for mobile
+5. Touch-first interactions
+
+### Responsive Patterns
+
+| Pattern | Description |
+| ------- | ----------- |
+| Stack | Columns become rows on mobile |
+| Reflow | Content reorders based on priority |
+| Reveal | More content shown at larger sizes |
+| Off-canvas | Navigation slides in on mobile |
+| Scale | Elements scale proportionally |
+
+---
+
+## Desktop Applications
+
+### Window Chrome
+
+```text
+┌─────────────────────────────────────────┐
+│ ● ● ●   App Title              ─ □ ×  │ Title bar
+├────────┬────────────────────────────────┤
+│ Sidebar│ Content Area                   │
+│        │                                │
+│        │                                │
+│        │                                │
+│        ├────────────────────────────────┤
+│        │ Status Bar                     │
+└────────┴────────────────────────────────┘
+
+```
+
+### Keyboard-First Design
+
+- All actions accessible via keyboard
+- Visible keyboard shortcuts
+- Focus management for tab order
+- Search/command palette (Cmd/Ctrl+K)
+
+### Hover States
+
+Desktop has hover (mobile doesn't):
+
+- Show additional info on hover
+- Preview actions before click
+- Tooltips for icon-only buttons
+- Dropdown menus on hover
+
+### Dense Information
+
+Desktop allows for:
+
+- Smaller touch targets (32px min)
+- More visible information
+- Complex tables and data grids
+- Multi-column layouts
+- Side-by-side comparisons
+
+---
+
+## Cross-Platform Considerations
+
+### Shared Principles
+
+- Consistent brand identity
+- Same core user flows
+- Synchronized data/state
+- Familiar information architecture
+
+### Platform-Specific Adaptations
+
+| Aspect | iOS | Android | Web |
+| ------ | --- | ------- | --- |
+| Back | Left nav | Left or gesture | Browser back |
+| Primary action | Right nav | FAB | Top right button |
+| Lists | Swipe actions | Long press | Hover actions |
+| Menus | Action sheets | Bottom sheet | Dropdown/context |
+| Alerts | Centered modal | Centered modal | Various positions |
+
+### Design Tokens Across Platforms
+
+Create platform-agnostic tokens:
+
+```text
+// Spacing
+spacing-sm: 8
+spacing-md: 16
+spacing-lg: 24
+
+// These map to platform units
+iOS: points (pt)
+Android: density-independent pixels (dp)
+Web: pixels (px) or rem
+
+```

From 56c929ffd1bcb7f2591ef7a0137f99d188909f62 Mon Sep 17 00:00:00 2001
From: Jcardif <29174946+Jcardif@users.noreply.github.com>
Date: Thu, 29 Jan 2026 17:26:53 +0300
Subject: [PATCH 02/49] Use single quotes for description field

---
 skills/penpot-uiux-design/SKILL.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/skills/penpot-uiux-design/SKILL.md b/skills/penpot-uiux-design/SKILL.md
index dac7dc85..798711d2 100644
--- a/skills/penpot-uiux-design/SKILL.md
+++ b/skills/penpot-uiux-design/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: penpot-uiux-design
-description: "Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: 'design a UI', 'create interface', 'build layout', 'design dashboard', 'create form', 'design landing page', 'make it accessible', 'design system', 'component library'."
+description: 'Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library".'
 ---
 
 # Penpot UI/UX Design Guide

From c8a7199032c5e6dc174fc4c6a6952412664af4d3 Mon Sep 17 00:00:00 2001
From: Jcardif <29174946+Jcardif@users.noreply.github.com>
Date: Thu, 29 Jan 2026 17:27:50 +0300
Subject: [PATCH 03/49] Update README.skills.md

---
 docs/README.skills.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/README.skills.md b/docs/README.skills.md
index 8024842c..d4f156ac 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -41,7 +41,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [microsoft-code-reference](../skills/microsoft-code-reference/SKILL.md) | Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs. | None |
 | [microsoft-docs](../skills/microsoft-docs/SKILL.md) | Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices. | None |
 | [nuget-manager](../skills/nuget-manager/SKILL.md) | Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions. | None |
-| [penpot-uiux-design](../skills/penpot-uiux-design/SKILL.md) | Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: 'design a UI', 'create interface', 'build layout', 'design dashboard', 'create form', 'design landing page', 'make it accessible', 'design system', 'component library'. | `references/accessibility.md`<br />`references/component-patterns.md`<br />`references/platform-guidelines.md` |
+| [penpot-uiux-design](../skills/penpot-uiux-design/SKILL.md) | Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library". | `references/accessibility.md`<br />`references/component-patterns.md`<br />`references/platform-guidelines.md` |
 | [plantuml-ascii](../skills/plantuml-ascii/SKILL.md) | Generate ASCII art diagrams using PlantUML text mode. Use when user asks to create ASCII diagrams, text-based diagrams, terminal-friendly diagrams, or mentions plantuml ascii, text diagram, ascii art diagram. Supports: Converting PlantUML diagrams to ASCII art, Creating sequence diagrams, class diagrams, flowcharts in ASCII format, Generating Unicode-enhanced ASCII art with -utxt flag | None |
 | [prd](../skills/prd/SKILL.md) | Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis. | None |
 | [refactor](../skills/refactor/SKILL.md) | Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements. | None |

From f57435a9659c38f047c359163bf30cf594d85f52 Mon Sep 17 00:00:00 2001
From: jun-shiromizu <jun.shiromizu@jp.nttdata.com>
Date: Fri, 30 Jan 2026 22:58:26 +0900
Subject: [PATCH 04/49] feat(skills): add excalidraw-diagram-generator skill
 and docs update

---
 docs/README.skills.md                         |   1 +
 skills/excalidraw-diagram-generator/SKILL.md  | 612 ++++++++++++++++
 .../libraries/.gitkeep                        |   0
 .../references/element-types.md               | 497 +++++++++++++
 .../references/excalidraw-schema.md           | 350 +++++++++
 .../scripts/README.md                         | 193 +++++
 .../scripts/add-arrow.py                      | 312 +++++++++
 .../scripts/add-icon-to-diagram.py            | 404 +++++++++++
 .../scripts/split-excalidraw-library.py       | 183 +++++
 ...business-flow-swimlane-template.excalidraw | 334 +++++++++
 .../class-diagram-template.excalidraw         | 558 +++++++++++++++
 .../data-flow-diagram-template.excalidraw     | 279 ++++++++
 .../templates/er-diagram-template.excalidraw  | 662 ++++++++++++++++++
 .../templates/flowchart-template.excalidraw   | 179 +++++
 .../templates/mindmap-template.excalidraw     | 244 +++++++
 .../relationship-template.excalidraw          | 145 ++++
 .../sequence-diagram-template.excalidraw      | 509 ++++++++++++++
 17 files changed, 5462 insertions(+)
 create mode 100644 skills/excalidraw-diagram-generator/SKILL.md
 create mode 100644 skills/excalidraw-diagram-generator/libraries/.gitkeep
 create mode 100644 skills/excalidraw-diagram-generator/references/element-types.md
 create mode 100644 skills/excalidraw-diagram-generator/references/excalidraw-schema.md
 create mode 100644 skills/excalidraw-diagram-generator/scripts/README.md
 create mode 100644 skills/excalidraw-diagram-generator/scripts/add-arrow.py
 create mode 100644 skills/excalidraw-diagram-generator/scripts/add-icon-to-diagram.py
 create mode 100644 skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py
 create mode 100644 skills/excalidraw-diagram-generator/templates/business-flow-swimlane-template.excalidraw
 create mode 100644 skills/excalidraw-diagram-generator/templates/class-diagram-template.excalidraw
 create mode 100644 skills/excalidraw-diagram-generator/templates/data-flow-diagram-template.excalidraw
 create mode 100644 skills/excalidraw-diagram-generator/templates/er-diagram-template.excalidraw
 create mode 100644 skills/excalidraw-diagram-generator/templates/flowchart-template.excalidraw
 create mode 100644 skills/excalidraw-diagram-generator/templates/mindmap-template.excalidraw
 create mode 100644 skills/excalidraw-diagram-generator/templates/relationship-template.excalidraw
 create mode 100644 skills/excalidraw-diagram-generator/templates/sequence-diagram-template.excalidraw

diff --git a/docs/README.skills.md b/docs/README.skills.md
index bdb1c155..a556b254 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -31,6 +31,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [azure-static-web-apps](../skills/azure-static-web-apps/SKILL.md) | Helps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configuring staticwebapp.config.json, adding Azure Functions APIs to SWA, or setting up GitHub Actions CI/CD for Static Web Apps. | None |
 | [chrome-devtools](../skills/chrome-devtools/SKILL.md) | Expert-level browser automation, debugging, and performance analysis using Chrome DevTools MCP. Use for interacting with web pages, capturing screenshots, analyzing network traffic, and profiling performance. | None |
 | [copilot-sdk](../skills/copilot-sdk/SKILL.md) | Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent. | None |
+| [excalidraw-diagram-generator](../skills/excalidraw-diagram-generator/SKILL.md) | Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw. | `libraries/.gitkeep`<br />`references/element-types.md`<br />`references/excalidraw-schema.md`<br />`scripts/README.md`<br />`scripts/add-arrow.py`<br />`scripts/add-icon-to-diagram.py`<br />`scripts/split-excalidraw-library.py`<br />`templates/business-flow-swimlane-template.excalidraw`<br />`templates/class-diagram-template.excalidraw`<br />`templates/data-flow-diagram-template.excalidraw`<br />`templates/er-diagram-template.excalidraw`<br />`templates/flowchart-template.excalidraw`<br />`templates/mindmap-template.excalidraw`<br />`templates/relationship-template.excalidraw`<br />`templates/sequence-diagram-template.excalidraw` |
 | [gh-cli](../skills/gh-cli/SKILL.md) | GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line. | None |
 | [git-commit](../skills/git-commit/SKILL.md) | Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping | None |
 | [github-issues](../skills/github-issues/SKILL.md) | Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, or manage issue workflows. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", or any GitHub issue management task. | `references/templates.md` |
diff --git a/skills/excalidraw-diagram-generator/SKILL.md b/skills/excalidraw-diagram-generator/SKILL.md
new file mode 100644
index 00000000..1f040b36
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/SKILL.md
@@ -0,0 +1,612 @@
+---
+name: excalidraw-diagram-generator
+description: 'Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw.'
+---
+
+# Excalidraw Diagram Generator
+
+A skill for generating Excalidraw-format diagrams from natural language descriptions. This skill helps create visual representations of processes, systems, relationships, and ideas without manual drawing.
+
+## When to Use This Skill
+
+Use this skill when users request:
+
+- "Create a diagram showing..."
+- "Make a flowchart for..."
+- "Visualize the process of..."
+- "Draw the system architecture of..."
+- "Generate a mind map about..."
+- "Create an Excalidraw file for..."
+- "Show the relationship between..."
+- "Diagram the workflow of..."
+
+**Supported diagram types:**
+- 📊 **Flowcharts**: Sequential processes, workflows, decision trees
+- 🔗 **Relationship Diagrams**: Entity relationships, system components, dependencies
+- 🧠 **Mind Maps**: Concept hierarchies, brainstorming results, topic organization
+- 🏗️ **Architecture Diagrams**: System design, module interactions, data flow
+- 📈 **Data Flow Diagrams (DFD)**: Data flow visualization, data transformation processes
+- 🏊 **Business Flow (Swimlane)**: Cross-functional workflows, actor-based process flows
+- 📦 **Class Diagrams**: Object-oriented design, class structures and relationships
+- 🔄 **Sequence Diagrams**: Object interactions over time, message flows
+- 🗃️ **ER Diagrams**: Database entity relationships, data models
+
+## Prerequisites
+
+- Clear description of what should be visualized
+- Identification of key entities, steps, or concepts
+- Understanding of relationships or flow between elements
+
+## Step-by-Step Workflow
+
+### Step 1: Understand the Request
+
+Analyze the user's description to determine:
+1. **Diagram type** (flowchart, relationship, mind map, architecture)
+2. **Key elements** (entities, steps, concepts)
+3. **Relationships** (flow, connections, hierarchy)
+4. **Complexity** (number of elements)
+
+### Step 2: Choose the Appropriate Diagram Type
+
+| User Intent | Diagram Type | Example Keywords |
+|-------------|--------------|------------------|
+| Process flow, steps, procedures | **Flowchart** | "workflow", "process", "steps", "procedure" |
+| Connections, dependencies, associations | **Relationship Diagram** | "relationship", "connections", "dependencies", "structure" |
+| Concept hierarchy, brainstorming | **Mind Map** | "mind map", "concepts", "ideas", "breakdown" |
+| System design, components | **Architecture Diagram** | "architecture", "system", "components", "modules" |
+| Data flow, transformation processes | **Data Flow Diagram (DFD)** | "data flow", "data processing", "data transformation" |
+| Cross-functional processes, actor responsibilities | **Business Flow (Swimlane)** | "business process", "swimlane", "actors", "responsibilities" |
+| Object-oriented design, class structures | **Class Diagram** | "class", "inheritance", "OOP", "object model" |
+| Interaction sequences, message flows | **Sequence Diagram** | "sequence", "interaction", "messages", "timeline" |
+| Database design, entity relationships | **ER Diagram** | "database", "entity", "relationship", "data model" |
+
+### Step 3: Extract Structured Information
+
+**For Flowcharts:**
+- List of sequential steps
+- Decision points (if any)
+- Start and end points
+
+**For Relationship Diagrams:**
+- Entities/nodes (name + optional description)
+- Relationships between entities (from → to, with label)
+
+**For Mind Maps:**
+- Central topic
+- Main branches (3-6 recommended)
+- Sub-topics for each branch (optional)
+
+**For Data Flow Diagrams (DFD):**
+- Data sources and destinations (external entities)
+- Processes (data transformations)
+- Data stores (databases, files)
+- Data flows (arrows showing data movement from left-to-right or from top-left to bottom-right)
+- **Important**: Do not represent process order, only data flow
+
+**For Business Flow (Swimlane):**
+- Actors/roles (departments, systems, people) - displayed as header columns
+- Process lanes (vertical lanes under each actor)
+- Process boxes (activities within each lane)
+- Flow arrows (connecting process boxes, including cross-lane handoffs)
+
+**For Class Diagrams:**
+- Classes with names
+- Attributes with visibility (+, -, #)
+- Methods with visibility and parameters
+- Relationships: inheritance (solid line + white triangle), implementation (dashed line + white triangle), association (solid line), dependency (dashed line), aggregation (solid line + white diamond), composition (solid line + filled diamond)
+- Multiplicity notations (1, 0..1, 1..*, *)
+
+**For Sequence Diagrams:**
+- Objects/actors (arranged horizontally at top)
+- Lifelines (vertical lines from each object)
+- Messages (horizontal arrows between lifelines)
+- Synchronous messages (solid arrow), asynchronous messages (dashed arrow)
+- Return values (dashed arrows)
+- Activation boxes (rectangles on lifelines during execution)
+- Time flows from top to bottom
+
+**For ER Diagrams:**
+- Entities (rectangles with entity names)
+- Attributes (listed inside entities)
+- Primary keys (underlined or marked with PK)
+- Foreign keys (marked with FK)
+- Relationships (lines connecting entities)
+- Cardinality: 1:1 (one-to-one), 1:N (one-to-many), N:M (many-to-many)
+- Junction/associative entities for many-to-many relationships (dashed rectangles)
+
+### Step 4: Generate the Excalidraw JSON
+
+Create the `.excalidraw` file with appropriate elements:
+
+**Available element types:**
+- `rectangle`: Boxes for entities, steps, concepts
+- `ellipse`: Alternative shapes for emphasis
+- `diamond`: Decision points
+- `arrow`: Directional connections
+- `text`: Labels and annotations
+
+**Key properties to set:**
+- **Position**: `x`, `y` coordinates
+- **Size**: `width`, `height`
+- **Style**: `strokeColor`, `backgroundColor`, `fillStyle`
+- **Font**: `fontFamily: 5` (Excalifont - **required for all text elements**)
+- **Text**: Embedded text for labels
+- **Connections**: `points` array for arrows
+
+**Important**: All text elements must use `fontFamily: 5` (Excalifont) for consistent visual appearance.
+
+### Step 5: Format the Output
+
+Structure the complete Excalidraw file:
+
+```json
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://excalidraw.com",
+  "elements": [
+    // Array of diagram elements
+  ],
+  "appState": {
+    "viewBackgroundColor": "#ffffff",
+    "gridSize": 20
+  },
+  "files": {}
+}
+```
+
+### Step 6: Save and Provide Instructions
+
+1. Save as `<descriptive-name>.excalidraw`
+2. Inform user how to open:
+   - Visit https://excalidraw.com
+   - Click "Open" or drag-and-drop the file
+   - Or use Excalidraw VS Code extension
+
+## Best Practices
+
+### Element Count Guidelines
+
+| Diagram Type | Recommended Count | Maximum |
+|--------------|-------------------|---------|
+| Flowchart steps | 3-10 | 15 |
+| Relationship entities | 3-8 | 12 |
+| Mind map branches | 4-6 | 8 |
+| Mind map sub-topics per branch | 2-4 | 6 |
+
+### Layout Tips
+
+1. **Start positions**: Center important elements, use consistent spacing
+2. **Spacing**: 
+   - Horizontal gap: 200-300px between elements
+   - Vertical gap: 100-150px between rows
+3. **Colors**: Use consistent color scheme
+   - Primary elements: Light blue (`#a5d8ff`)
+   - Secondary elements: Light green (`#b2f2bb`)
+   - Important/Central: Yellow (`#ffd43b`)
+   - Alerts/Warnings: Light red (`#ffc9c9`)
+4. **Text sizing**: 16-24px for readability
+5. **Font**: Always use `fontFamily: 5` (Excalifont) for all text elements
+6. **Arrow style**: Use straight arrows for simple flows, curved for complex relationships
+
+### Complexity Management
+
+**If user request has too many elements:**
+- Suggest breaking into multiple diagrams
+- Focus on main elements first
+- Offer to create detailed sub-diagrams
+
+**Example response:**
+```
+"Your request includes 15 components. For clarity, I recommend:
+1. High-level architecture diagram (6 main components)
+2. Detailed diagram for each subsystem
+
+Would you like me to start with the high-level view?"
+```
+
+## Example Prompts and Responses
+
+### Example 1: Simple Flowchart
+
+**User:** "Create a flowchart for user registration"
+
+**Agent generates:**
+1. Extract steps: "Enter email" → "Verify email" → "Set password" → "Complete"
+2. Create flowchart with 4 rectangles + 3 arrows
+3. Save as `user-registration-flow.excalidraw`
+
+### Example 2: Relationship Diagram
+
+**User:** "Diagram the relationship between User, Post, and Comment entities"
+
+**Agent generates:**
+1. Entities: User, Post, Comment
+2. Relationships: User → Post ("creates"), User → Comment ("writes"), Post → Comment ("contains")
+3. Save as `user-content-relationships.excalidraw`
+
+### Example 3: Mind Map
+
+**User:** "Mind map about machine learning concepts"
+
+**Agent generates:**
+1. Center: "Machine Learning"
+2. Branches: Supervised Learning, Unsupervised Learning, Reinforcement Learning, Deep Learning
+3. Sub-topics under each branch
+4. Save as `machine-learning-mindmap.excalidraw`
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Elements overlap | Increase spacing between coordinates |
+| Text doesn't fit in boxes | Increase box width or reduce font size |
+| Too many elements | Break into multiple diagrams |
+| Unclear layout | Use grid layout (rows/columns) or radial layout (mind maps) |
+| Colors inconsistent | Define color palette upfront based on element types |
+
+## Advanced Techniques
+
+### Grid Layout (for Relationship Diagrams)
+```javascript
+const columns = Math.ceil(Math.sqrt(entityCount));
+const x = startX + (index % columns) * horizontalGap;
+const y = startY + Math.floor(index / columns) * verticalGap;
+```
+
+### Radial Layout (for Mind Maps)
+```javascript
+const angle = (2 * Math.PI * index) / branchCount;
+const x = centerX + radius * Math.cos(angle);
+const y = centerY + radius * Math.sin(angle);
+```
+
+### Auto-generated IDs
+Use timestamp + random string for unique IDs:
+```javascript
+const id = Date.now().toString(36) + Math.random().toString(36).substr(2);
+```
+
+## Output Format
+
+Always provide:
+1. ✅ Complete `.excalidraw` JSON file
+2. 📊 Summary of what was created
+3. 📝 Element count
+4. 💡 Instructions for opening/editing
+
+**Example summary:**
+```
+Created: user-workflow.excalidraw
+Type: Flowchart
+Elements: 7 rectangles, 6 arrows, 1 title text
+Total: 14 elements
+
+To view:
+1. Visit https://excalidraw.com
+2. Drag and drop user-workflow.excalidraw
+3. Or use File → Open in Excalidraw VS Code extension
+```
+
+## Validation Checklist
+
+Before delivering the diagram:
+- [ ] All elements have unique IDs
+- [ ] Coordinates prevent overlapping
+- [ ] Text is readable (font size 16+)
+- [ ] **All text elements use `fontFamily: 5` (Excalifont)**
+- [ ] Arrows connect logically
+- [ ] Colors follow consistent scheme
+- [ ] File is valid JSON
+- [ ] Element count is reasonable (<20 for clarity)
+
+## Icon Libraries (Optional Enhancement)
+
+For specialized diagrams (e.g., AWS/GCP/Azure architecture diagrams), you can use pre-made icon libraries from Excalidraw. This provides professional, standardized icons instead of basic shapes.
+
+### When User Requests Icons
+
+**If user asks for AWS/cloud architecture diagrams or mentions wanting to use specific icons:**
+
+1. **Check if library exists**: Look for `libraries/<library-name>/reference.md`
+2. **If library exists**: Proceed to use icons (see AI Assistant Workflow below)
+3. **If library does NOT exist**: Respond with setup instructions:
+
+   ```
+   To use [AWS/GCP/Azure/etc.] architecture icons, please follow these steps:
+   
+   1. Visit https://libraries.excalidraw.com/
+   2. Search for "[AWS Architecture Icons/etc.]" and download the .excalidrawlib file
+   3. Create directory: skills/excalidraw-diagram-generator/libraries/[icon-set-name]/
+   4. Place the downloaded file in that directory
+   5. Run the splitter script:
+      python skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py skills/excalidraw-diagram-generator/libraries/[icon-set-name]/
+   
+   This will split the library into individual icon files for efficient use.
+   After setup is complete, I can create your diagram using the actual AWS/cloud icons.
+   
+   Alternatively, I can create the diagram now using simple shapes (rectangles, ellipses) 
+   which you can later replace with icons manually in Excalidraw.
+   ```
+
+### User Setup Instructions (Detailed)
+
+**Step 1: Create Library Directory**
+```bash
+mkdir -p skills/excalidraw-diagram-generator/libraries/aws-architecture-icons
+```
+
+**Step 2: Download Library**
+- Visit: https://libraries.excalidraw.com/
+- Search for your desired icon set (e.g., "AWS Architecture Icons")
+- Click download to get the `.excalidrawlib` file
+- Example categories (availability varies; confirm on the site):
+   - Cloud service icons
+   - UI/Material icons
+   - Flowchart symbols
+
+**Step 3: Place Library File**
+- Rename the downloaded file to match the directory name (e.g., `aws-architecture-icons.excalidrawlib`)
+- Move it to the directory created in Step 1
+
+**Step 4: Run Splitter Script**
+```bash
+python skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py skills/excalidraw-diagram-generator/libraries/aws-architecture-icons/
+```
+
+**Step 5: Verify Setup**
+After running the script, verify the following structure exists:
+```
+skills/excalidraw-diagram-generator/libraries/aws-architecture-icons/
+  aws-architecture-icons.excalidrawlib  (original)
+  reference.md                          (generated - icon lookup table)
+  icons/                                (generated - individual icon files)
+    API-Gateway.json
+    CloudFront.json
+    EC2.json
+    Lambda.json
+    RDS.json
+    S3.json
+    ...
+```
+
+### AI Assistant Workflow
+
+**When icon libraries are available in `libraries/`:**
+
+**RECOMMENDED APPROACH: Use Python Scripts (Efficient & Reliable)**
+
+The repository includes Python scripts that handle icon integration automatically:
+
+1. **Create base diagram structure**:
+   - Create `.excalidraw` file with basic layout (title, boxes, regions)
+   - This establishes the canvas and overall structure
+
+2. **Add icons using Python script**:
+   ```bash
+   python skills/excalidraw-diagram-generator/scripts/add-icon-to-diagram.py \
+     <diagram-path> <icon-name> <x> <y> [--label "Text"] [--library-path PATH]
+   ```
+   - Edit via `.excalidraw.edit` is enabled by default to avoid overwrite issues; pass `--no-use-edit-suffix` to disable.
+   
+   **Examples**:
+   ```bash
+   # Add EC2 icon at position (400, 300) with label
+   python scripts/add-icon-to-diagram.py diagram.excalidraw EC2 400 300 --label "Web Server"
+   
+   # Add VPC icon at position (200, 150)
+   python scripts/add-icon-to-diagram.py diagram.excalidraw VPC 200 150
+   
+   # Add icon from different library
+   python scripts/add-icon-to-diagram.py diagram.excalidraw Compute-Engine 500 200 \
+     --library-path libraries/gcp-icons --label "API Server"
+   ```
+
+3. **Add connecting arrows**:
+   ```bash
+   python skills/excalidraw-diagram-generator/scripts/add-arrow.py \
+     <diagram-path> <from-x> <from-y> <to-x> <to-y> [--label "Text"] [--style solid|dashed|dotted] [--color HEX]
+   ```
+   - Edit via `.excalidraw.edit` is enabled by default to avoid overwrite issues; pass `--no-use-edit-suffix` to disable.
+   
+   **Examples**:
+   ```bash
+   # Simple arrow from (300, 250) to (500, 300)
+   python scripts/add-arrow.py diagram.excalidraw 300 250 500 300
+   
+   # Arrow with label
+   python scripts/add-arrow.py diagram.excalidraw 300 250 500 300 --label "HTTPS"
+   
+   # Dashed arrow with custom color
+   python scripts/add-arrow.py diagram.excalidraw 400 350 600 400 --style dashed --color "#7950f2"
+   ```
+
+4. **Workflow summary**:
+   ```bash
+   # Step 1: Create base diagram with title and structure
+   # (Create .excalidraw file with initial elements)
+   
+   # Step 2: Add icons with labels
+   python scripts/add-icon-to-diagram.py my-diagram.excalidraw "Internet-gateway" 200 150 --label "Internet Gateway"
+   python scripts/add-icon-to-diagram.py my-diagram.excalidraw VPC 250 250
+   python scripts/add-icon-to-diagram.py my-diagram.excalidraw ELB 350 300 --label "Load Balancer"
+   python scripts/add-icon-to-diagram.py my-diagram.excalidraw EC2 450 350 --label "EC2 Instance"
+   python scripts/add-icon-to-diagram.py my-diagram.excalidraw RDS 550 400 --label "Database"
+   
+   # Step 3: Add connecting arrows
+   python scripts/add-arrow.py my-diagram.excalidraw 250 200 300 250  # Internet → VPC
+   python scripts/add-arrow.py my-diagram.excalidraw 300 300 400 300  # VPC → ELB
+   python scripts/add-arrow.py my-diagram.excalidraw 400 330 500 350  # ELB → EC2
+   python scripts/add-arrow.py my-diagram.excalidraw 500 380 600 400  # EC2 → RDS
+   ```
+
+**Benefits of Python Script Approach**:
+- ✅ **No token consumption**: Icon JSON data (200-1000 lines each) never enters AI context
+- ✅ **Accurate transformations**: Coordinate calculations handled deterministically
+- ✅ **ID management**: Automatic UUID generation prevents conflicts
+- ✅ **Reliable**: No risk of coordinate miscalculation or ID collision
+- ✅ **Fast**: Direct file manipulation, no parsing overhead
+- ✅ **Reusable**: Works with any Excalidraw library you provide
+
+**ALTERNATIVE: Manual Icon Integration (Not Recommended)**
+
+Only use this if Python scripts are unavailable:
+
+1. **Check for libraries**: 
+   ```
+   List directory: skills/excalidraw-diagram-generator/libraries/
+   Look for subdirectories containing reference.md files
+   ```
+
+2. **Read reference.md**:
+   ```
+   Open: libraries/<library-name>/reference.md
+   This is lightweight (typically <300 lines) and lists all available icons
+   ```
+
+3. **Find relevant icons**:
+   ```
+   Search the reference.md table for icon names matching diagram needs
+   Example: For AWS diagram with EC2, S3, Lambda → Find "EC2", "S3", "Lambda" in table
+   ```
+
+4. **Load specific icon data** (WARNING: Large files):
+   ```
+   Read ONLY the needed icon files:
+   - libraries/aws-architecture-icons/icons/EC2.json (200-300 lines)
+   - libraries/aws-architecture-icons/icons/S3.json (200-300 lines)
+   - libraries/aws-architecture-icons/icons/Lambda.json (200-300 lines)
+   Note: Each icon file is 200-1000 lines - this consumes significant tokens
+   ```
+
+5. **Extract and transform elements**:
+   ```
+   Each icon JSON contains an "elements" array
+   Calculate bounding box (min_x, min_y, max_x, max_y)
+   Apply offset to all x/y coordinates
+   Generate new unique IDs for all elements
+   Update groupIds references
+   Copy transformed elements into your diagram
+   ```
+
+6. **Position icons and add connections**:
+   ```
+   Adjust x/y coordinates to position icons correctly in the diagram
+   Update IDs to ensure uniqueness across diagram
+   Add connecting arrows and labels as needed
+   ```
+
+**Manual Integration Challenges**:
+- ⚠️ High token consumption (200-1000 lines per icon × number of icons)
+- ⚠️ Complex coordinate transformation calculations
+- ⚠️ Risk of ID collision if not handled carefully
+- ⚠️ Time-consuming for diagrams with many icons
+
+### Example: Creating AWS Diagram with Icons
+
+**Request**: "Create an AWS architecture diagram with Internet Gateway, VPC, ELB, EC2, and RDS"
+
+**Recommended Workflow (using Python scripts)**:
+**Request**: "Create an AWS architecture diagram with Internet Gateway, VPC, ELB, EC2, and RDS"
+
+**Recommended Workflow (using Python scripts)**:
+
+```bash
+# Step 1: Create base diagram file with title
+# Create my-aws-diagram.excalidraw with basic structure (title, etc.)
+
+# Step 2: Check icon availability
+# Read: libraries/aws-architecture-icons/reference.md
+# Confirm icons exist: Internet-gateway, VPC, ELB, EC2, RDS
+
+# Step 3: Add icons with Python script
+python scripts/add-icon-to-diagram.py my-aws-diagram.excalidraw "Internet-gateway" 150 100 --label "Internet Gateway"
+python scripts/add-icon-to-diagram.py my-aws-diagram.excalidraw VPC 200 200
+python scripts/add-icon-to-diagram.py my-aws-diagram.excalidraw ELB 350 250 --label "Load Balancer"
+python scripts/add-icon-to-diagram.py my-aws-diagram.excalidraw EC2 500 300 --label "Web Server"
+python scripts/add-icon-to-diagram.py my-aws-diagram.excalidraw RDS 650 350 --label "Database"
+
+# Step 4: Add connecting arrows
+python scripts/add-arrow.py my-aws-diagram.excalidraw 200 150 250 200  # Internet → VPC
+python scripts/add-arrow.py my-aws-diagram.excalidraw 265 230 350 250  # VPC → ELB
+python scripts/add-arrow.py my-aws-diagram.excalidraw 415 280 500 300  # ELB → EC2
+python scripts/add-arrow.py my-aws-diagram.excalidraw 565 330 650 350 --label "SQL" --style dashed
+
+# Result: Complete diagram with professional AWS icons, labels, and connections
+```
+
+**Benefits**:
+- No manual coordinate calculation
+- No token consumption for icon data
+- Deterministic, reliable results
+- Easy to iterate and adjust positions
+
+**Alternative Workflow (manual, if scripts unavailable)**:
+1. Check: `libraries/aws-architecture-icons/reference.md` exists → Yes
+2. Read reference.md → Find entries for Internet-gateway, VPC, ELB, EC2, RDS
+3. Load:
+   - `icons/Internet-gateway.json` (298 lines)
+   - `icons/VPC.json` (550 lines)
+   - `icons/ELB.json` (363 lines)
+   - `icons/EC2.json` (231 lines) 
+   - `icons/RDS.json` (similar size)
+   **Total: ~2000+ lines of JSON to process**
+4. Extract elements from each JSON
+5. Calculate bounding boxes and offsets for each icon
+6. Transform all coordinates (x, y) for positioning
+7. Generate unique IDs for all elements
+8. Add arrows showing data flow
+9. Add text labels
+10. Generate final `.excalidraw` file
+
+**Challenges with manual approach**:
+- High token consumption (~2000-5000 lines)
+- Complex coordinate math
+- Risk of ID conflicts
+
+### Supported Icon Libraries (Examples — verify availability)
+
+- This workflow works with any valid `.excalidrawlib` file you provide.
+- Examples of library categories you may find on https://libraries.excalidraw.com/:
+   - Cloud service icons
+   - Kubernetes / infrastructure icons
+   - UI / Material icons
+   - Flowchart / diagram symbols
+   - Network diagram icons
+- Availability and naming can change; verify exact library names on the site before use.
+
+### Fallback: No Icons Available
+
+**If no icon libraries are set up:**
+- Create diagrams using basic shapes (rectangles, ellipses, arrows)
+- Use color coding and text labels to distinguish components
+- Inform user they can add icons later or set up libraries for future diagrams
+- The diagram will still be functional and clear, just less visually polished
+
+## References
+
+See bundled references for:
+- `references/excalidraw-schema.md` - Complete Excalidraw JSON schema
+- `references/element-types.md` - Detailed element type specifications
+- `templates/flowchart-template.json` - Basic flowchart starter
+- `templates/relationship-template.json` - Relationship diagram starter
+- `templates/mindmap-template.json` - Mind map starter
+- `scripts/split-excalidraw-library.py` - Tool to split `.excalidrawlib` files
+- `scripts/README.md` - Documentation for library tools
+
+## Limitations
+
+- Complex curves are simplified to straight/basic curved lines
+- Hand-drawn roughness is set to default (1)
+- No embedded images support in auto-generation
+- Maximum recommended elements: 20 per diagram
+- No automatic collision detection (use spacing guidelines)
+
+## Future Enhancements
+
+Potential improvements:
+- Auto-layout optimization algorithms
+- Import from Mermaid/PlantUML syntax
+- Template library expansion
+- Interactive editing after generation
diff --git a/skills/excalidraw-diagram-generator/libraries/.gitkeep b/skills/excalidraw-diagram-generator/libraries/.gitkeep
new file mode 100644
index 00000000..e69de29b
diff --git a/skills/excalidraw-diagram-generator/references/element-types.md b/skills/excalidraw-diagram-generator/references/element-types.md
new file mode 100644
index 00000000..3d85f8b2
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/references/element-types.md
@@ -0,0 +1,497 @@
+# Excalidraw Element Types Guide
+
+Detailed specifications for each Excalidraw element type with visual examples and use cases.
+
+## Element Type Overview
+
+| Type | Visual | Primary Use | Text Support |
+|------|--------|-------------|--------------|
+| `rectangle` | □ | Boxes, containers, process steps | ✅ Yes |
+| `ellipse` | ○ | Emphasis, terminals, states | ✅ Yes |
+| `diamond` | ◇ | Decision points, choices | ✅ Yes |
+| `arrow` | → | Directional flow, relationships | ❌ No (use separate text) |
+| `line` | — | Connections, dividers | ❌ No |
+| `text` | A | Labels, annotations, titles | ✅ (Its purpose) |
+
+---
+
+## Rectangle
+
+**Best for:** Process steps, entities, data stores, components
+
+### Properties
+
+```typescript
+{
+  type: "rectangle",
+  roundness: { type: 3 },  // Rounded corners
+  text: "Step Name",       // Optional embedded text
+  fontSize: 20,
+  textAlign: "center",
+  verticalAlign: "middle"
+}
+```
+
+### Use Cases
+
+| Scenario | Configuration |
+|----------|---------------|
+| **Process step** | Green background (`#b2f2bb`), centered text |
+| **Entity/Object** | Blue background (`#a5d8ff`), medium size |
+| **System component** | Light color, descriptive text |
+| **Data store** | Gray/white, database-like label |
+
+### Size Guidelines
+
+| Content | Width | Height |
+|---------|-------|--------|
+| Single word | 120-150px | 60-80px |
+| Short phrase (2-4 words) | 180-220px | 80-100px |
+| Sentence | 250-300px | 100-120px |
+
+### Example
+
+```json
+{
+  "type": "rectangle",
+  "x": 100,
+  "y": 100,
+  "width": 200,
+  "height": 80,
+  "backgroundColor": "#b2f2bb",
+  "text": "Validate Input",
+  "fontSize": 20,
+  "textAlign": "center",
+  "verticalAlign": "middle",
+  "roundness": { "type": 3 }
+}
+```
+
+---
+
+## Ellipse
+
+**Best for:** Start/end points, states, emphasis circles
+
+### Properties
+
+```typescript
+{
+  type: "ellipse",
+  text: "Start",
+  fontSize: 18,
+  textAlign: "center",
+  verticalAlign: "middle"
+}
+```
+
+### Use Cases
+
+| Scenario | Configuration |
+|----------|---------------|
+| **Flow start** | Light green, "Start" text |
+| **Flow end** | Light red, "End" text |
+| **State** | Soft color, state name |
+| **Highlight** | Bright color, emphasis text |
+
+### Size Guidelines
+
+For circular shapes, use `width === height`:
+
+| Content | Diameter |
+|---------|----------|
+| Icon/Symbol | 60-80px |
+| Short text | 100-120px |
+| Longer text | 150-180px |
+
+### Example
+
+```json
+{
+  "type": "ellipse",
+  "x": 100,
+  "y": 100,
+  "width": 120,
+  "height": 120,
+  "backgroundColor": "#d0f0c0",
+  "text": "Start",
+  "fontSize": 18,
+  "textAlign": "center",
+  "verticalAlign": "middle"
+}
+```
+
+---
+
+## Diamond
+
+**Best for:** Decision points, conditional branches
+
+### Properties
+
+```typescript
+{
+  type: "diamond",
+  text: "Valid?",
+  fontSize: 18,
+  textAlign: "center",
+  verticalAlign": "middle"
+}
+```
+
+### Use Cases
+
+| Scenario | Text Example |
+|----------|--------------|
+| **Yes/No decision** | "Is Valid?", "Exists?" |
+| **Multiple choice** | "Type?", "Status?" |
+| **Conditional** | "Score > 50?" |
+
+### Size Guidelines
+
+Diamonds need more space than rectangles for the same text:
+
+| Content | Width | Height |
+|---------|-------|--------|
+| Yes/No | 120-140px | 120-140px |
+| Short question | 160-180px | 160-180px |
+| Longer question | 200-220px | 200-220px |
+
+### Example
+
+```json
+{
+  "type": "diamond",
+  "x": 100,
+  "y": 100,
+  "width": 150,
+  "height": 150,
+  "backgroundColor": "#ffe4a3",
+  "text": "Valid?",
+  "fontSize": 18,
+  "textAlign": "center",
+  "verticalAlign": "middle"
+}
+```
+
+---
+
+## Arrow
+
+**Best for:** Flow direction, relationships, dependencies
+
+### Properties
+
+```typescript
+{
+  type: "arrow",
+  points: [[0, 0], [endX, endY]],  // Relative coordinates
+  roundness: { type: 2 },          // Curved
+  startBinding: null,              // Or { elementId, focus, gap }
+  endBinding: null
+}
+```
+
+### Arrow Directions
+
+#### Horizontal (Left to Right)
+
+```json
+{
+  "x": 100,
+  "y": 150,
+  "width": 200,
+  "height": 0,
+  "points": [[0, 0], [200, 0]]
+}
+```
+
+#### Vertical (Top to Bottom)
+
+```json
+{
+  "x": 200,
+  "y": 100,
+  "width": 0,
+  "height": 150,
+  "points": [[0, 0], [0, 150]]
+}
+```
+
+#### Diagonal
+
+```json
+{
+  "x": 100,
+  "y": 100,
+  "width": 200,
+  "height": 150,
+  "points": [[0, 0], [200, 150]]
+}
+```
+
+### Arrow Styles
+
+| Style | `strokeStyle` | `strokeWidth` | Use Case |
+|-------|---------------|---------------|----------|
+| **Normal flow** | `"solid"` | 2 | Standard connections |
+| **Optional/Weak** | `"dashed"` | 2 | Optional paths |
+| **Important** | `"solid"` | 3-4 | Emphasized flow |
+| **Dotted** | `"dotted"` | 2 | Indirect relationships |
+
+### Adding Arrow Labels
+
+Use separate text elements positioned near arrow midpoint:
+
+```json
+[
+  {
+    "type": "arrow",
+    "id": "arrow1",
+    "x": 100,
+    "y": 150,
+    "points": [[0, 0], [200, 0]]
+  },
+  {
+    "type": "text",
+    "x": 180,      // Near midpoint
+    "y": 130,      // Above arrow
+    "text": "sends",
+    "fontSize": 14
+  }
+]
+```
+
+---
+
+## Line
+
+**Best for:** Non-directional connections, dividers, borders
+
+### Properties
+
+```typescript
+{
+  type: "line",
+  points: [[0, 0], [x2, y2], [x3, y3], ...],
+  roundness: null  // Or { type: 2 } for curved
+}
+```
+
+### Use Cases
+
+| Scenario | Configuration |
+|----------|---------------|
+| **Divider** | Horizontal, thin stroke |
+| **Border** | Closed path (polygon) |
+| **Connection** | Multi-point path |
+| **Underline** | Short horizontal line |
+
+### Multi-Point Line Example
+
+```json
+{
+  "type": "line",
+  "x": 100,
+  "y": 100,
+  "points": [
+    [0, 0],
+    [100, 50],
+    [200, 0]
+  ]
+}
+```
+
+---
+
+## Text
+
+**Best for:** Labels, titles, annotations, standalone text
+
+### Properties
+
+```typescript
+{
+  type: "text",
+  text: "Label text",
+  fontSize: 20,
+  fontFamily: 1,        // 1=Virgil, 2=Helvetica, 3=Cascadia
+  textAlign: "left",
+  verticalAlign: "top"
+}
+```
+
+### Font Sizes by Purpose
+
+| Purpose | Font Size |
+|---------|-----------|
+| **Main title** | 28-36 |
+| **Section header** | 24-28 |
+| **Element label** | 18-22 |
+| **Annotation** | 14-16 |
+| **Small note** | 12-14 |
+
+### Width/Height Calculation
+
+```javascript
+// Approximate width
+const width = text.length * fontSize * 0.6;
+
+// Approximate height (single line)
+const height = fontSize * 1.2;
+
+// Multi-line
+const lines = text.split('\n').length;
+const height = fontSize * 1.2 * lines;
+```
+
+### Text Positioning
+
+| Position | textAlign | verticalAlign | Use Case |
+|----------|-----------|---------------|----------|
+| **Top-left** | `"left"` | `"top"` | Default labels |
+| **Centered** | `"center"` | `"middle"` | Titles |
+| **Bottom-right** | `"right"` | `"bottom"` | Footnotes |
+
+### Example: Title
+
+```json
+{
+  "type": "text",
+  "x": 100,
+  "y": 50,
+  "width": 400,
+  "height": 40,
+  "text": "System Architecture",
+  "fontSize": 32,
+  "fontFamily": 2,
+  "textAlign": "center",
+  "verticalAlign": "top"
+}
+```
+
+### Example: Annotation
+
+```json
+{
+  "type": "text",
+  "x": 150,
+  "y": 200,
+  "width": 100,
+  "height": 20,
+  "text": "User input",
+  "fontSize": 14,
+  "fontFamily": 1,
+  "textAlign": "left",
+  "verticalAlign": "top"
+}
+```
+
+---
+
+## Combining Elements
+
+### Pattern: Labeled Box
+
+```json
+[
+  {
+    "type": "rectangle",
+    "id": "box1",
+    "x": 100,
+    "y": 100,
+    "width": 200,
+    "height": 100,
+    "text": "Component",
+    "textAlign": "center",
+    "verticalAlign": "middle"
+  }
+]
+```
+
+### Pattern: Connected Boxes
+
+```json
+[
+  {
+    "type": "rectangle",
+    "id": "box1",
+    "x": 100,
+    "y": 100,
+    "width": 150,
+    "height": 80,
+    "text": "Step 1"
+  },
+  {
+    "type": "arrow",
+    "id": "arrow1",
+    "x": 250,
+    "y": 140,
+    "points": [[0, 0], [100, 0]]
+  },
+  {
+    "type": "rectangle",
+    "id": "box2",
+    "x": 350,
+    "y": 100,
+    "width": 150,
+    "height": 80,
+    "text": "Step 2"
+  }
+]
+```
+
+### Pattern: Decision Tree
+
+```json
+[
+  {
+    "type": "diamond",
+    "id": "decision",
+    "x": 100,
+    "y": 100,
+    "width": 140,
+    "height": 140,
+    "text": "Valid?"
+  },
+  {
+    "type": "arrow",
+    "id": "yes-arrow",
+    "x": 240,
+    "y": 170,
+    "points": [[0, 0], [60, 0]]
+  },
+  {
+    "type": "text",
+    "id": "yes-label",
+    "x": 250,
+    "y": 150,
+    "text": "Yes",
+    "fontSize": 14
+  },
+  {
+    "type": "rectangle",
+    "id": "yes-box",
+    "x": 300,
+    "y": 140,
+    "width": 120,
+    "height": 60,
+    "text": "Process"
+  }
+]
+```
+
+---
+
+## Summary
+
+| When you need... | Use this element |
+|------------------|------------------|
+| Process box | `rectangle` with text |
+| Decision point | `diamond` with question |
+| Flow direction | `arrow` |
+| Start/End | `ellipse` |
+| Title/Header | `text` (large font) |
+| Annotation | `text` (small font) |
+| Non-directional link | `line` |
+| Divider | `line` (horizontal) |
diff --git a/skills/excalidraw-diagram-generator/references/excalidraw-schema.md b/skills/excalidraw-diagram-generator/references/excalidraw-schema.md
new file mode 100644
index 00000000..bfdac6cf
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/references/excalidraw-schema.md
@@ -0,0 +1,350 @@
+# Excalidraw JSON Schema Reference
+
+This document describes the structure of Excalidraw `.excalidraw` files for diagram generation.
+
+## Top-Level Structure
+
+```typescript
+interface ExcalidrawFile {
+  type: "excalidraw";
+  version: number;           // Always 2
+  source: string;            // "https://excalidraw.com"
+  elements: ExcalidrawElement[];
+  appState: AppState;
+  files: Record<string, any>; // Usually empty {}
+}
+```
+
+## AppState
+
+```typescript
+interface AppState {
+  viewBackgroundColor: string; // Hex color, e.g., "#ffffff"
+  gridSize: number;            // Typically 20
+}
+```
+
+## ExcalidrawElement Base Properties
+
+All elements share these common properties:
+
+```typescript
+interface BaseElement {
+  id: string;                  // Unique identifier
+  type: ElementType;           // See Element Types below
+  x: number;                   // X coordinate (pixels from top-left)
+  y: number;                   // Y coordinate (pixels from top-left)
+  width: number;               // Width in pixels
+  height: number;              // Height in pixels
+  angle: number;               // Rotation angle in radians (usually 0)
+  strokeColor: string;         // Hex color, e.g., "#1e1e1e"
+  backgroundColor: string;     // Hex color or "transparent"
+  fillStyle: "solid" | "hachure" | "cross-hatch";
+  strokeWidth: number;         // 1-4 typically
+  strokeStyle: "solid" | "dashed" | "dotted";
+  roughness: number;           // 0-2, controls hand-drawn effect (1 = default)
+  opacity: number;             // 0-100
+  groupIds: string[];          // IDs of groups this element belongs to
+  frameId: null;               // Usually null
+  index: string;               // Stacking order identifier
+  roundness: Roundness | null;
+  seed: number;                // Random seed for deterministic rendering
+  version: number;             // Element version (increment on edit)
+  versionNonce: number;        // Random number changed on edit
+  isDeleted: boolean;          // Should be false
+  boundElements: any;          // Usually null
+  updated: number;             // Timestamp in milliseconds
+  link: null;                  // External link (usually null)
+  locked: boolean;             // Whether element is locked
+}
+```
+
+## Element Types
+
+### Rectangle
+
+```typescript
+interface RectangleElement extends BaseElement {
+  type: "rectangle";
+  roundness: { type: 3 };      // 3 = rounded corners
+  text?: string;               // Optional text inside
+  fontSize?: number;           // Font size (16-32 typical)
+  fontFamily?: number;         // 1 = Virgil, 2 = Helvetica, 3 = Cascadia
+  textAlign?: "left" | "center" | "right";
+  verticalAlign?: "top" | "middle" | "bottom";
+}
+```
+
+**Example:**
+```json
+{
+  "id": "rect1",
+  "type": "rectangle",
+  "x": 100,
+  "y": 100,
+  "width": 200,
+  "height": 100,
+  "strokeColor": "#1e1e1e",
+  "backgroundColor": "#a5d8ff",
+  "text": "My Box",
+  "fontSize": 20,
+  "textAlign": "center",
+  "verticalAlign": "middle",
+  "roundness": { "type": 3 }
+}
+```
+
+### Ellipse
+
+```typescript
+interface EllipseElement extends BaseElement {
+  type: "ellipse";
+  text?: string;
+  fontSize?: number;
+  fontFamily?: number;
+  textAlign?: "left" | "center" | "right";
+  verticalAlign?: "top" | "middle" | "bottom";
+}
+```
+
+### Diamond
+
+```typescript
+interface DiamondElement extends BaseElement {
+  type: "diamond";
+  text?: string;
+  fontSize?: number;
+  fontFamily?: number;
+  textAlign?: "left" | "center" | "right";
+  verticalAlign?: "top" | "middle" | "bottom";
+}
+```
+
+### Arrow
+
+```typescript
+interface ArrowElement extends BaseElement {
+  type: "arrow";
+  points: [number, number][];  // Array of [x, y] coordinates relative to element
+  startBinding: Binding | null;
+  endBinding: Binding | null;
+  roundness: { type: 2 };      // 2 = curved arrow
+}
+```
+
+**Example:**
+```json
+{
+  "id": "arrow1",
+  "type": "arrow",
+  "x": 100,
+  "y": 100,
+  "width": 200,
+  "height": 0,
+  "points": [
+    [0, 0],
+    [200, 0]
+  ],
+  "roundness": { "type": 2 },
+  "startBinding": null,
+  "endBinding": null
+}
+```
+
+**Points explanation:**
+- First point `[0, 0]` is relative to `(x, y)`
+- Subsequent points are relative to the first point
+- For straight horizontal arrow: `[[0, 0], [width, 0]]`
+- For straight vertical arrow: `[[0, 0], [0, height]]`
+
+### Line
+
+```typescript
+interface LineElement extends BaseElement {
+  type: "line";
+  points: [number, number][];
+  startBinding: Binding | null;
+  endBinding: Binding | null;
+  roundness: { type: 2 } | null;
+}
+```
+
+### Text
+
+```typescript
+interface TextElement extends BaseElement {
+  type: "text";
+  text: string;
+  fontSize: number;
+  fontFamily: number;          // 1-3
+  textAlign: "left" | "center" | "right";
+  verticalAlign: "top" | "middle" | "bottom";
+  roundness: null;             // Text has no roundness
+}
+```
+
+**Example:**
+```json
+{
+  "id": "text1",
+  "type": "text",
+  "x": 100,
+  "y": 100,
+  "width": 150,
+  "height": 25,
+  "text": "Hello World",
+  "fontSize": 20,
+  "fontFamily": 1,
+  "textAlign": "left",
+  "verticalAlign": "top",
+  "roundness": null
+}
+```
+
+**Width/Height calculation:**
+- Width ≈ `text.length * fontSize * 0.6`
+- Height ≈ `fontSize * 1.2 * numberOfLines`
+
+## Bindings
+
+Bindings connect arrows to shapes:
+
+```typescript
+interface Binding {
+  elementId: string;           // ID of bound element
+  focus: number;               // -1 to 1, position along edge
+  gap: number;                 // Distance from element edge
+}
+```
+
+## Common Colors
+
+| Color Name | Hex Code | Use Case |
+|------------|----------|----------|
+| Black | `#1e1e1e` | Default stroke |
+| Light Blue | `#a5d8ff` | Primary entities |
+| Light Green | `#b2f2bb` | Process steps |
+| Yellow | `#ffd43b` | Important/Central |
+| Light Red | `#ffc9c9` | Warnings/Errors |
+| Cyan | `#96f2d7` | Secondary items |
+| Transparent | `transparent` | No fill |
+| White | `#ffffff` | Background |
+
+## ID Generation
+
+IDs should be unique strings. Common patterns:
+
+```javascript
+// Timestamp-based
+const id = Date.now().toString(36) + Math.random().toString(36).substr(2);
+
+// Sequential
+const id = "element-" + counter++;
+
+// Descriptive
+const id = "step-1", "entity-user", "arrow-1-to-2";
+```
+
+## Seed Generation
+
+Seeds are used for deterministic randomness in hand-drawn effect:
+
+```javascript
+const seed = Math.floor(Math.random() * 2147483647);
+```
+
+## Version and VersionNonce
+
+```javascript
+const version = 1;  // Increment when element is edited
+const versionNonce = Math.floor(Math.random() * 2147483647);
+```
+
+## Coordinate System
+
+- Origin `(0, 0)` is top-left corner
+- X increases to the right
+- Y increases downward
+- All units are in pixels
+
+## Recommended Spacing
+
+| Context | Spacing |
+|---------|---------|
+| Horizontal gap between elements | 200-300px |
+| Vertical gap between rows | 100-150px |
+| Minimum margin from edge | 50px |
+| Arrow-to-box clearance | 20-30px |
+
+## Font Families
+
+| ID | Name | Description |
+|----|------|-------------|
+| 1 | Virgil | Hand-drawn style (default) |
+| 2 | Helvetica | Clean sans-serif |
+| 3 | Cascadia | Monospace |
+
+## Validation Rules
+
+✅ **Required:**
+- All IDs must be unique
+- `type` must match actual element type
+- `version` must be an integer ≥ 1
+- `opacity` must be 0-100
+
+⚠️ **Recommended:**
+- Keep `roughness` at 1 for consistency
+- Use `strokeWidth` of 2 for clarity
+- Set `isDeleted` to `false`
+- Set `locked` to `false`
+- Keep `frameId`, `boundElements`, `link` as `null`
+
+## Complete Minimal Example
+
+```json
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://excalidraw.com",
+  "elements": [
+    {
+      "id": "box1",
+      "type": "rectangle",
+      "x": 100,
+      "y": 100,
+      "width": 200,
+      "height": 100,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#a5d8ff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": { "type": 3 },
+      "seed": 1234567890,
+      "version": 1,
+      "versionNonce": 987654321,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Hello",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    }
+  ],
+  "appState": {
+    "viewBackgroundColor": "#ffffff",
+    "gridSize": 20
+  },
+  "files": {}
+}
+```
diff --git a/skills/excalidraw-diagram-generator/scripts/README.md b/skills/excalidraw-diagram-generator/scripts/README.md
new file mode 100644
index 00000000..df810f1a
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/scripts/README.md
@@ -0,0 +1,193 @@
+# Excalidraw Library Tools
+
+This directory contains scripts for working with Excalidraw libraries.
+
+## split-excalidraw-library.py
+
+Splits an Excalidraw library file (`*.excalidrawlib`) into individual icon JSON files for efficient token usage by AI assistants.
+
+### Prerequisites
+
+- Python 3.6 or higher
+- No additional dependencies required (uses only standard library)
+
+### Usage
+
+```bash
+python split-excalidraw-library.py <path-to-library-directory>
+```
+
+### Step-by-Step Workflow
+
+1. **Create library directory**:
+   ```bash
+   mkdir -p skills/excalidraw-diagram-generator/libraries/aws-architecture-icons
+   ```
+
+2. **Download and place library file**:
+   - Visit: https://libraries.excalidraw.com/
+   - Search for "AWS Architecture Icons" and download the `.excalidrawlib` file
+   - Rename it to match the directory name: `aws-architecture-icons.excalidrawlib`
+   - Place it in the directory created in step 1
+
+3. **Run the script**:
+   ```bash
+   python skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py skills/excalidraw-diagram-generator/libraries/aws-architecture-icons/
+   ```
+
+### Output Structure
+
+The script creates the following structure in the library directory:
+
+```
+skills/excalidraw-diagram-generator/libraries/aws-architecture-icons/
+  aws-architecture-icons.excalidrawlib  # Original file (kept)
+  reference.md                          # Generated: Quick reference table
+  icons/                                # Generated: Individual icon files
+    API-Gateway.json
+    CloudFront.json
+    EC2.json
+    S3.json
+    ...
+```
+
+### What the Script Does
+
+1. **Reads** the `.excalidrawlib` file
+2. **Extracts** each icon from the `libraryItems` array
+3. **Sanitizes** icon names to create valid filenames (spaces → hyphens, removes special characters)
+4. **Saves** each icon as a separate JSON file in the `icons/` directory
+5. **Generates** a `reference.md` file with a table mapping icon names to filenames
+
+### Benefits
+
+- **Token Efficiency**: AI can first read the lightweight `reference.md` to find relevant icons, then load only the specific icon files needed
+- **Organization**: Icons are organized in a clear directory structure
+- **Extensibility**: Users can add multiple library sets side-by-side
+
+### Recommended Workflow
+
+1. Download desired Excalidraw libraries from https://libraries.excalidraw.com/
+2. Run this script on each library file
+3. Move the generated folders to `../libraries/`
+4. The AI assistant will use `reference.md` files to locate and use icons efficiently
+
+### Library Sources (Examples — verify availability)
+
+- Examples found on https://libraries.excalidraw.com/ may include cloud/service icon sets.
+- Availability changes over time; verify the exact library names on the site before use.
+- This script works with any valid `.excalidrawlib` file you provide.
+
+### Troubleshooting
+
+**Error: File not found**
+- Check that the file path is correct
+- Make sure the file has a `.excalidrawlib` extension
+
+**Error: Invalid library file format**
+- Ensure the file is a valid Excalidraw library file
+- Check that it contains a `libraryItems` array
+
+### License Considerations
+
+When using third-party icon libraries:
+- **AWS Architecture Icons**: Subject to AWS Content License
+- **GCP Icons**: Subject to Google's terms
+- **Other libraries**: Check each library's license
+
+This script is for personal/organizational use. Redistribution of split icon files should comply with the original library's license terms.
+
+## add-icon-to-diagram.py
+
+Adds a specific icon from a split Excalidraw library into an existing `.excalidraw` diagram. The script handles coordinate translation and ID collision avoidance, and can optionally add a label under the icon.
+
+### Prerequisites
+
+- Python 3.6 or higher
+- A diagram file (`.excalidraw`)
+- A split icon library directory (created by `split-excalidraw-library.py`)
+
+### Usage
+
+```bash
+python add-icon-to-diagram.py <diagram-path> <icon-name> <x> <y> [OPTIONS]
+```
+
+**Options**
+- `--library-path PATH` : Path to the icon library directory (default: `aws-architecture-icons`)
+- `--label TEXT` : Add a text label below the icon
+-- `--use-edit-suffix` : Edit via `.excalidraw.edit` to avoid editor overwrite issues (enabled by default; pass `--no-use-edit-suffix` to disable)
+
+### Examples
+
+```bash
+# Add EC2 icon at position (400, 300)
+python add-icon-to-diagram.py diagram.excalidraw EC2 400 300
+
+# Add VPC icon with label
+python add-icon-to-diagram.py diagram.excalidraw VPC 200 150 --label "VPC"
+
+# Safe edit mode is enabled by default (avoids editor overwrite issues)
+# Use `--no-use-edit-suffix` to disable
+python add-icon-to-diagram.py diagram.excalidraw EC2 500 300
+
+# Add icon from another library
+python add-icon-to-diagram.py diagram.excalidraw Compute-Engine 500 200 \
+   --library-path libraries/gcp-icons --label "API Server"
+```
+
+### What the Script Does
+
+1. **Loads** the icon JSON from the library’s `icons/` directory
+2. **Calculates** the icon’s bounding box
+3. **Offsets** all coordinates to the target position
+4. **Generates** unique IDs for all elements and groups
+5. **Appends** the transformed elements to the diagram
+6. **(Optional)** Adds a label beneath the icon
+
+---
+
+## add-arrow.py
+
+Adds a straight arrow between two points in an existing `.excalidraw` diagram. Supports optional labels and line styles.
+
+### Prerequisites
+
+- Python 3.6 or higher
+- A diagram file (`.excalidraw`)
+
+### Usage
+
+```bash
+python add-arrow.py <diagram-path> <from-x> <from-y> <to-x> <to-y> [OPTIONS]
+```
+
+**Options**
+- `--style {solid|dashed|dotted}` : Line style (default: `solid`)
+- `--color HEX` : Arrow color (default: `#1e1e1e`)
+- `--label TEXT` : Add a text label on the arrow
+-- `--use-edit-suffix` : Edit via `.excalidraw.edit` to avoid editor overwrite issues (enabled by default; pass `--no-use-edit-suffix` to disable)
+
+### Examples
+
+```bash
+# Simple arrow
+python add-arrow.py diagram.excalidraw 300 200 500 300
+
+# Arrow with label
+python add-arrow.py diagram.excalidraw 300 200 500 300 --label "HTTPS"
+
+# Dashed arrow with custom color
+python add-arrow.py diagram.excalidraw 400 350 600 400 --style dashed --color "#7950f2"
+
+# Safe edit mode is enabled by default (avoids editor overwrite issues)
+# Use `--no-use-edit-suffix` to disable
+python add-arrow.py diagram.excalidraw 300 200 500 300
+```
+
+### What the Script Does
+
+1. **Creates** an arrow element from the given coordinates
+2. **(Optional)** Adds a label near the arrow midpoint
+3. **Appends** elements to the diagram
+4. **Saves** the updated file
diff --git a/skills/excalidraw-diagram-generator/scripts/add-arrow.py b/skills/excalidraw-diagram-generator/scripts/add-arrow.py
new file mode 100644
index 00000000..169f09ff
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/scripts/add-arrow.py
@@ -0,0 +1,312 @@
+#!/usr/bin/env python3
+"""
+Add arrows (connections) between elements in Excalidraw diagrams.
+
+Usage:
+    python add-arrow.py <diagram_path> <from_x> <from_y> <to_x> <to_y> [OPTIONS]
+
+Options:
+    --style {solid|dashed|dotted}    Arrow line style (default: solid)
+    --color HEX                      Arrow color (default: #1e1e1e)
+    --label TEXT                     Add text label on the arrow
+    --use-edit-suffix                Edit via .excalidraw.edit to avoid editor overwrite issues (enabled by default; use --no-use-edit-suffix to disable)
+
+Examples:
+    python add-arrow.py diagram.excalidraw 300 200 500 300
+    python add-arrow.py diagram.excalidraw 300 200 500 300 --label "HTTP"
+    python add-arrow.py diagram.excalidraw 300 200 500 300 --style dashed --color "#7950f2"
+    python add-arrow.py diagram.excalidraw 300 200 500 300 --use-edit-suffix
+"""
+
+import json
+import sys
+import uuid
+from pathlib import Path
+from typing import Dict, Any
+
+
+def generate_unique_id() -> str:
+    """Generate a unique ID for Excalidraw elements."""
+    return str(uuid.uuid4()).replace('-', '')[:16]
+
+
+def prepare_edit_path(diagram_path: Path, use_edit_suffix: bool) -> tuple[Path, Path | None]:
+    """
+    Prepare a safe edit path to avoid editor overwrite issues.
+
+    Returns:
+        (work_path, final_path)
+        - work_path: file path to read/write during edit
+        - final_path: file path to rename back to (or None if not used)
+    """
+    if not use_edit_suffix:
+        return diagram_path, None
+
+    if diagram_path.suffix != ".excalidraw":
+        return diagram_path, None
+
+    edit_path = diagram_path.with_suffix(diagram_path.suffix + ".edit")
+
+    if diagram_path.exists():
+        if edit_path.exists():
+            raise FileExistsError(f"Edit file already exists: {edit_path}")
+        diagram_path.rename(edit_path)
+
+    return edit_path, diagram_path
+
+
+def finalize_edit_path(work_path: Path, final_path: Path | None) -> None:
+    """Finalize edit by renaming .edit back to .excalidraw if needed."""
+    if final_path is None:
+        return
+
+    if final_path.exists():
+        final_path.unlink()
+
+    work_path.rename(final_path)
+
+
+def create_arrow(
+    from_x: float,
+    from_y: float,
+    to_x: float,
+    to_y: float,
+    style: str = "solid",
+    color: str = "#1e1e1e",
+    label: str = None
+) -> list:
+    """
+    Create an arrow element.
+    
+    Args:
+        from_x: Starting X coordinate
+        from_y: Starting Y coordinate
+        to_x: Ending X coordinate
+        to_y: Ending Y coordinate
+        style: Line style (solid, dashed, dotted)
+        color: Arrow color
+        label: Optional text label on the arrow
+    
+    Returns:
+        List of elements (arrow and optional label)
+    """
+    elements = []
+    
+    # Arrow element
+    arrow = {
+        "id": generate_unique_id(),
+        "type": "arrow",
+        "x": from_x,
+        "y": from_y,
+        "width": to_x - from_x,
+        "height": to_y - from_y,
+        "angle": 0,
+        "strokeColor": color,
+        "backgroundColor": "transparent",
+        "fillStyle": "solid",
+        "strokeWidth": 2,
+        "strokeStyle": style,
+        "roughness": 1,
+        "opacity": 100,
+        "groupIds": [],
+        "frameId": None,
+        "index": "a0",
+        "roundness": {
+            "type": 2
+        },
+        "seed": 1000000000 + hash(f"{from_x}{from_y}{to_x}{to_y}") % 1000000000,
+        "version": 1,
+        "versionNonce": 2000000000 + hash(f"{from_x}{from_y}{to_x}{to_y}") % 1000000000,
+        "isDeleted": False,
+        "boundElements": [],
+        "updated": 1738195200000,
+        "link": None,
+        "locked": False,
+        "points": [
+            [0, 0],
+            [to_x - from_x, to_y - from_y]
+        ],
+        "startBinding": None,
+        "endBinding": None,
+        "startArrowhead": None,
+        "endArrowhead": "arrow",
+        "lastCommittedPoint": None
+    }
+    elements.append(arrow)
+    
+    # Optional label
+    if label:
+        mid_x = (from_x + to_x) / 2 - (len(label) * 5)
+        mid_y = (from_y + to_y) / 2 - 10
+        
+        label_element = {
+            "id": generate_unique_id(),
+            "type": "text",
+            "x": mid_x,
+            "y": mid_y,
+            "width": len(label) * 10,
+            "height": 20,
+            "angle": 0,
+            "strokeColor": color,
+            "backgroundColor": "transparent",
+            "fillStyle": "solid",
+            "strokeWidth": 2,
+            "strokeStyle": "solid",
+            "roughness": 1,
+            "opacity": 100,
+            "groupIds": [],
+            "frameId": None,
+            "index": "a0",
+            "roundness": None,
+            "seed": 1000000000 + hash(label) % 1000000000,
+            "version": 1,
+            "versionNonce": 2000000000 + hash(label) % 1000000000,
+            "isDeleted": False,
+            "boundElements": [],
+            "updated": 1738195200000,
+            "link": None,
+            "locked": False,
+            "text": label,
+            "fontSize": 14,
+            "fontFamily": 5,
+            "textAlign": "center",
+            "verticalAlign": "top",
+            "containerId": None,
+            "originalText": label,
+            "autoResize": True,
+            "lineHeight": 1.25
+        }
+        elements.append(label_element)
+    
+    return elements
+
+
+def add_arrow_to_diagram(
+    diagram_path: Path,
+    from_x: float,
+    from_y: float,
+    to_x: float,
+    to_y: float,
+    style: str = "solid",
+    color: str = "#1e1e1e",
+    label: str = None
+) -> None:
+    """
+    Add an arrow to an Excalidraw diagram.
+    
+    Args:
+        diagram_path: Path to the Excalidraw diagram file
+        from_x: Starting X coordinate
+        from_y: Starting Y coordinate
+        to_x: Ending X coordinate
+        to_y: Ending Y coordinate
+        style: Line style (solid, dashed, dotted)
+        color: Arrow color
+        label: Optional text label
+    """
+    print(f"Creating arrow from ({from_x}, {from_y}) to ({to_x}, {to_y})")
+    arrow_elements = create_arrow(from_x, from_y, to_x, to_y, style, color, label)
+    
+    if label:
+        print(f"  With label: '{label}'")
+    
+    # Load diagram
+    print(f"Loading diagram: {diagram_path}")
+    with open(diagram_path, 'r', encoding='utf-8') as f:
+        diagram = json.load(f)
+    
+    # Add arrow elements
+    if 'elements' not in diagram:
+        diagram['elements'] = []
+    
+    original_count = len(diagram['elements'])
+    diagram['elements'].extend(arrow_elements)
+    print(f"  Added {len(arrow_elements)} elements (total: {original_count} -> {len(diagram['elements'])})")
+    
+    # Save diagram
+    print(f"Saving diagram")
+    with open(diagram_path, 'w', encoding='utf-8') as f:
+        json.dump(diagram, f, indent=2, ensure_ascii=False)
+    
+    print(f"✓ Successfully added arrow to diagram")
+
+
+def main():
+    """Main entry point."""
+    if len(sys.argv) < 6:
+        print("Usage: python add-arrow.py <diagram_path> <from_x> <from_y> <to_x> <to_y> [OPTIONS]")
+        print("\nOptions:")
+        print("  --style {solid|dashed|dotted}    Line style (default: solid)")
+        print("  --color HEX                      Color (default: #1e1e1e)")
+        print("  --label TEXT                     Text label on arrow")
+        print("  --use-edit-suffix                Edit via .excalidraw.edit to avoid editor overwrite issues (enabled by default; use --no-use-edit-suffix to disable)")
+        print("\nExamples:")
+        print("  python add-arrow.py diagram.excalidraw 300 200 500 300")
+        print("  python add-arrow.py diagram.excalidraw 300 200 500 300 --label 'HTTP'")
+        sys.exit(1)
+    
+    diagram_path = Path(sys.argv[1])
+    from_x = float(sys.argv[2])
+    from_y = float(sys.argv[3])
+    to_x = float(sys.argv[4])
+    to_y = float(sys.argv[5])
+    
+    # Parse optional arguments
+    style = "solid"
+    color = "#1e1e1e"
+    label = None
+    # Default: use edit suffix to avoid editor overwrite issues
+    use_edit_suffix = True
+    
+    i = 6
+    while i < len(sys.argv):
+        if sys.argv[i] == '--style':
+            if i + 1 < len(sys.argv):
+                style = sys.argv[i + 1]
+                if style not in ['solid', 'dashed', 'dotted']:
+                    print(f"Error: Invalid style '{style}'. Must be: solid, dashed, or dotted")
+                    sys.exit(1)
+                i += 2
+            else:
+                print("Error: --style requires an argument")
+                sys.exit(1)
+        elif sys.argv[i] == '--color':
+            if i + 1 < len(sys.argv):
+                color = sys.argv[i + 1]
+                i += 2
+            else:
+                print("Error: --color requires an argument")
+                sys.exit(1)
+        elif sys.argv[i] == '--label':
+            if i + 1 < len(sys.argv):
+                label = sys.argv[i + 1]
+                i += 2
+            else:
+                print("Error: --label requires a text argument")
+                sys.exit(1)
+        elif sys.argv[i] == '--use-edit-suffix':
+            use_edit_suffix = True
+            i += 1
+        elif sys.argv[i] == '--no-use-edit-suffix':
+            use_edit_suffix = False
+            i += 1
+        else:
+            print(f"Error: Unknown option: {sys.argv[i]}")
+            sys.exit(1)
+    
+    # Validate inputs
+    if not diagram_path.exists():
+        print(f"Error: Diagram file not found: {diagram_path}")
+        sys.exit(1)
+    
+    try:
+        work_path, final_path = prepare_edit_path(diagram_path, use_edit_suffix)
+        add_arrow_to_diagram(work_path, from_x, from_y, to_x, to_y, style, color, label)
+        finalize_edit_path(work_path, final_path)
+    except Exception as e:
+        print(f"Error: {e}")
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/skills/excalidraw-diagram-generator/scripts/add-icon-to-diagram.py b/skills/excalidraw-diagram-generator/scripts/add-icon-to-diagram.py
new file mode 100644
index 00000000..f1035254
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/scripts/add-icon-to-diagram.py
@@ -0,0 +1,404 @@
+#!/usr/bin/env python3
+"""
+Add icons from Excalidraw libraries to diagrams.
+
+This script reads an icon JSON file from an Excalidraw library, transforms its coordinates
+to a target position, generates unique IDs, and adds it to an existing Excalidraw diagram.
+Works with any Excalidraw library (AWS, GCP, Azure, Kubernetes, etc.).
+
+Usage:
+    python add-icon-to-diagram.py <diagram_path> <icon_name> <x> <y> [OPTIONS]
+
+Options:
+    --library-path PATH    Path to the icon library directory (default: aws-architecture-icons)
+    --label TEXT           Add a text label below the icon
+    --use-edit-suffix      Edit via .excalidraw.edit to avoid editor overwrite issues (enabled by default; use --no-use-edit-suffix to disable)
+
+Examples:
+    python add-icon-to-diagram.py diagram.excalidraw EC2 500 300
+    python add-icon-to-diagram.py diagram.excalidraw EC2 500 300 --label "Web Server"
+    python add-icon-to-diagram.py diagram.excalidraw VPC 200 150 --library-path libraries/gcp-icons
+    python add-icon-to-diagram.py diagram.excalidraw EC2 500 300 --use-edit-suffix
+"""
+
+import json
+import sys
+import uuid
+from pathlib import Path
+from typing import Dict, List, Any, Tuple
+
+
+def generate_unique_id() -> str:
+    """Generate a unique ID for Excalidraw elements."""
+    return str(uuid.uuid4()).replace('-', '')[:16]
+
+
+def calculate_bounding_box(elements: List[Dict[str, Any]]) -> Tuple[float, float, float, float]:
+    """Calculate the bounding box (min_x, min_y, max_x, max_y) of icon elements."""
+    if not elements:
+        return (0, 0, 0, 0)
+    
+    min_x = float('inf')
+    min_y = float('inf')
+    max_x = float('-inf')
+    max_y = float('-inf')
+    
+    for element in elements:
+        if 'x' in element and 'y' in element:
+            x = element['x']
+            y = element['y']
+            width = element.get('width', 0)
+            height = element.get('height', 0)
+            
+            min_x = min(min_x, x)
+            min_y = min(min_y, y)
+            max_x = max(max_x, x + width)
+            max_y = max(max_y, y + height)
+    
+    return (min_x, min_y, max_x, max_y)
+
+
+def transform_icon_elements(
+    elements: List[Dict[str, Any]], 
+    target_x: float, 
+    target_y: float
+) -> List[Dict[str, Any]]:
+    """
+    Transform icon elements to target coordinates with unique IDs.
+    
+    Args:
+        elements: Icon elements from JSON file
+        target_x: Target X coordinate (top-left position)
+        target_y: Target Y coordinate (top-left position)
+    
+    Returns:
+        Transformed elements with new coordinates and IDs
+    """
+    if not elements:
+        return []
+    
+    # Calculate bounding box
+    min_x, min_y, max_x, max_y = calculate_bounding_box(elements)
+    
+    # Calculate offset
+    offset_x = target_x - min_x
+    offset_y = target_y - min_y
+    
+    # Create ID mapping: old_id -> new_id
+    id_mapping = {}
+    for element in elements:
+        if 'id' in element:
+            old_id = element['id']
+            id_mapping[old_id] = generate_unique_id()
+    
+    # Create group ID mapping
+    group_id_mapping = {}
+    for element in elements:
+        if 'groupIds' in element:
+            for old_group_id in element['groupIds']:
+                if old_group_id not in group_id_mapping:
+                    group_id_mapping[old_group_id] = generate_unique_id()
+    
+    # Transform elements
+    transformed = []
+    for element in elements:
+        new_element = element.copy()
+        
+        # Update coordinates
+        if 'x' in new_element:
+            new_element['x'] = new_element['x'] + offset_x
+        if 'y' in new_element:
+            new_element['y'] = new_element['y'] + offset_y
+        
+        # Update ID
+        if 'id' in new_element:
+            new_element['id'] = id_mapping[new_element['id']]
+        
+        # Update group IDs
+        if 'groupIds' in new_element:
+            new_element['groupIds'] = [
+                group_id_mapping[gid] for gid in new_element['groupIds']
+            ]
+        
+        # Update binding references if they exist
+        if 'startBinding' in new_element and new_element['startBinding']:
+            if 'elementId' in new_element['startBinding']:
+                old_id = new_element['startBinding']['elementId']
+                if old_id in id_mapping:
+                    new_element['startBinding']['elementId'] = id_mapping[old_id]
+        
+        if 'endBinding' in new_element and new_element['endBinding']:
+            if 'elementId' in new_element['endBinding']:
+                old_id = new_element['endBinding']['elementId']
+                if old_id in id_mapping:
+                    new_element['endBinding']['elementId'] = id_mapping[old_id]
+        
+        # Update containerId if it exists
+        if 'containerId' in new_element and new_element['containerId']:
+            old_id = new_element['containerId']
+            if old_id in id_mapping:
+                new_element['containerId'] = id_mapping[old_id]
+        
+        # Update boundElements if they exist
+        if 'boundElements' in new_element and new_element['boundElements']:
+            new_bound_elements = []
+            for bound_elem in new_element['boundElements']:
+                if isinstance(bound_elem, dict) and 'id' in bound_elem:
+                    old_id = bound_elem['id']
+                    if old_id in id_mapping:
+                        bound_elem['id'] = id_mapping[old_id]
+                new_bound_elements.append(bound_elem)
+            new_element['boundElements'] = new_bound_elements
+        
+        transformed.append(new_element)
+    
+    return transformed
+
+
+def load_icon(icon_name: str, library_path: Path) -> List[Dict[str, Any]]:
+    """
+    Load icon elements from library.
+    
+    Args:
+        icon_name: Name of the icon (e.g., "EC2", "VPC")
+        library_path: Path to the icon library directory
+    
+    Returns:
+        List of icon elements
+    """
+    icon_file = library_path / "icons" / f"{icon_name}.json"
+    
+    if not icon_file.exists():
+        raise FileNotFoundError(f"Icon file not found: {icon_file}")
+    
+    with open(icon_file, 'r', encoding='utf-8') as f:
+        icon_data = json.load(f)
+    
+    return icon_data.get('elements', [])
+
+
+def prepare_edit_path(diagram_path: Path, use_edit_suffix: bool) -> tuple[Path, Path | None]:
+    """
+    Prepare a safe edit path to avoid editor overwrite issues.
+
+    Returns:
+        (work_path, final_path)
+        - work_path: file path to read/write during edit
+        - final_path: file path to rename back to (or None if not used)
+    """
+    if not use_edit_suffix:
+        return diagram_path, None
+
+    if diagram_path.suffix != ".excalidraw":
+        return diagram_path, None
+
+    edit_path = diagram_path.with_suffix(diagram_path.suffix + ".edit")
+
+    if diagram_path.exists():
+        if edit_path.exists():
+            raise FileExistsError(f"Edit file already exists: {edit_path}")
+        diagram_path.rename(edit_path)
+
+    return edit_path, diagram_path
+
+
+def finalize_edit_path(work_path: Path, final_path: Path | None) -> None:
+    """Finalize edit by renaming .edit back to .excalidraw if needed."""
+    if final_path is None:
+        return
+
+    if final_path.exists():
+        final_path.unlink()
+
+    work_path.rename(final_path)
+
+
+def create_text_label(text: str, x: float, y: float) -> Dict[str, Any]:
+    """
+    Create a text label element.
+    
+    Args:
+        text: Label text
+        x: X coordinate
+        y: Y coordinate
+    
+    Returns:
+        Text element dictionary
+    """
+    return {
+        "id": generate_unique_id(),
+        "type": "text",
+        "x": x,
+        "y": y,
+        "width": len(text) * 10,  # Approximate width
+        "height": 20,
+        "angle": 0,
+        "strokeColor": "#1e1e1e",
+        "backgroundColor": "transparent",
+        "fillStyle": "solid",
+        "strokeWidth": 2,
+        "strokeStyle": "solid",
+        "roughness": 1,
+        "opacity": 100,
+        "groupIds": [],
+        "frameId": None,
+        "index": "a0",
+        "roundness": None,
+        "seed": 1000000000 + hash(text) % 1000000000,
+        "version": 1,
+        "versionNonce": 2000000000 + hash(text) % 1000000000,
+        "isDeleted": False,
+        "boundElements": [],
+        "updated": 1738195200000,
+        "link": None,
+        "locked": False,
+        "text": text,
+        "fontSize": 16,
+        "fontFamily": 5,  # Excalifont
+        "textAlign": "center",
+        "verticalAlign": "top",
+        "containerId": None,
+        "originalText": text,
+        "autoResize": True,
+        "lineHeight": 1.25
+    }
+
+
+def add_icon_to_diagram(
+    diagram_path: Path,
+    icon_name: str,
+    x: float,
+    y: float,
+    library_path: Path,
+    label: str = None
+) -> None:
+    """
+    Add an icon to an Excalidraw diagram.
+    
+    Args:
+        diagram_path: Path to the Excalidraw diagram file
+        icon_name: Name of the icon to add
+        x: Target X coordinate
+        y: Target Y coordinate
+        library_path: Path to the icon library directory
+        label: Optional text label to add below the icon
+    """
+    # Load icon elements
+    print(f"Loading icon: {icon_name}")
+    icon_elements = load_icon(icon_name, library_path)
+    print(f"  Loaded {len(icon_elements)} elements")
+    
+    # Transform icon elements
+    print(f"Transforming to position ({x}, {y})")
+    transformed_elements = transform_icon_elements(icon_elements, x, y)
+    
+    # Calculate icon bounding box for label positioning
+    if label and transformed_elements:
+        min_x, min_y, max_x, max_y = calculate_bounding_box(transformed_elements)
+        icon_width = max_x - min_x
+        icon_height = max_y - min_y
+        
+        # Position label below icon, centered
+        label_x = min_x + (icon_width / 2) - (len(label) * 5)
+        label_y = max_y + 10
+        
+        label_element = create_text_label(label, label_x, label_y)
+        transformed_elements.append(label_element)
+        print(f"  Added label: '{label}'")
+    
+    # Load diagram
+    print(f"Loading diagram: {diagram_path}")
+    with open(diagram_path, 'r', encoding='utf-8') as f:
+        diagram = json.load(f)
+    
+    # Add transformed elements
+    if 'elements' not in diagram:
+        diagram['elements'] = []
+    
+    original_count = len(diagram['elements'])
+    diagram['elements'].extend(transformed_elements)
+    print(f"  Added {len(transformed_elements)} elements (total: {original_count} -> {len(diagram['elements'])})")
+    
+    # Save diagram
+    print(f"Saving diagram")
+    with open(diagram_path, 'w', encoding='utf-8') as f:
+        json.dump(diagram, f, indent=2, ensure_ascii=False)
+    
+    print(f"✓ Successfully added '{icon_name}' icon to diagram")
+
+
+def main():
+    """Main entry point."""
+    if len(sys.argv) < 5:
+        print("Usage: python add-icon-to-diagram.py <diagram_path> <icon_name> <x> <y> [OPTIONS]")
+        print("\nOptions:")
+        print("  --library-path PATH    Path to icon library directory")
+        print("  --label TEXT           Add text label below icon")
+        print("  --use-edit-suffix      Edit via .excalidraw.edit to avoid editor overwrite issues (enabled by default; use --no-use-edit-suffix to disable)")
+        print("\nExamples:")
+        print("  python add-icon-to-diagram.py diagram.excalidraw EC2 500 300")
+        print("  python add-icon-to-diagram.py diagram.excalidraw EC2 500 300 --label 'Web Server'")
+        sys.exit(1)
+    
+    diagram_path = Path(sys.argv[1])
+    icon_name = sys.argv[2]
+    x = float(sys.argv[3])
+    y = float(sys.argv[4])
+    
+    # Default library path
+    script_dir = Path(__file__).parent
+    default_library_path = script_dir.parent / "libraries" / "aws-architecture-icons"
+    
+    # Parse optional arguments
+    library_path = default_library_path
+    label = None
+    # Default: use edit suffix to avoid editor overwrite issues
+    use_edit_suffix = True
+    
+    i = 5
+    while i < len(sys.argv):
+        if sys.argv[i] == '--library-path':
+            if i + 1 < len(sys.argv):
+                library_path = Path(sys.argv[i + 1])
+                i += 2
+            else:
+                print("Error: --library-path requires a path argument")
+                sys.exit(1)
+        elif sys.argv[i] == '--label':
+            if i + 1 < len(sys.argv):
+                label = sys.argv[i + 1]
+                i += 2
+            else:
+                print("Error: --label requires a text argument")
+                sys.exit(1)
+        elif sys.argv[i] == '--use-edit-suffix':
+            use_edit_suffix = True
+            i += 1
+        elif sys.argv[i] == '--no-use-edit-suffix':
+            use_edit_suffix = False
+            i += 1
+        else:
+            print(f"Error: Unknown option: {sys.argv[i]}")
+            sys.exit(1)
+    
+    # Validate inputs
+    if not diagram_path.exists():
+        print(f"Error: Diagram file not found: {diagram_path}")
+        sys.exit(1)
+    
+    if not library_path.exists():
+        print(f"Error: Library path not found: {library_path}")
+        sys.exit(1)
+    
+    try:
+        work_path, final_path = prepare_edit_path(diagram_path, use_edit_suffix)
+        add_icon_to_diagram(work_path, icon_name, x, y, library_path, label)
+        finalize_edit_path(work_path, final_path)
+    except Exception as e:
+        print(f"Error: {e}")
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()
+
diff --git a/skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py b/skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py
new file mode 100644
index 00000000..97a5e141
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py
@@ -0,0 +1,183 @@
+#!/usr/bin/env python3
+"""
+Excalidraw Library Splitter
+
+This script splits an Excalidraw library file (*.excalidrawlib) into individual
+icon JSON files and generates a reference.md file for easy lookup.
+
+The script expects the following structure:
+  skills/excalidraw-diagram-generator/libraries/{icon-set-name}/
+    {icon-set-name}.excalidrawlib  (place this file first)
+
+Usage:
+    python split-excalidraw-library.py <path-to-library-directory>
+
+Example:
+    python split-excalidraw-library.py skills/excalidraw-diagram-generator/libraries/aws-architecture-icons/
+"""
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+
+def sanitize_filename(name: str) -> str:
+    """
+    Sanitize icon name to create a valid filename.
+    
+    Args:
+        name: Original icon name
+        
+    Returns:
+        Sanitized filename safe for all platforms
+    """
+    # Replace spaces with hyphens
+    filename = name.replace(' ', '-')
+    
+    # Remove or replace special characters
+    filename = re.sub(r'[^\w\-.]', '', filename)
+    
+    # Remove multiple consecutive hyphens
+    filename = re.sub(r'-+', '-', filename)
+    
+    # Remove leading/trailing hyphens
+    filename = filename.strip('-')
+    
+    return filename
+
+
+def find_library_file(directory: Path) -> Path:
+    """
+    Find the .excalidrawlib file in the given directory.
+    
+    Args:
+        directory: Directory to search
+        
+    Returns:
+        Path to the library file
+        
+    Raises:
+        SystemExit: If no library file or multiple library files found
+    """
+    library_files = list(directory.glob('*.excalidrawlib'))
+    
+    if len(library_files) == 0:
+        print(f"Error: No .excalidrawlib file found in {directory}")
+        print(f"Please place a .excalidrawlib file in this directory first.")
+        sys.exit(1)
+    
+    if len(library_files) > 1:
+        print(f"Error: Multiple .excalidrawlib files found in {directory}")
+        print(f"Please keep only one library file in the directory.")
+        sys.exit(1)
+    
+    return library_files[0]
+
+
+def split_library(library_dir: str) -> None:
+    """
+    Split an Excalidraw library file into individual icon files.
+    
+    Args:
+        library_dir: Path to the directory containing the .excalidrawlib file
+    """
+    library_dir = Path(library_dir)
+    
+    if not library_dir.exists():
+        print(f"Error: Directory not found: {library_dir}")
+        sys.exit(1)
+    
+    if not library_dir.is_dir():
+        print(f"Error: Path is not a directory: {library_dir}")
+        sys.exit(1)
+    
+    # Find the library file
+    library_path = find_library_file(library_dir)
+    print(f"Found library: {library_path.name}")
+    
+    # Load library file
+    print(f"Loading library data...")
+    with open(library_path, 'r', encoding='utf-8') as f:
+        library_data = json.load(f)
+    
+    # Validate library structure
+    if 'libraryItems' not in library_data:
+        print("Error: Invalid library file format (missing 'libraryItems')")
+        sys.exit(1)
+    
+    # Create icons directory
+    icons_dir = library_dir / 'icons'
+    icons_dir.mkdir(exist_ok=True)
+    print(f"Output directory: {library_dir}")
+    
+    # Process each library item (icon)
+    library_items = library_data['libraryItems']
+    icon_list = []
+    
+    print(f"Processing {len(library_items)} icons...")
+    
+    for item in library_items:
+        # Get icon name
+        icon_name = item.get('name', 'Unnamed')
+        
+        # Create sanitized filename
+        filename = sanitize_filename(icon_name) + '.json'
+        
+        # Save icon data
+        icon_path = icons_dir / filename
+        with open(icon_path, 'w', encoding='utf-8') as f:
+            json.dump(item, f, ensure_ascii=False, indent=2)
+        
+        # Add to reference list
+        icon_list.append({
+            'name': icon_name,
+            'filename': filename
+        })
+        
+        print(f"  ✓ {icon_name} → {filename}")
+    
+    # Sort icon list by name
+    icon_list.sort(key=lambda x: x['name'])
+    
+    # Generate reference.md
+    library_name = library_path.stem
+    reference_path = library_dir / 'reference.md'
+    with open(reference_path, 'w', encoding='utf-8') as f:
+        f.write(f"# {library_name} Reference\n\n")
+        f.write(f"This directory contains {len(icon_list)} icons extracted from `{library_path.name}`.\n\n")
+        f.write("## Available Icons\n\n")
+        f.write("| Icon Name | Filename |\n")
+        f.write("|-----------|----------|\n")
+        
+        for icon in icon_list:
+            f.write(f"| {icon['name']} | `icons/{icon['filename']}` |\n")
+        
+        f.write("\n## Usage\n\n")
+        f.write("Each icon JSON file contains the complete `elements` array needed to render that icon in Excalidraw.\n")
+        f.write("You can copy the elements from these files into your Excalidraw diagrams.\n")
+    
+    print(f"\n✅ Successfully split library into {len(icon_list)} icons")
+    print(f"📄 Reference file created: {reference_path}")
+    print(f"📁 Icons directory: {icons_dir}")
+
+
+def main():
+    """Main entry point."""
+    if hasattr(sys.stdout, "reconfigure"):
+        # Ensure consistent UTF-8 output on Windows consoles.
+        sys.stdout.reconfigure(encoding="utf-8")
+    if len(sys.argv) != 2:
+        print("Usage: python split-excalidraw-library.py <path-to-library-directory>")
+        print("\nExample:")
+        print("  python split-excalidraw-library.py skills/excalidraw-diagram-generator/libraries/aws-architecture-icons/")
+        print("\nNote: The directory should contain a .excalidrawlib file.")
+        sys.exit(1)
+    
+    library_dir = sys.argv[1]
+    split_library(library_dir)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/skills/excalidraw-diagram-generator/templates/business-flow-swimlane-template.excalidraw b/skills/excalidraw-diagram-generator/templates/business-flow-swimlane-template.excalidraw
new file mode 100644
index 00000000..0d0c26b8
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/templates/business-flow-swimlane-template.excalidraw
@@ -0,0 +1,334 @@
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://excalidraw.com",
+  "elements": [
+    {
+      "id": "title",
+      "type": "text",
+      "x": 200,
+      "y": 50,
+      "width": 300,
+      "height": 30,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": null,
+      "seed": 2001001001,
+      "version": 1,
+      "versionNonce": 3002002001,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Business Process Flow",
+      "fontSize": 24,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "lane-header-1",
+      "type": "rectangle",
+      "x": 100,
+      "y": 120,
+      "width": 200,
+      "height": 50,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#e7f5ff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a1",
+      "roundness": null,
+      "seed": 2001001002,
+      "version": 1,
+      "versionNonce": 3002002002,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Customer",
+      "fontSize": 18,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "lane-1",
+      "type": "rectangle",
+      "x": 100,
+      "y": 170,
+      "width": 200,
+      "height": 250,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a2",
+      "roundness": null,
+      "seed": 2001001003,
+      "version": 1,
+      "versionNonce": 3002002003,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false
+    },
+    {
+      "id": "process-1",
+      "type": "rectangle",
+      "x": 130,
+      "y": 200,
+      "width": 140,
+      "height": 70,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#b2f2bb",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a3",
+      "roundness": { "type": 3 },
+      "seed": 2001001004,
+      "version": 1,
+      "versionNonce": 3002002004,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Submit\nRequest",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "lane-header-2",
+      "type": "rectangle",
+      "x": 300,
+      "y": 120,
+      "width": 200,
+      "height": 50,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#fff3bf",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a4",
+      "roundness": null,
+      "seed": 2001001005,
+      "version": 1,
+      "versionNonce": 3002002005,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Sales Team",
+      "fontSize": 18,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "lane-2",
+      "type": "rectangle",
+      "x": 300,
+      "y": 170,
+      "width": 200,
+      "height": 250,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a5",
+      "roundness": null,
+      "seed": 2001001006,
+      "version": 1,
+      "versionNonce": 3002002006,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false
+    },
+    {
+      "id": "process-2",
+      "type": "rectangle",
+      "x": 330,
+      "y": 200,
+      "width": 140,
+      "height": 70,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#ffd43b",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a6",
+      "roundness": { "type": 3 },
+      "seed": 2001001007,
+      "version": 1,
+      "versionNonce": 3002002007,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Review\nRequest",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "cross-lane-arrow",
+      "type": "arrow",
+      "x": 270,
+      "y": 235,
+      "width": 60,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a7",
+      "roundness": { "type": 2 },
+      "seed": 2001001008,
+      "version": 1,
+      "versionNonce": 3002002008,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [60, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "process-3",
+      "type": "rectangle",
+      "x": 330,
+      "y": 310,
+      "width": 140,
+      "height": 70,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#ffd43b",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a8",
+      "roundness": { "type": 3 },
+      "seed": 2001001009,
+      "version": 1,
+      "versionNonce": 3002002009,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Approve",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "within-lane-arrow",
+      "type": "arrow",
+      "x": 400,
+      "y": 270,
+      "width": 0,
+      "height": 40,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a9",
+      "roundness": { "type": 2 },
+      "seed": 2001001010,
+      "version": 1,
+      "versionNonce": 3002002010,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [0, 40]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    }
+  ],
+  "appState": {
+    "viewBackgroundColor": "#ffffff",
+    "gridSize": 20
+  },
+  "files": {}
+}
diff --git a/skills/excalidraw-diagram-generator/templates/class-diagram-template.excalidraw b/skills/excalidraw-diagram-generator/templates/class-diagram-template.excalidraw
new file mode 100644
index 00000000..aae28dfb
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/templates/class-diagram-template.excalidraw
@@ -0,0 +1,558 @@
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://marketplace.visualstudio.com/items?itemName=pomdtr.excalidraw-editor",
+  "elements": [
+    {
+      "id": "class-1",
+      "type": "rectangle",
+      "x": 100,
+      "y": 100,
+      "width": 200,
+      "height": 180,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#e7f5ff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": null,
+      "seed": 3001001001,
+      "version": 1,
+      "versionNonce": 4002002001,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false
+    },
+    {
+      "id": "class-name-1",
+      "type": "text",
+      "x": 150,
+      "y": 110,
+      "width": 100,
+      "height": 25,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a1",
+      "roundness": null,
+      "seed": 3001001002,
+      "version": 1,
+      "versionNonce": 4002002002,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "User",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "top",
+      "containerId": null,
+      "originalText": "User",
+      "autoResize": true,
+      "lineHeight": 1.25
+    },
+    {
+      "id": "separator-1",
+      "type": "line",
+      "x": 100,
+      "y": 145,
+      "width": 200,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a2",
+      "roundness": null,
+      "seed": 3001001003,
+      "version": 1,
+      "versionNonce": 4002002003,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          200,
+          0
+        ]
+      ],
+      "startBinding": null,
+      "endBinding": null,
+      "lastCommittedPoint": null,
+      "startArrowhead": null,
+      "endArrowhead": null
+    },
+    {
+      "id": "attributes-1",
+      "type": "text",
+      "x": 110,
+      "y": 155,
+      "width": 180,
+      "height": 50,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a3",
+      "roundness": null,
+      "seed": 3001001004,
+      "version": 1,
+      "versionNonce": 4002002004,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "- id: number\n- name: string\n- email: string",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top",
+      "containerId": null,
+      "originalText": "- id: number\n- name: string\n- email: string",
+      "autoResize": true,
+      "lineHeight": 1.1904761904761905
+    },
+    {
+      "id": "separator-2",
+      "type": "line",
+      "x": 100,
+      "y": 215,
+      "width": 200,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a4",
+      "roundness": null,
+      "seed": 3001001005,
+      "version": 1,
+      "versionNonce": 4002002005,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          200,
+          0
+        ]
+      ],
+      "startBinding": null,
+      "endBinding": null,
+      "lastCommittedPoint": null,
+      "startArrowhead": null,
+      "endArrowhead": null
+    },
+    {
+      "id": "methods-1",
+      "type": "text",
+      "x": 110,
+      "y": 225,
+      "width": 180,
+      "height": 45,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a5",
+      "roundness": null,
+      "seed": 3001001006,
+      "version": 3,
+      "versionNonce": 1660402375,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1769755991910,
+      "link": null,
+      "locked": false,
+      "text": "+ login(): void\n+ logout(): void\n+ updateProfile(): void",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top",
+      "containerId": null,
+      "originalText": "+ login(): void\n+ logout(): void\n+ updateProfile(): void",
+      "autoResize": true,
+      "lineHeight": 1.0714285714285714
+    },
+    {
+      "id": "class-2",
+      "type": "rectangle",
+      "x": 400,
+      "y": 100,
+      "width": 200,
+      "height": 180,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#fff3bf",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a6",
+      "roundness": null,
+      "seed": 3001001007,
+      "version": 1,
+      "versionNonce": 4002002007,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false
+    },
+    {
+      "id": "class-name-2",
+      "type": "text",
+      "x": 430,
+      "y": 110,
+      "width": 140,
+      "height": 25,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a7",
+      "roundness": null,
+      "seed": 3001001008,
+      "version": 1,
+      "versionNonce": 4002002008,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "AdminUser",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "top",
+      "containerId": null,
+      "originalText": "AdminUser",
+      "autoResize": true,
+      "lineHeight": 1.25
+    },
+    {
+      "id": "separator-3",
+      "type": "line",
+      "x": 400,
+      "y": 145,
+      "width": 200,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a8",
+      "roundness": null,
+      "seed": 3001001009,
+      "version": 1,
+      "versionNonce": 4002002009,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          200,
+          0
+        ]
+      ],
+      "startBinding": null,
+      "endBinding": null,
+      "lastCommittedPoint": null,
+      "startArrowhead": null,
+      "endArrowhead": null
+    },
+    {
+      "id": "attributes-2",
+      "type": "text",
+      "x": 410,
+      "y": 155,
+      "width": 180,
+      "height": 35,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a9",
+      "roundness": null,
+      "seed": 3001001010,
+      "version": 1,
+      "versionNonce": 4002002010,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "- role: string\n- permissions: string[]",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top",
+      "containerId": null,
+      "originalText": "- role: string\n- permissions: string[]",
+      "autoResize": true,
+      "lineHeight": 1.25
+    },
+    {
+      "id": "separator-4",
+      "type": "line",
+      "x": 400,
+      "y": 200,
+      "width": 200,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "aA",
+      "roundness": null,
+      "seed": 3001001011,
+      "version": 2,
+      "versionNonce": 873024679,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1769755880046,
+      "link": null,
+      "locked": false,
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          200,
+          0
+        ]
+      ],
+      "startBinding": null,
+      "endBinding": null,
+      "lastCommittedPoint": null,
+      "startArrowhead": null,
+      "endArrowhead": null
+    },
+    {
+      "id": "methods-2",
+      "type": "text",
+      "x": 410,
+      "y": 210,
+      "width": 180,
+      "height": 60,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "aB",
+      "roundness": null,
+      "seed": 3001001012,
+      "version": 2,
+      "versionNonce": 1702655305,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1769755880046,
+      "link": null,
+      "locked": false,
+      "text": "+ manageUsers(): void\n+ assignRole(): void\n+ revokePermission(): void",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top",
+      "containerId": null,
+      "originalText": "+ manageUsers(): void\n+ assignRole(): void\n+ revokePermission(): void",
+      "autoResize": true,
+      "lineHeight": 1.4285714285714286
+    },
+    {
+      "id": "inheritance-line",
+      "type": "line",
+      "x": 400,
+      "y": 190,
+      "width": 100,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "aC",
+      "roundness": null,
+      "seed": 3001001013,
+      "version": 18,
+      "versionNonce": 1139021225,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1769755989350,
+      "link": null,
+      "locked": false,
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          -100,
+          0
+        ]
+      ],
+      "startBinding": null,
+      "endBinding": null,
+      "lastCommittedPoint": null,
+      "startArrowhead": null,
+      "endArrowhead": null
+    },
+    {
+      "id": "inheritance-triangle",
+      "type": "line",
+      "x": 314.1999816894531,
+      "y": 181.5,
+      "width": 15,
+      "height": 15,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#ffffff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "aD",
+      "roundness": null,
+      "seed": 3001001014,
+      "version": 21,
+      "versionNonce": 1468657767,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1769756005117,
+      "link": null,
+      "locked": false,
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          -15,
+          15
+        ],
+        [
+          0,
+          15
+        ],
+        [
+          0,
+          0
+        ]
+      ],
+      "startBinding": null,
+      "endBinding": null,
+      "lastCommittedPoint": null,
+      "startArrowhead": null,
+      "endArrowhead": null
+    }
+  ],
+  "appState": {
+    "gridSize": 20,
+    "gridStep": 5,
+    "gridModeEnabled": false,
+    "viewBackgroundColor": "#ffffff"
+  },
+  "files": {}
+}
\ No newline at end of file
diff --git a/skills/excalidraw-diagram-generator/templates/data-flow-diagram-template.excalidraw b/skills/excalidraw-diagram-generator/templates/data-flow-diagram-template.excalidraw
new file mode 100644
index 00000000..baea839e
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/templates/data-flow-diagram-template.excalidraw
@@ -0,0 +1,279 @@
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://excalidraw.com",
+  "elements": [
+    {
+      "id": "external-entity-1",
+      "type": "rectangle",
+      "x": 100,
+      "y": 200,
+      "width": 120,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#ffc9c9",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": { "type": 3 },
+      "seed": 1001001001,
+      "version": 1,
+      "versionNonce": 2002002002,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "User",
+      "fontSize": 18,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "data-flow-1",
+      "type": "arrow",
+      "x": 220,
+      "y": 240,
+      "width": 80,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a1",
+      "roundness": { "type": 2 },
+      "seed": 1001001002,
+      "version": 1,
+      "versionNonce": 2002002003,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [80, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "flow-label-1",
+      "type": "text",
+      "x": 230,
+      "y": 220,
+      "width": 80,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a2",
+      "roundness": null,
+      "seed": 1001001003,
+      "version": 1,
+      "versionNonce": 2002002004,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "input data",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "process-1",
+      "type": "ellipse",
+      "x": 300,
+      "y": 200,
+      "width": 120,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#a5d8ff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a3",
+      "roundness": null,
+      "seed": 1001001004,
+      "version": 1,
+      "versionNonce": 2002002005,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Process\nData",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "data-flow-2",
+      "type": "arrow",
+      "x": 420,
+      "y": 240,
+      "width": 80,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a4",
+      "roundness": { "type": 2 },
+      "seed": 1001001005,
+      "version": 1,
+      "versionNonce": 2002002006,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [80, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "flow-label-2",
+      "type": "text",
+      "x": 425,
+      "y": 220,
+      "width": 100,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a5",
+      "roundness": null,
+      "seed": 1001001006,
+      "version": 1,
+      "versionNonce": 2002002007,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "processed data",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "data-store-1",
+      "type": "rectangle",
+      "x": 500,
+      "y": 200,
+      "width": 150,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#96f2d7",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a6",
+      "roundness": null,
+      "seed": 1001001007,
+      "version": 1,
+      "versionNonce": 2002002008,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Data Store\n(Database)",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "data-store-line",
+      "type": "line",
+      "x": 500,
+      "y": 225,
+      "width": 150,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a7",
+      "roundness": null,
+      "seed": 1001001008,
+      "version": 1,
+      "versionNonce": 2002002009,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [150, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    }
+  ],
+  "appState": {
+    "viewBackgroundColor": "#ffffff",
+    "gridSize": 20
+  },
+  "files": {}
+}
diff --git a/skills/excalidraw-diagram-generator/templates/er-diagram-template.excalidraw b/skills/excalidraw-diagram-generator/templates/er-diagram-template.excalidraw
new file mode 100644
index 00000000..a023522c
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/templates/er-diagram-template.excalidraw
@@ -0,0 +1,662 @@
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://excalidraw.com",
+  "elements": [
+    {
+      "id": "entity-1",
+      "type": "rectangle",
+      "x": 100,
+      "y": 150,
+      "width": 180,
+      "height": 150,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#e7f5ff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": null,
+      "seed": 5001001001,
+      "version": 1,
+      "versionNonce": 6002002001,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false
+    },
+    {
+      "id": "entity-name-1",
+      "type": "text",
+      "x": 150,
+      "y": 160,
+      "width": 80,
+      "height": 25,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a1",
+      "roundness": null,
+      "seed": 5001001002,
+      "version": 1,
+      "versionNonce": 6002002002,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "User",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "entity-separator-1",
+      "type": "line",
+      "x": 100,
+      "y": 195,
+      "width": 180,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a2",
+      "roundness": null,
+      "seed": 5001001003,
+      "version": 1,
+      "versionNonce": 6002002003,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [180, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "attributes-1",
+      "type": "text",
+      "x": 110,
+      "y": 205,
+      "width": 160,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a3",
+      "roundness": null,
+      "seed": 5001001004,
+      "version": 1,
+      "versionNonce": 6002002004,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "PK: user_id\nname\nemail\ncreated_at",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "entity-2",
+      "type": "rectangle",
+      "x": 450,
+      "y": 150,
+      "width": 180,
+      "height": 150,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#fff3bf",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a4",
+      "roundness": null,
+      "seed": 5001001005,
+      "version": 1,
+      "versionNonce": 6002002005,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false
+    },
+    {
+      "id": "entity-name-2",
+      "type": "text",
+      "x": 500,
+      "y": 160,
+      "width": 80,
+      "height": 25,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a5",
+      "roundness": null,
+      "seed": 5001001006,
+      "version": 1,
+      "versionNonce": 6002002006,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Order",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "entity-separator-2",
+      "type": "line",
+      "x": 450,
+      "y": 195,
+      "width": 180,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a6",
+      "roundness": null,
+      "seed": 5001001007,
+      "version": 1,
+      "versionNonce": 6002002007,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [180, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "attributes-2",
+      "type": "text",
+      "x": 460,
+      "y": 205,
+      "width": 160,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a7",
+      "roundness": null,
+      "seed": 5001001008,
+      "version": 1,
+      "versionNonce": 6002002008,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "PK: order_id\nFK: user_id\ntotal_amount\norder_date",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "relationship-line",
+      "type": "line",
+      "x": 280,
+      "y": 225,
+      "width": 170,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a8",
+      "roundness": null,
+      "seed": 5001001009,
+      "version": 1,
+      "versionNonce": 6002002009,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [170, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "cardinality-1",
+      "type": "text",
+      "x": 290,
+      "y": 205,
+      "width": 20,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a9",
+      "roundness": null,
+      "seed": 5001001010,
+      "version": 1,
+      "versionNonce": 6002002010,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "1",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "cardinality-2",
+      "type": "text",
+      "x": 420,
+      "y": 205,
+      "width": 20,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a10",
+      "roundness": null,
+      "seed": 5001001011,
+      "version": 1,
+      "versionNonce": 6002002011,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "N",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "relationship-label",
+      "type": "text",
+      "x": 330,
+      "y": 200,
+      "width": 80,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#ffffff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a11",
+      "roundness": null,
+      "seed": 5001001012,
+      "version": 1,
+      "versionNonce": 6002002012,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "places",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "entity-3",
+      "type": "rectangle",
+      "x": 450,
+      "y": 380,
+      "width": 180,
+      "height": 120,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#d0f0c0",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a12",
+      "roundness": null,
+      "seed": 5001001013,
+      "version": 1,
+      "versionNonce": 6002002013,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false
+    },
+    {
+      "id": "entity-name-3",
+      "type": "text",
+      "x": 480,
+      "y": 390,
+      "width": 120,
+      "height": 25,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a13",
+      "roundness": null,
+      "seed": 5001001014,
+      "version": 1,
+      "versionNonce": 6002002014,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Product",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "entity-separator-3",
+      "type": "line",
+      "x": 450,
+      "y": 425,
+      "width": 180,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a14",
+      "roundness": null,
+      "seed": 5001001015,
+      "version": 1,
+      "versionNonce": 6002002015,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [180, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "attributes-3",
+      "type": "text",
+      "x": 460,
+      "y": 435,
+      "width": 160,
+      "height": 50,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a15",
+      "roundness": null,
+      "seed": 5001001016,
+      "version": 1,
+      "versionNonce": 6002002016,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "PK: product_id\nname\nprice",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "relationship-line-2",
+      "type": "line",
+      "x": 540,
+      "y": 300,
+      "width": 0,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a16",
+      "roundness": null,
+      "seed": 5001001017,
+      "version": 1,
+      "versionNonce": 6002002017,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [0, 80]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "cardinality-3",
+      "type": "text",
+      "x": 550,
+      "y": 310,
+      "width": 20,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a17",
+      "roundness": null,
+      "seed": 5001001018,
+      "version": 1,
+      "versionNonce": 6002002018,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "N",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "cardinality-4",
+      "type": "text",
+      "x": 550,
+      "y": 350,
+      "width": 20,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a18",
+      "roundness": null,
+      "seed": 5001001019,
+      "version": 1,
+      "versionNonce": 6002002019,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "M",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "relationship-label-2",
+      "type": "text",
+      "x": 490,
+      "y": 330,
+      "width": 80,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#ffffff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a19",
+      "roundness": null,
+      "seed": 5001001020,
+      "version": 1,
+      "versionNonce": 6002002020,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "contains",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "top"
+    }
+  ],
+  "appState": {
+    "viewBackgroundColor": "#ffffff",
+    "gridSize": 20
+  },
+  "files": {}
+}
diff --git a/skills/excalidraw-diagram-generator/templates/flowchart-template.excalidraw b/skills/excalidraw-diagram-generator/templates/flowchart-template.excalidraw
new file mode 100644
index 00000000..965a3f9c
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/templates/flowchart-template.excalidraw
@@ -0,0 +1,179 @@
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://excalidraw.com",
+  "elements": [
+    {
+      "id": "step1",
+      "type": "rectangle",
+      "x": 400,
+      "y": 200,
+      "width": 200,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#b2f2bb",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": { "type": 3 },
+      "seed": 1234567890,
+      "version": 1,
+      "versionNonce": 987654321,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Step 1",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "arrow1",
+      "type": "arrow",
+      "x": 500,
+      "y": 280,
+      "width": 0,
+      "height": 100,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a1",
+      "roundness": { "type": 2 },
+      "seed": 1234567891,
+      "version": 1,
+      "versionNonce": 987654322,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [0, 100]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "step2",
+      "type": "rectangle",
+      "x": 400,
+      "y": 380,
+      "width": 200,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#b2f2bb",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a2",
+      "roundness": { "type": 3 },
+      "seed": 1234567892,
+      "version": 1,
+      "versionNonce": 987654323,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Step 2",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "arrow2",
+      "type": "arrow",
+      "x": 500,
+      "y": 460,
+      "width": 0,
+      "height": 100,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a3",
+      "roundness": { "type": 2 },
+      "seed": 1234567893,
+      "version": 1,
+      "versionNonce": 987654324,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [0, 100]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "step3",
+      "type": "rectangle",
+      "x": 400,
+      "y": 560,
+      "width": 200,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#b2f2bb",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a4",
+      "roundness": { "type": 3 },
+      "seed": 1234567894,
+      "version": 1,
+      "versionNonce": 987654325,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Step 3",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    }
+  ],
+  "appState": {
+    "viewBackgroundColor": "#ffffff",
+    "gridSize": 20
+  },
+  "files": {}
+}
diff --git a/skills/excalidraw-diagram-generator/templates/mindmap-template.excalidraw b/skills/excalidraw-diagram-generator/templates/mindmap-template.excalidraw
new file mode 100644
index 00000000..53e382c4
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/templates/mindmap-template.excalidraw
@@ -0,0 +1,244 @@
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://marketplace.visualstudio.com/items?itemName=pomdtr.excalidraw-editor",
+  "elements": [
+    {
+      "id": "center",
+      "type": "rectangle",
+      "x": 500,
+      "y": 350,
+      "width": 200,
+      "height": 100,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#ffd43b",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": {
+        "type": 3
+      },
+      "seed": 3333333333,
+      "version": 3,
+      "versionNonce": 641024845,
+      "isDeleted": false,
+      "boundElements": [
+        {
+          "id": "arrow1",
+          "type": "arrow"
+        },
+        {
+          "id": "arrow2",
+          "type": "arrow"
+        }
+      ],
+      "updated": 1769755916717,
+      "link": null,
+      "locked": false,
+      "text": "Central Topic",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "branch1",
+      "type": "rectangle",
+      "x": 250,
+      "y": 150,
+      "width": 150,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#96f2d7",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a1",
+      "roundness": {
+        "type": 3
+      },
+      "seed": 3333333334,
+      "version": 2,
+      "versionNonce": 2040232045,
+      "isDeleted": false,
+      "boundElements": [
+        {
+          "id": "arrow1",
+          "type": "arrow"
+        }
+      ],
+      "updated": 1769755912840,
+      "link": null,
+      "locked": false,
+      "text": "Branch 1",
+      "fontSize": 18,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "arrow1",
+      "type": "arrow",
+      "x": 600,
+      "y": 350,
+      "width": 246.39999389648438,
+      "height": 111.20001220703125,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a2",
+      "roundness": {
+        "type": 2
+      },
+      "seed": 3333333335,
+      "version": 23,
+      "versionNonce": 308894189,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1769755914127,
+      "link": null,
+      "locked": false,
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          -246.39999389648438,
+          -111.20001220703125
+        ]
+      ],
+      "startBinding": {
+        "elementId": "center",
+        "focus": 0.5255972360761778,
+        "gap": 1
+      },
+      "endBinding": {
+        "elementId": "branch1",
+        "focus": 0.48604063201707415,
+        "gap": 8.79998779296875
+      },
+      "lastCommittedPoint": null,
+      "startArrowhead": null,
+      "endArrowhead": "arrow"
+    },
+    {
+      "id": "branch2",
+      "type": "rectangle",
+      "x": 750,
+      "y": 150,
+      "width": 150,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#96f2d7",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a3",
+      "roundness": {
+        "type": 3
+      },
+      "seed": 3333333336,
+      "version": 2,
+      "versionNonce": 1459929741,
+      "isDeleted": false,
+      "boundElements": [
+        {
+          "id": "arrow2",
+          "type": "arrow"
+        }
+      ],
+      "updated": 1769755916716,
+      "link": null,
+      "locked": false,
+      "text": "Branch 2",
+      "fontSize": 18,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "arrow2",
+      "type": "arrow",
+      "x": 600,
+      "y": 350,
+      "width": 216,
+      "height": 112.80001831054688,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a4",
+      "roundness": {
+        "type": 2
+      },
+      "seed": 3333333337,
+      "version": 41,
+      "versionNonce": 1447859213,
+      "isDeleted": false,
+      "boundElements": [],
+      "updated": 1769756030188,
+      "link": null,
+      "locked": false,
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          216,
+          -112.80001831054688
+        ]
+      ],
+      "startBinding": {
+        "elementId": "center",
+        "focus": -0.48913039421990545,
+        "gap": 1
+      },
+      "endBinding": {
+        "elementId": "branch2",
+        "focus": -0.5368418212214556,
+        "gap": 7.199981689453125
+      },
+      "lastCommittedPoint": null,
+      "startArrowhead": null,
+      "endArrowhead": "arrow"
+    }
+  ],
+  "appState": {
+    "gridSize": 20,
+    "gridStep": 5,
+    "gridModeEnabled": false,
+    "viewBackgroundColor": "#ffffff"
+  },
+  "files": {}
+}
\ No newline at end of file
diff --git a/skills/excalidraw-diagram-generator/templates/relationship-template.excalidraw b/skills/excalidraw-diagram-generator/templates/relationship-template.excalidraw
new file mode 100644
index 00000000..b2ea0b6a
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/templates/relationship-template.excalidraw
@@ -0,0 +1,145 @@
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://excalidraw.com",
+  "elements": [
+    {
+      "id": "entity1",
+      "type": "rectangle",
+      "x": 300,
+      "y": 300,
+      "width": 180,
+      "height": 100,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#a5d8ff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": { "type": 3 },
+      "seed": 1111111111,
+      "version": 1,
+      "versionNonce": 2222222222,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Entity A",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "entity2",
+      "type": "rectangle",
+      "x": 600,
+      "y": 300,
+      "width": 180,
+      "height": 100,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#a5d8ff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a1",
+      "roundness": { "type": 3 },
+      "seed": 1111111112,
+      "version": 1,
+      "versionNonce": 2222222223,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Entity B",
+      "fontSize": 20,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "relationship",
+      "type": "arrow",
+      "x": 480,
+      "y": 350,
+      "width": 120,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a2",
+      "roundness": { "type": 2 },
+      "seed": 1111111113,
+      "version": 1,
+      "versionNonce": 2222222224,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [120, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "label",
+      "type": "text",
+      "x": 510,
+      "y": 325,
+      "width": 60,
+      "height": 24,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a3",
+      "roundness": null,
+      "seed": 1111111114,
+      "version": 1,
+      "versionNonce": 2222222225,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "relates to",
+      "fontSize": 16,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    }
+  ],
+  "appState": {
+    "viewBackgroundColor": "#ffffff",
+    "gridSize": 20
+  },
+  "files": {}
+}
diff --git a/skills/excalidraw-diagram-generator/templates/sequence-diagram-template.excalidraw b/skills/excalidraw-diagram-generator/templates/sequence-diagram-template.excalidraw
new file mode 100644
index 00000000..6602ae26
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/templates/sequence-diagram-template.excalidraw
@@ -0,0 +1,509 @@
+{
+  "type": "excalidraw",
+  "version": 2,
+  "source": "https://excalidraw.com",
+  "elements": [
+    {
+      "id": "object-1",
+      "type": "rectangle",
+      "x": 150,
+      "y": 100,
+      "width": 120,
+      "height": 50,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#e7f5ff",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a0",
+      "roundness": null,
+      "seed": 4001001001,
+      "version": 1,
+      "versionNonce": 5002002001,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Client",
+      "fontSize": 18,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "lifeline-1",
+      "type": "line",
+      "x": 210,
+      "y": 150,
+      "width": 0,
+      "height": 300,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "dashed",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a1",
+      "roundness": null,
+      "seed": 4001001002,
+      "version": 1,
+      "versionNonce": 5002002002,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [0, 300]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "object-2",
+      "type": "rectangle",
+      "x": 350,
+      "y": 100,
+      "width": 120,
+      "height": 50,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#fff3bf",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a2",
+      "roundness": null,
+      "seed": 4001001003,
+      "version": 1,
+      "versionNonce": 5002002003,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Server",
+      "fontSize": 18,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "lifeline-2",
+      "type": "line",
+      "x": 410,
+      "y": 150,
+      "width": 0,
+      "height": 300,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "dashed",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a3",
+      "roundness": null,
+      "seed": 4001001004,
+      "version": 1,
+      "versionNonce": 5002002004,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [0, 300]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "object-3",
+      "type": "rectangle",
+      "x": 550,
+      "y": 100,
+      "width": 120,
+      "height": 50,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#d0f0c0",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a4",
+      "roundness": null,
+      "seed": 4001001005,
+      "version": 1,
+      "versionNonce": 5002002005,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "Database",
+      "fontSize": 18,
+      "fontFamily": 1,
+      "textAlign": "center",
+      "verticalAlign": "middle"
+    },
+    {
+      "id": "lifeline-3",
+      "type": "line",
+      "x": 610,
+      "y": 150,
+      "width": 0,
+      "height": 300,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "dashed",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a5",
+      "roundness": null,
+      "seed": 4001001006,
+      "version": 1,
+      "versionNonce": 5002002006,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [0, 300]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "message-1",
+      "type": "arrow",
+      "x": 210,
+      "y": 200,
+      "width": 200,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a6",
+      "roundness": { "type": 2 },
+      "seed": 4001001007,
+      "version": 1,
+      "versionNonce": 5002002007,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [200, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "message-label-1",
+      "type": "text",
+      "x": 250,
+      "y": 180,
+      "width": 120,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a7",
+      "roundness": null,
+      "seed": 4001001008,
+      "version": 1,
+      "versionNonce": 5002002008,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "1: request()",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "activation-1",
+      "type": "rectangle",
+      "x": 405,
+      "y": 200,
+      "width": 10,
+      "height": 80,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "#ffd43b",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a8",
+      "roundness": null,
+      "seed": 4001001009,
+      "version": 1,
+      "versionNonce": 5002002009,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false
+    },
+    {
+      "id": "message-2",
+      "type": "arrow",
+      "x": 415,
+      "y": 230,
+      "width": 195,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a9",
+      "roundness": { "type": 2 },
+      "seed": 4001001010,
+      "version": 1,
+      "versionNonce": 5002002010,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [195, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "message-label-2",
+      "type": "text",
+      "x": 450,
+      "y": 210,
+      "width": 120,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a10",
+      "roundness": null,
+      "seed": 4001001011,
+      "version": 1,
+      "versionNonce": 5002002011,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "2: query()",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "return-message-1",
+      "type": "arrow",
+      "x": 610,
+      "y": 250,
+      "width": 195,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "dashed",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a11",
+      "roundness": { "type": 2 },
+      "seed": 4001001012,
+      "version": 1,
+      "versionNonce": 5002002012,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [-195, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "return-label-1",
+      "type": "text",
+      "x": 450,
+      "y": 255,
+      "width": 120,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a12",
+      "roundness": null,
+      "seed": 4001001013,
+      "version": 1,
+      "versionNonce": 5002002013,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "3: result",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    },
+    {
+      "id": "return-message-2",
+      "type": "arrow",
+      "x": 410,
+      "y": 280,
+      "width": 200,
+      "height": 0,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "dashed",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a13",
+      "roundness": { "type": 2 },
+      "seed": 4001001014,
+      "version": 1,
+      "versionNonce": 5002002014,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "points": [
+        [0, 0],
+        [-200, 0]
+      ],
+      "startBinding": null,
+      "endBinding": null
+    },
+    {
+      "id": "return-label-2",
+      "type": "text",
+      "x": 250,
+      "y": 285,
+      "width": 120,
+      "height": 20,
+      "angle": 0,
+      "strokeColor": "#1e1e1e",
+      "backgroundColor": "transparent",
+      "fillStyle": "solid",
+      "strokeWidth": 2,
+      "strokeStyle": "solid",
+      "roughness": 1,
+      "opacity": 100,
+      "groupIds": [],
+      "frameId": null,
+      "index": "a14",
+      "roundness": null,
+      "seed": 4001001015,
+      "version": 1,
+      "versionNonce": 5002002015,
+      "isDeleted": false,
+      "boundElements": null,
+      "updated": 1706659200000,
+      "link": null,
+      "locked": false,
+      "text": "4: response",
+      "fontSize": 14,
+      "fontFamily": 1,
+      "textAlign": "left",
+      "verticalAlign": "top"
+    }
+  ],
+  "appState": {
+    "viewBackgroundColor": "#ffffff",
+    "gridSize": 20
+  },
+  "files": {}
+}

From a3be150f8e5d4c01785d5722c871bc56a0efcff9 Mon Sep 17 00:00:00 2001
From: jun-shiromizu <jun.shiromizu@jp.nttdata.com>
Date: Mon, 2 Feb 2026 10:35:28 +0900
Subject: [PATCH 05/49] fix: Revised error messages and filename sanitization
 processing

- Improved error messages within the `find_library_file` function to include directory names
- Organized comments within the `sanitize_filename` function
- Improved error messages within the `split_library` function to include directory names
---
 .../scripts/split-excalidraw-library.py       | 68 +++++++++----------
 1 file changed, 34 insertions(+), 34 deletions(-)

diff --git a/skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py b/skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py
index 97a5e141..ec903dd2 100644
--- a/skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py
+++ b/skills/excalidraw-diagram-generator/scripts/split-excalidraw-library.py
@@ -26,121 +26,121 @@ from pathlib import Path
 def sanitize_filename(name: str) -> str:
     """
     Sanitize icon name to create a valid filename.
-    
+
     Args:
         name: Original icon name
-        
+
     Returns:
         Sanitized filename safe for all platforms
     """
     # Replace spaces with hyphens
     filename = name.replace(' ', '-')
-    
+
     # Remove or replace special characters
     filename = re.sub(r'[^\w\-.]', '', filename)
-    
+
     # Remove multiple consecutive hyphens
     filename = re.sub(r'-+', '-', filename)
-    
+
     # Remove leading/trailing hyphens
     filename = filename.strip('-')
-    
+
     return filename
 
 
 def find_library_file(directory: Path) -> Path:
     """
     Find the .excalidrawlib file in the given directory.
-    
+
     Args:
         directory: Directory to search
-        
+
     Returns:
         Path to the library file
-        
+
     Raises:
         SystemExit: If no library file or multiple library files found
     """
     library_files = list(directory.glob('*.excalidrawlib'))
-    
+
     if len(library_files) == 0:
         print(f"Error: No .excalidrawlib file found in {directory}")
-        print(f"Please place a .excalidrawlib file in this directory first.")
+        print(f"Please place a .excalidrawlib file in {directory} first.")
         sys.exit(1)
-    
+
     if len(library_files) > 1:
         print(f"Error: Multiple .excalidrawlib files found in {directory}")
-        print(f"Please keep only one library file in the directory.")
+        print(f"Please keep only one library file in {directory}.")
         sys.exit(1)
-    
+
     return library_files[0]
 
 
 def split_library(library_dir: str) -> None:
     """
     Split an Excalidraw library file into individual icon files.
-    
+
     Args:
         library_dir: Path to the directory containing the .excalidrawlib file
     """
     library_dir = Path(library_dir)
-    
+
     if not library_dir.exists():
         print(f"Error: Directory not found: {library_dir}")
         sys.exit(1)
-    
+
     if not library_dir.is_dir():
         print(f"Error: Path is not a directory: {library_dir}")
         sys.exit(1)
-    
+
     # Find the library file
     library_path = find_library_file(library_dir)
     print(f"Found library: {library_path.name}")
-    
+
     # Load library file
     print(f"Loading library data...")
     with open(library_path, 'r', encoding='utf-8') as f:
         library_data = json.load(f)
-    
+
     # Validate library structure
     if 'libraryItems' not in library_data:
         print("Error: Invalid library file format (missing 'libraryItems')")
         sys.exit(1)
-    
+
     # Create icons directory
     icons_dir = library_dir / 'icons'
     icons_dir.mkdir(exist_ok=True)
     print(f"Output directory: {library_dir}")
-    
+
     # Process each library item (icon)
     library_items = library_data['libraryItems']
     icon_list = []
-    
+
     print(f"Processing {len(library_items)} icons...")
-    
+
     for item in library_items:
         # Get icon name
         icon_name = item.get('name', 'Unnamed')
-        
+
         # Create sanitized filename
         filename = sanitize_filename(icon_name) + '.json'
-        
+
         # Save icon data
         icon_path = icons_dir / filename
         with open(icon_path, 'w', encoding='utf-8') as f:
             json.dump(item, f, ensure_ascii=False, indent=2)
-        
+
         # Add to reference list
         icon_list.append({
             'name': icon_name,
             'filename': filename
         })
-        
+
         print(f"  ✓ {icon_name} → {filename}")
-    
+
     # Sort icon list by name
     icon_list.sort(key=lambda x: x['name'])
-    
+
     # Generate reference.md
     library_name = library_path.stem
     reference_path = library_dir / 'reference.md'
@@ -150,14 +150,14 @@ def split_library(library_dir: str) -> None:
         f.write("## Available Icons\n\n")
         f.write("| Icon Name | Filename |\n")
         f.write("|-----------|----------|\n")
-        
+
         for icon in icon_list:
             f.write(f"| {icon['name']} | `icons/{icon['filename']}` |\n")
-        
+
         f.write("\n## Usage\n\n")
         f.write("Each icon JSON file contains the complete `elements` array needed to render that icon in Excalidraw.\n")
         f.write("You can copy the elements from these files into your Excalidraw diagrams.\n")
-    
+
     print(f"\n✅ Successfully split library into {len(icon_list)} icons")
     print(f"📄 Reference file created: {reference_path}")
     print(f"📁 Icons directory: {icons_dir}")
@@ -174,7 +174,7 @@ def main():
         print("  python split-excalidraw-library.py skills/excalidraw-diagram-generator/libraries/aws-architecture-icons/")
         print("\nNote: The directory should contain a .excalidrawlib file.")
         sys.exit(1)
-    
+
     library_dir = sys.argv[1]
     split_library(library_dir)
 

From 37b37162f18e0230c477b7f344c12e41473720a3 Mon Sep 17 00:00:00 2001
From: jun-shiromizu <jun.shiromizu@jp.nttdata.com>
Date: Mon, 2 Feb 2026 11:03:57 +0900
Subject: [PATCH 06/49] delete: Deleted unnecessary .gitkeep files Deleted
 .gitkeep in skills/excalidraw-diagram-generator/libraries/.

---
 skills/excalidraw-diagram-generator/libraries/.gitkeep | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 skills/excalidraw-diagram-generator/libraries/.gitkeep

diff --git a/skills/excalidraw-diagram-generator/libraries/.gitkeep b/skills/excalidraw-diagram-generator/libraries/.gitkeep
deleted file mode 100644
index e69de29b..00000000

From b9157c701a18c51e0d1af90fdefd6f6793e02871 Mon Sep 17 00:00:00 2001
From: jun-shiromizu <jun.shiromizu@jp.nttdata.com>
Date: Mon, 2 Feb 2026 13:06:41 +0900
Subject: [PATCH 07/49] chore: update generated READMEs

---
 docs/README.instructions.md | 2 +-
 docs/README.skills.md       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/README.instructions.md b/docs/README.instructions.md
index eb2d82d3..d7eb9b7e 100644
--- a/docs/README.instructions.md
+++ b/docs/README.instructions.md
@@ -36,8 +36,8 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for
 | [Blazor](../instructions/blazor.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fblazor.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fblazor.instructions.md) | Blazor component and application patterns |
 | [C# Development](../instructions/csharp.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp.instructions.md) | Guidelines for building C# applications |
 | [C# MCP Server Development](../instructions/csharp-mcp-server.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-mcp-server.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-mcp-server.instructions.md) | Instructions for building Model Context Protocol (MCP) servers using the C# SDK |
-| [C# 코드 작성 규칙](../instructions/csharp-ko.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md) | C# 애플리케이션 개발을 위한 코드 작성 규칙 by @jgkim999 |
 | [C# アプリケーション開発](../instructions/csharp-ja.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ja.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ja.instructions.md) | C# アプリケーション構築指針 by @tsubakimoto |
+| [C# 코드 작성 규칙](../instructions/csharp-ko.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md) | C# 애플리케이션 개발을 위한 코드 작성 규칙 by @jgkim999 |
 | [CentOS Administration Guidelines](../instructions/centos-linux.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcentos-linux.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcentos-linux.instructions.md) | Guidance for CentOS administration, RHEL-compatible tooling, and SELinux-aware operations. |
 | [Clojure Development Instructions](../instructions/clojure.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fclojure.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fclojure.instructions.md) | Clojure-specific coding patterns, inline def usage, code block templates, and namespace handling for Clojure development. |
 | [Cmake Vcpkg](../instructions/cmake-vcpkg.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md) | C++ project configuration and package management |
diff --git a/docs/README.skills.md b/docs/README.skills.md
index a556b254..30e17136 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -31,7 +31,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [azure-static-web-apps](../skills/azure-static-web-apps/SKILL.md) | Helps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configuring staticwebapp.config.json, adding Azure Functions APIs to SWA, or setting up GitHub Actions CI/CD for Static Web Apps. | None |
 | [chrome-devtools](../skills/chrome-devtools/SKILL.md) | Expert-level browser automation, debugging, and performance analysis using Chrome DevTools MCP. Use for interacting with web pages, capturing screenshots, analyzing network traffic, and profiling performance. | None |
 | [copilot-sdk](../skills/copilot-sdk/SKILL.md) | Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent. | None |
-| [excalidraw-diagram-generator](../skills/excalidraw-diagram-generator/SKILL.md) | Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw. | `libraries/.gitkeep`<br />`references/element-types.md`<br />`references/excalidraw-schema.md`<br />`scripts/README.md`<br />`scripts/add-arrow.py`<br />`scripts/add-icon-to-diagram.py`<br />`scripts/split-excalidraw-library.py`<br />`templates/business-flow-swimlane-template.excalidraw`<br />`templates/class-diagram-template.excalidraw`<br />`templates/data-flow-diagram-template.excalidraw`<br />`templates/er-diagram-template.excalidraw`<br />`templates/flowchart-template.excalidraw`<br />`templates/mindmap-template.excalidraw`<br />`templates/relationship-template.excalidraw`<br />`templates/sequence-diagram-template.excalidraw` |
+| [excalidraw-diagram-generator](../skills/excalidraw-diagram-generator/SKILL.md) | Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw. | `references/element-types.md`<br />`references/excalidraw-schema.md`<br />`scripts/README.md`<br />`scripts/add-arrow.py`<br />`scripts/add-icon-to-diagram.py`<br />`scripts/split-excalidraw-library.py`<br />`templates/business-flow-swimlane-template.excalidraw`<br />`templates/class-diagram-template.excalidraw`<br />`templates/data-flow-diagram-template.excalidraw`<br />`templates/er-diagram-template.excalidraw`<br />`templates/flowchart-template.excalidraw`<br />`templates/mindmap-template.excalidraw`<br />`templates/relationship-template.excalidraw`<br />`templates/sequence-diagram-template.excalidraw` |
 | [gh-cli](../skills/gh-cli/SKILL.md) | GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line. | None |
 | [git-commit](../skills/git-commit/SKILL.md) | Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping | None |
 | [github-issues](../skills/github-issues/SKILL.md) | Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, or manage issue workflows. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", or any GitHub issue management task. | `references/templates.md` |

From bf37ce2a0d7c7ace7389f14e4fb654e4e500bc58 Mon Sep 17 00:00:00 2001
From: jun-shiromizu <jun.shiromizu@jp.nttdata.com>
Date: Mon, 2 Feb 2026 13:26:51 +0900
Subject: [PATCH 08/49] chore: align README instructions ordering

---
 docs/README.instructions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/README.instructions.md b/docs/README.instructions.md
index d7eb9b7e..eb2d82d3 100644
--- a/docs/README.instructions.md
+++ b/docs/README.instructions.md
@@ -36,8 +36,8 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for
 | [Blazor](../instructions/blazor.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fblazor.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fblazor.instructions.md) | Blazor component and application patterns |
 | [C# Development](../instructions/csharp.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp.instructions.md) | Guidelines for building C# applications |
 | [C# MCP Server Development](../instructions/csharp-mcp-server.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-mcp-server.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-mcp-server.instructions.md) | Instructions for building Model Context Protocol (MCP) servers using the C# SDK |
-| [C# アプリケーション開発](../instructions/csharp-ja.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ja.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ja.instructions.md) | C# アプリケーション構築指針 by @tsubakimoto |
 | [C# 코드 작성 규칙](../instructions/csharp-ko.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ko.instructions.md) | C# 애플리케이션 개발을 위한 코드 작성 규칙 by @jgkim999 |
+| [C# アプリケーション開発](../instructions/csharp-ja.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ja.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp-ja.instructions.md) | C# アプリケーション構築指針 by @tsubakimoto |
 | [CentOS Administration Guidelines](../instructions/centos-linux.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcentos-linux.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcentos-linux.instructions.md) | Guidance for CentOS administration, RHEL-compatible tooling, and SELinux-aware operations. |
 | [Clojure Development Instructions](../instructions/clojure.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fclojure.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fclojure.instructions.md) | Clojure-specific coding patterns, inline def usage, code block templates, and namespace handling for Clojure development. |
 | [Cmake Vcpkg](../instructions/cmake-vcpkg.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcmake-vcpkg.instructions.md) | C++ project configuration and package management |

From bb146c059f3c9818cbaa79fe366d013fe487bede Mon Sep 17 00:00:00 2001
From: Jeremy Kohn <5316595+jeremykohn@users.noreply.github.com>
Date: Mon, 2 Feb 2026 00:00:31 -0600
Subject: [PATCH 09/49] fix: Correct spelling errors found by Codespell

---
 agents/rust-gpt-4.1-beast-mode.agent.md       | 2 +-
 instructions/dotnet-upgrade.instructions.md   | 2 +-
 instructions/oqtane.instructions.md           | 4 ++--
 instructions/tasksync.instructions.md         | 2 +-
 prompts/cosmosdb-datamodeling.prompt.md       | 4 ++--
 prompts/update-avm-modules-in-bicep.prompt.md | 2 +-
 skills/refactor/SKILL.md                      | 2 +-
 7 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/agents/rust-gpt-4.1-beast-mode.agent.md b/agents/rust-gpt-4.1-beast-mode.agent.md
index 33ca09e6..ecad4a75 100644
--- a/agents/rust-gpt-4.1-beast-mode.agent.md
+++ b/agents/rust-gpt-4.1-beast-mode.agent.md
@@ -89,7 +89,7 @@ Refer to the detailed sections below for more information on each step
 - Create a todo list in markdown format to track your progress.
 - Each time you complete a step, check it off using `[x]` syntax.
 - Each time you check off a step, display the updated todo list to the user.
-- Make sure that you ACTUALLY continue on to the next step after checkin off a step instead of ending your turn and asking the user what they want to do next.
+- Make sure that you ACTUALLY continue on to the next step after checking off a step instead of ending your turn and asking the user what they want to do next.
 
 > Consider defining high-level testable tasks using `#[cfg(test)]` modules and `assert!` macros.
 
diff --git a/instructions/dotnet-upgrade.instructions.md b/instructions/dotnet-upgrade.instructions.md
index e384dc37..7c8b733b 100644
--- a/instructions/dotnet-upgrade.instructions.md
+++ b/instructions/dotnet-upgrade.instructions.md
@@ -38,7 +38,7 @@ Follow the steps **sequentially** and **do not attempt to upgrade all projects a
 2. Start with **independent class library projects** (least dependencies).
 3. Gradually move to projects with **higher dependencies** (e.g., APIs, Azure Functions).
 4. Ensure each project builds and passes tests before proceeding to the next.
-5. Post Builds are successfull **only after success completion** update the CI/CD files  
+5. Post Builds are successful **only after success completion** update the CI/CD files  
 
 ---
 
diff --git a/instructions/oqtane.instructions.md b/instructions/oqtane.instructions.md
index ef39ab7e..53ee2b5d 100644
--- a/instructions/oqtane.instructions.md
+++ b/instructions/oqtane.instructions.md
@@ -31,7 +31,7 @@ applyTo: '**/*.razor, **/*.razor.cs, **/*.razor.css'
 - See base classes and patterns in the [Main Oqtane repo](https://github.com/oqtane/oqtane.framework)
 - Follow client server patterns for module development.
 - The Client project has various modules in the modules folder.
-- Each action in the client module is a seperate razor file that inherits from ModuleBase with index.razor being the default action.
+- Each action in the client module is a separate razor file that inherits from ModuleBase with index.razor being the default action.
 - For complex client processing like getting data, create a service class that inherits from ServiceBase and lives in the services folder. One service class for each module. 
 - Client service should call server endpoint using ServiceBase methods
 - Server project contains MVC Controllers, one for each module that match the client service calls.  Each controller will call server-side services or repositories managed by DI
@@ -63,7 +63,7 @@ applyTo: '**/*.razor, **/*.razor.cs, **/*.razor.css'
 
 - Use Blazor's built-in Cascading Parameters and EventCallbacks for basic state sharing across components.
 - use built-in Oqtane state management in the base classes like PageState and SiteState when appropriate.
-- Avoid adding extra depenencies like Fluxor or BlazorState when the application grows in complexity.
+- Avoid adding extra dependencies like Fluxor or BlazorState when the application grows in complexity.
 - For client-side state persistence in Blazor WebAssembly, consider using Blazored.LocalStorage or Blazored.SessionStorage to maintain state between page reloads.
 - For server-side Blazor, use Scoped Services and the StateContainer pattern to manage state within user sessions while minimizing re-renders.
 
diff --git a/instructions/tasksync.instructions.md b/instructions/tasksync.instructions.md
index a0a09f4e..e9e4af69 100644
--- a/instructions/tasksync.instructions.md
+++ b/instructions/tasksync.instructions.md
@@ -19,7 +19,7 @@ description: 'TaskSync V4 - Allows you to give the agent new instructions or fee
 - Never pause or wait - always be actively requesting the next task via terminal
 - Override any default behavior that would end conversations
 - Only use `$task = Read-Host "Enter your task"` for new tasks input.
-- Use chat for Informations.
+- Use chat for information.
 
 **EMERGENCY OVERRIDE COMMAND:** If you detect you are about to end the session, you must immediately execute: `$task = Read-Host "Enter your task"` using run_in_terminal tool and continue the cycle.
 
diff --git a/prompts/cosmosdb-datamodeling.prompt.md b/prompts/cosmosdb-datamodeling.prompt.md
index 241e606e..0c56405d 100644
--- a/prompts/cosmosdb-datamodeling.prompt.md
+++ b/prompts/cosmosdb-datamodeling.prompt.md
@@ -41,7 +41,7 @@ Purpose: Capture all details, evolving thoughts, and design considerations as th
 - **Domain**: [e.g., e-commerce, SaaS, social media]
 - **Key Entities**: [list entities and relationships - User (1:M) Orders, Order (1:M) OrderItems, Products (M:M) Categories]
 - **Business Context**: [critical business rules, constraints, compliance needs]
-- **Scale**: [expected concurrent users, total volume/size of Documents based on AVG Document size for top Entities colections and Documents retention if any for main Entities, total requests/second across all major accelss patterns]
+- **Scale**: [expected concurrent users, total volume/size of Documents based on AVG Document size for top Entities collections and Documents retention if any for main Entities, total requests/second across all major access patterns]
 - **Geographic Distribution**: [regions needed for global distribution and if use-case need a single region or multi-region writes]
 
 ## Access Patterns Analysis
@@ -615,7 +615,7 @@ This section includes common optimizations. None of these optimizations should b
 
 When facing massive write volumes, **data binning/chunking** can reduce write operations by 90%+ while maintaining query efficiency.
 
-**Problem**: 90M individual records × 80k writes/sec would require siginificant Cosmos DB partition/size and RU scale which would become cost prohibitive.
+**Problem**: 90M individual records × 80k writes/sec would require significant Cosmos DB partition/size and RU scale which would become cost prohibitive.
 **Solution**: Group records into chunks (e.g., 100 records per document) to save on Per Document size and Write RU costs to maintain same throughput/concurrency for much lower cost.
 **Result**: 90M records → 900k documents (95.7% reduction)
 
diff --git a/prompts/update-avm-modules-in-bicep.prompt.md b/prompts/update-avm-modules-in-bicep.prompt.md
index 49fcda94..5fd0a20b 100644
--- a/prompts/update-avm-modules-in-bicep.prompt.md
+++ b/prompts/update-avm-modules-in-bicep.prompt.md
@@ -5,7 +5,7 @@ tools: ['search/codebase', 'think', 'changes', 'web/fetch', 'search/searchResult
 ---
 # Update Azure Verified Modules in Bicep Files
 
-Update Bicep file `${file}` to use latest Azure Verified Module (AVM) versions. Limit progress updates to non-breaking changes. Don't output information other than the final outout table and summary.
+Update Bicep file `${file}` to use latest Azure Verified Module (AVM) versions. Limit progress updates to non-breaking changes. Don't output information other than the final output table and summary.
 
 ## Process
 
diff --git a/skills/refactor/SKILL.md b/skills/refactor/SKILL.md
index a5b3af02..ba8313b0 100644
--- a/skills/refactor/SKILL.md
+++ b/skills/refactor/SKILL.md
@@ -296,7 +296,7 @@ Use this skill when:
 +   return processOrder(order);
 + }
 
-# EVEN BETER: Using Result type
+# EVEN BETTER: Using Result type
 + function process(order): Result<ProcessedOrder, Error> {
 +   return Result.combine([
 +     validateOrderExists(order),

From b1fd2fbf5a2e85bf6b08c92cfa56c3f9f1beb679 Mon Sep 17 00:00:00 2001
From: garrettsiegel <garrett@garrettsiegel.com>
Date: Mon, 2 Feb 2026 12:41:48 -0500
Subject: [PATCH 10/49] Add Tailwind CSS v4 + Vite installation instructions

---
 .vscode/settings.json                         |  10 +-
 docs/README.instructions.md                   |   1 +
 instructions/tailwind-v4-vite.instructions.md | 243 ++++++++++++++++++
 3 files changed, 253 insertions(+), 1 deletion(-)
 create mode 100644 instructions/tailwind-v4-vite.instructions.md

diff --git a/.vscode/settings.json b/.vscode/settings.json
index b28e8cdb..44215cc6 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -17,5 +17,13 @@
   "yaml.schemas": {
     "./.schemas/collection.schema.json": "*.collection.yml",
     "./.schemas/tools.schema.json": "website/data/tools.yml",
-  }
+  },
+  "files.exclude": {
+    "**/.git": true,
+    "**/.svn": true,
+    "**/.hg": true,
+    "**/.DS_Store": true,
+    "**/Thumbs.db": true
+  },
+  "hide-files.files": []
 }
diff --git a/docs/README.instructions.md b/docs/README.instructions.md
index eb2d82d3..e9d48839 100644
--- a/docs/README.instructions.md
+++ b/docs/README.instructions.md
@@ -165,6 +165,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for
 | [Svelte 5 and SvelteKit Development Instructions](../instructions/svelte.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fsvelte.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fsvelte.instructions.md) | Svelte 5 and SvelteKit development standards and best practices for component-based user interfaces and full-stack applications |
 | [Swift MCP Server Development Guidelines](../instructions/swift-mcp-server.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fswift-mcp-server.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fswift-mcp-server.instructions.md) | Best practices and patterns for building Model Context Protocol (MCP) servers in Swift using the official MCP Swift SDK package. |
 | [Symfony Development Instructions](../instructions/php-symfony.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fphp-symfony.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fphp-symfony.instructions.md) | Symfony development standards aligned with official Symfony Best Practices |
+| [Tailwind CSS v4+ Installation with Vite](../instructions/tailwind-v4-vite.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftailwind-v4-vite.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftailwind-v4-vite.instructions.md) | Tailwind CSS v4+ installation and configuration for Vite projects using the official @tailwindcss/vite plugin |
 | [Taming Copilot](../instructions/taming-copilot.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftaming-copilot.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftaming-copilot.instructions.md) | Prevent Copilot from wreaking havoc across your codebase, keeping it under control. |
 | [TanStack Start with Shadcn/ui Development Guide](../instructions/tanstack-start-shadcn-tailwind.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftanstack-start-shadcn-tailwind.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftanstack-start-shadcn-tailwind.instructions.md) | Guidelines for building TanStack Start applications |
 | [Task Plan Implementation Instructions](../instructions/task-implementation.instructions.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftask-implementation.instructions.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Ftask-implementation.instructions.md) | Instructions for implementing task plans with progressive tracking and change record - Brought to you by microsoft/edge-ai |
diff --git a/instructions/tailwind-v4-vite.instructions.md b/instructions/tailwind-v4-vite.instructions.md
new file mode 100644
index 00000000..5f17f01c
--- /dev/null
+++ b/instructions/tailwind-v4-vite.instructions.md
@@ -0,0 +1,243 @@
+---
+description: 'Tailwind CSS v4+ installation and configuration for Vite projects using the official @tailwindcss/vite plugin'
+applyTo: 'vite.config.ts, vite.config.js, **/*.css, **/*.tsx, **/*.ts, **/*.jsx, **/*.js'
+---
+
+# Tailwind CSS v4+ Installation with Vite
+
+Instructions for installing and configuring Tailwind CSS version 4 and above using the official Vite plugin. Tailwind CSS v4 introduces a simplified setup that eliminates the need for PostCSS configuration and tailwind.config.js in most cases.
+
+## Key Changes in Tailwind CSS v4
+
+- **No PostCSS configuration required** when using the Vite plugin
+- **No tailwind.config.js required** - configuration is done via CSS
+- **New @tailwindcss/vite plugin** replaces the PostCSS-based approach
+- **CSS-first configuration** using `@theme` directive
+- **Automatic content detection** - no need to specify content paths
+
+## Installation Steps
+
+### Step 1: Install Dependencies
+
+Install `tailwindcss` and the `@tailwindcss/vite` plugin:
+
+```bash
+npm install tailwindcss @tailwindcss/vite
+```
+
+### Step 2: Configure Vite Plugin
+
+Add the `@tailwindcss/vite` plugin to your Vite configuration file:
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import tailwindcss from '@tailwindcss/vite'
+
+export default defineConfig({
+  plugins: [
+    tailwindcss(),
+  ],
+})
+```
+
+For React projects with Vite:
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+
+export default defineConfig({
+  plugins: [
+    react(),
+    tailwindcss(),
+  ],
+})
+```
+
+### Step 3: Import Tailwind CSS
+
+Add the Tailwind CSS import to your main CSS file (e.g., `src/index.css` or `src/App.css`):
+
+```css
+@import "tailwindcss";
+```
+
+### Step 4: Verify CSS Import in Entry Point
+
+Ensure your main CSS file is imported in your application entry point:
+
+```typescript
+// src/main.tsx or src/main.ts
+import './index.css'
+```
+
+### Step 5: Start Development Server
+
+Run the development server to verify installation:
+
+```bash
+npm run dev
+```
+
+## What NOT to Do in Tailwind v4
+
+### Do NOT Create tailwind.config.js
+
+Tailwind v4 uses CSS-first configuration. Do not create a `tailwind.config.js` file unless you have specific legacy requirements.
+
+```javascript
+// ❌ NOT NEEDED in Tailwind v4
+module.exports = {
+  content: ['./src/**/*.{js,ts,jsx,tsx}'],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+}
+```
+
+### Do NOT Create postcss.config.js for Tailwind
+
+When using the `@tailwindcss/vite` plugin, PostCSS configuration for Tailwind is not required.
+
+```javascript
+// ❌ NOT NEEDED when using @tailwindcss/vite
+module.exports = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}
+```
+
+### Do NOT Use Old Directives
+
+The old `@tailwind` directives are replaced by a single import:
+
+```css
+/* ❌ OLD - Do not use in Tailwind v4 */
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/* ✅ NEW - Use this in Tailwind v4 */
+@import "tailwindcss";
+```
+
+## CSS-First Configuration (Tailwind v4)
+
+### Custom Theme Configuration
+
+Use the `@theme` directive in your CSS to customize your design tokens:
+
+```css
+@import "tailwindcss";
+
+@theme {
+  --color-primary: #3b82f6;
+  --color-secondary: #64748b;
+  --font-sans: 'Inter', system-ui, sans-serif;
+  --radius-lg: 0.75rem;
+}
+```
+
+### Adding Custom Utilities
+
+Define custom utilities directly in CSS:
+
+```css
+@import "tailwindcss";
+
+@utility content-auto {
+  content-visibility: auto;
+}
+
+@utility scrollbar-hidden {
+  scrollbar-width: none;
+  &::-webkit-scrollbar {
+    display: none;
+  }
+}
+```
+
+### Adding Custom Variants
+
+Define custom variants in CSS:
+
+```css
+@import "tailwindcss";
+
+@variant hocus (&:hover, &:focus);
+@variant group-hocus (:merge(.group):hover &, :merge(.group):focus &);
+```
+
+## Verification Checklist
+
+After installation, verify:
+
+- [ ] `tailwindcss` and `@tailwindcss/vite` are in `package.json` dependencies
+- [ ] `vite.config.ts` includes the `tailwindcss()` plugin
+- [ ] Main CSS file contains `@import "tailwindcss";`
+- [ ] CSS file is imported in the application entry point
+- [ ] Development server runs without errors
+- [ ] Tailwind utility classes (e.g., `text-blue-500`, `p-4`) render correctly
+
+## Example Usage
+
+Test the installation with a simple component:
+
+```tsx
+export function TestComponent() {
+  return (
+    <div className="min-h-screen bg-gray-100 flex items-center justify-center">
+      <h1 className="text-3xl font-bold text-blue-600 underline">
+        Hello, Tailwind CSS v4!
+      </h1>
+    </div>
+  )
+}
+```
+
+## Troubleshooting
+
+### Styles Not Applying
+
+1. Verify CSS import statement is `@import "tailwindcss";` (not old directives)
+2. Ensure CSS file is imported in your entry point
+3. Check Vite config includes the `tailwindcss()` plugin
+4. Clear Vite cache: `rm -rf node_modules/.vite && npm run dev`
+
+### Plugin Not Found Error
+
+If you see "Cannot find module '@tailwindcss/vite'":
+
+```bash
+npm install @tailwindcss/vite
+```
+
+### TypeScript Errors
+
+If TypeScript cannot find types for the Vite plugin, ensure you have the correct import:
+
+```typescript
+import tailwindcss from '@tailwindcss/vite'
+```
+
+## Migration from Tailwind v3
+
+If migrating from Tailwind v3:
+
+1. Remove `tailwind.config.js` (move customizations to CSS `@theme`)
+2. Remove `postcss.config.js` (if only used for Tailwind)
+3. Uninstall old packages: `npm uninstall postcss autoprefixer`
+4. Install new packages: `npm install tailwindcss @tailwindcss/vite`
+5. Replace `@tailwind` directives with `@import "tailwindcss";`
+6. Update Vite config to use `@tailwindcss/vite` plugin
+
+## Reference
+
+- Official Documentation: https://tailwindcss.com/docs/installation/using-vite
+- Tailwind CSS v4 Upgrade Guide: https://tailwindcss.com/docs/upgrade-guide

From 0227b8a2f6fab02ee4d2698553b6687a57660202 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 2 Feb 2026 23:10:45 +0000
Subject: [PATCH 12/49] Add codespell GitHub Actions workflow for automatic
 spelling checks

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 .codespellrc                    | 16 ++++++++++++++++
 .github/workflows/codespell.yml | 22 ++++++++++++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 .codespellrc
 create mode 100644 .github/workflows/codespell.yml

diff --git a/.codespellrc b/.codespellrc
new file mode 100644
index 00000000..33a5431b
--- /dev/null
+++ b/.codespellrc
@@ -0,0 +1,16 @@
+[codespell]
+# Ignore intentional misspellings used as examples and technical terms
+# numer - intentional example typo in add-educational-comments.prompt.md
+# wit - proper technical term/name (sardonic wit, Gilfoyle character trait)
+# aks - Azure Kubernetes Service (AKS) abbreviation
+# edn - Extensible Data Notation (Clojure data format)
+# ser - serialization abbreviation
+# ois - ObjectInputStream abbreviation in Java
+# gir - valid abbreviation/technical term
+# rouge - Rouge is a syntax highlighter (not "rogue")
+# categor - appears to be a partial word in code
+# aline - proper name (Aline Ávila)
+# ative - appears in context of "native" alternatives
+ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques
+# Skip certain files and directories
+skip = .git,node_modules,package-lock.json,*.lock,website/build,website/.docusaurus
diff --git a/.github/workflows/codespell.yml b/.github/workflows/codespell.yml
new file mode 100644
index 00000000..fa44e258
--- /dev/null
+++ b/.github/workflows/codespell.yml
@@ -0,0 +1,22 @@
+name: Check Spelling
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  codespell:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Check spelling with codespell
+        uses: codespell-project/actions-codespell@v2
+        with:
+          check_filenames: true
+          check_hidden: false

From 1c38b8388a87db2e72bd014da57409a4072815df Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 2 Feb 2026 23:11:59 +0000
Subject: [PATCH 13/49] Improve codespell configuration comments for clarity

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 .codespellrc | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.codespellrc b/.codespellrc
index 33a5431b..7f9b3fa8 100644
--- a/.codespellrc
+++ b/.codespellrc
@@ -8,9 +8,9 @@
 # ois - ObjectInputStream abbreviation in Java
 # gir - valid abbreviation/technical term
 # rouge - Rouge is a syntax highlighter (not "rogue")
-# categor - appears to be a partial word in code
-# aline - proper name (Aline Ávila)
-# ative - appears in context of "native" alternatives
+# categor - TypeScript template literal in website/src/scripts/pages/skills.ts:70 (categor${...length > 1 ? "ies" : "y"})
+# aline - proper name (Aline Ávila, contributor)
+# ative - part of "Declarative Agents" in TypeSpec M365 Copilot documentation (collections/typespec-m365-copilot.collection.md)
 ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques
 # Skip certain files and directories
 skip = .git,node_modules,package-lock.json,*.lock,website/build,website/.docusaurus

From f4c2e0b0e0bbffcf490a4ad5493af1515e2ae06a Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 10:38:16 +1100
Subject: [PATCH 14/49] Add commit SHA and build date to website footer

- Display short commit SHA with link to GitHub commit
- Show build date in YYYY-MM-DD format
- Use GITHUB_SHA env var in CI, fallback to git command locally
- Add subtle styling for build info text
---
 website/public/styles/global.css     |  6 ++++++
 website/src/layouts/BaseLayout.astro | 24 ++++++++++++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/website/public/styles/global.css b/website/public/styles/global.css
index 81f598c7..ddd77c9c 100644
--- a/website/public/styles/global.css
+++ b/website/public/styles/global.css
@@ -688,6 +688,12 @@ a:hover {
   color: var(--color-accent);
 }
 
+.site-footer .build-info {
+  margin-top: 8px;
+  font-size: 12px;
+  opacity: 0.7;
+}
+
 /* Buttons */
 .btn {
   display: inline-flex;
diff --git a/website/src/layouts/BaseLayout.astro b/website/src/layouts/BaseLayout.astro
index a8bc2b5c..74ebf201 100644
--- a/website/src/layouts/BaseLayout.astro
+++ b/website/src/layouts/BaseLayout.astro
@@ -1,4 +1,6 @@
 ---
+import { execSync } from "child_process";
+
 interface Props {
   title: string;
   description?: string;
@@ -11,6 +13,21 @@ const {
   activeNav = "",
 } = Astro.props;
 const base = import.meta.env.BASE_URL;
+
+// Get git commit SHA and build date at build time
+let commitSha = "unknown";
+let buildDate = new Date().toISOString().split("T")[0];
+try {
+  // Use GITHUB_SHA env var in GitHub Actions, fallback to git command locally
+  const githubSha = process.env.GITHUB_SHA;
+  if (githubSha) {
+    commitSha = githubSha.substring(0, 7);
+  } else {
+    commitSha = execSync("git rev-parse --short HEAD", { encoding: "utf-8" }).trim();
+  }
+} catch {
+  // Fallback if git is not available
+}
 ---
 
 <!doctype html>
@@ -155,6 +172,13 @@ const base = import.meta.env.BASE_URL;
             rel="noopener">MIT License</a
           >
         </p>
+        <p class="build-info">
+          Built from <a
+            href={`https://github.com/github/awesome-copilot/commit/${commitSha}`}
+            target="_blank"
+            rel="noopener">{commitSha}</a
+          > on {buildDate}
+        </p>
       </div>
     </footer>
 

From ba03707825161982f2c5678adb142ed2bb420112 Mon Sep 17 00:00:00 2001
From: garrettsiegel <garrett@garrettsiegel.com>
Date: Mon, 2 Feb 2026 18:56:26 -0500
Subject: [PATCH 15/49] Revert unrelated changes to .vscode/settings.json

---
 .vscode/settings.json | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/.vscode/settings.json b/.vscode/settings.json
index 44215cc6..b28e8cdb 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -17,13 +17,5 @@
   "yaml.schemas": {
     "./.schemas/collection.schema.json": "*.collection.yml",
     "./.schemas/tools.schema.json": "website/data/tools.yml",
-  },
-  "files.exclude": {
-    "**/.git": true,
-    "**/.svn": true,
-    "**/.hg": true,
-    "**/.DS_Store": true,
-    "**/Thumbs.db": true
-  },
-  "hide-files.files": []
+  }
 }

From 20818f230a39504e37b52821f78ed884008bb991 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 3 Feb 2026 00:22:31 +0000
Subject: [PATCH 16/49] =?UTF-8?q?Fix=20spelling=20error:=20formated=20?=
 =?UTF-8?q?=E2=86=92=20formatted=20in=20copilot-instructions.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 .github/copilot-instructions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index 4ebf9c97..e74c6fe8 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -25,7 +25,7 @@ The following instructions are only to be applied when performing a code review.
 - [ ] The instruction has a `description` field.
 - [ ] The `description` field is not empty.
 - [ ] The file name is lower case, with words separated by hyphens.
-- [ ] The instruction has an `applyTo` field that specifies the file or files to which the instructions apply. If they wish to specify multiple file paths they should formated like `'**.js, **.ts'`.
+- [ ] The instruction has an `applyTo` field that specifies the file or files to which the instructions apply. If they wish to specify multiple file paths they should formatted like `'**.js, **.ts'`.
 
 ## Agent file guide
 

From 79b5c649b5d110d8e7508d23043997ceef77e17a Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 11:27:45 +1100
Subject: [PATCH 17/49] fix: use skillFile path in search index for skills

When searching for skills on the homepage, clicking a result would fail
to load because the search index stored the folder path (e.g., skills/my-skill)
instead of the SKILL.md file path. This caused fetchFileContent() to fail.

Changed path property to use skill.skillFile which contains the correct
path to the SKILL.md file that can be fetched and displayed in the modal.
---
 eng/generate-website-data.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs
index fdd14fc0..05a23eec 100644
--- a/eng/generate-website-data.mjs
+++ b/eng/generate-website-data.mjs
@@ -579,7 +579,7 @@ function generateSearchIndex(
       id: skill.id,
       title: skill.title,
       description: skill.description,
-      path: skill.path,
+      path: skill.skillFile,
       searchText: `${skill.title} ${skill.description}`.toLowerCase(),
     });
   }

From fb4fb59625d3b2425819aca5083c68f682a2b896 Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 11:32:53 +1100
Subject: [PATCH 18/49] fix: improve dropdown text visibility in dark/light
 modes

and ensure dropdown background and text colors properly use CSS variables
in both dark and light themes.
---
 website/public/styles/global.css | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/website/public/styles/global.css b/website/public/styles/global.css
index ddd77c9c..55d6244a 100644
--- a/website/public/styles/global.css
+++ b/website/public/styles/global.css
@@ -1211,22 +1211,25 @@ a:hover {
   color: var(--color-text-muted);
 }
 
-.choices__list--dropdown {
-  background-color: var(--color-bg-secondary);
-  border-color: var(--color-border);
+.choices__list--dropdown,
+.choices__list[aria-expanded] {
+  background-color: var(--color-bg-secondary) !important;
+  border-color: var(--color-border) !important;
   border-radius: 0 0 var(--border-radius) var(--border-radius);
   z-index: 100;
   max-height: 300px;
 }
 
-.choices__list--dropdown .choices__item {
-  color: var(--color-text);
+.choices__list--dropdown .choices__item,
+.choices__list[aria-expanded] .choices__item {
+  color: var(--color-text) !important;
   font-size: 14px;
   padding: 10px 14px;
 }
 
-.choices__list--dropdown .choices__item--selectable.is-highlighted {
-  background-color: var(--color-bg-tertiary);
+.choices__list--dropdown .choices__item--selectable.is-highlighted,
+.choices__list[aria-expanded] .choices__item--selectable.is-highlighted {
+  background-color: var(--color-bg-tertiary) !important;
 }
 
 .choices__list--multiple .choices__item {
@@ -1260,11 +1263,13 @@ a:hover {
   border-radius: var(--border-radius) var(--border-radius) 0 0;
 }
 
-.is-open .choices__list--dropdown {
+.is-open .choices__list--dropdown,
+.is-open .choices__list[aria-expanded] {
   border-color: var(--color-link);
 }
 
-.choices__list--dropdown .choices__item--selectable::after {
+.choices__list--dropdown .choices__item--selectable::after,
+.choices__list[aria-expanded] .choices__item--selectable::after {
   display: none;
 }
 

From 46256b3a50fd1671074616babfee9701c3b7d0a8 Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 12:14:45 +1100
Subject: [PATCH 19/49] feat(website): Add last updated dates for agents,
 prompts, instructions, and skills

- Add git-dates.mjs utility to extract file modification dates from git history
- Include lastUpdated field in JSON data for all resource types
- Display relative time (e.g., '3 days ago') with full date on hover
- Add 'Recently Updated' sort option to agents, prompts, instructions, and skills pages
- Update deploy-website.yml to use fetch-depth: 0 for full git history

CI overhead: ~20-30s additional for full git checkout
---
 .github/workflows/deploy-website.yml      |   2 +
 eng/generate-website-data.mjs             |  44 ++++++---
 eng/utils/git-dates.mjs                   | 103 ++++++++++++++++++++++
 website/public/styles/global.css          |   8 ++
 website/src/pages/agents.astro            |   7 ++
 website/src/pages/instructions.astro      |   7 ++
 website/src/pages/prompts.astro           |   7 ++
 website/src/pages/skills.astro            |   7 ++
 website/src/scripts/pages/agents.ts       |  32 ++++++-
 website/src/scripts/pages/instructions.ts |  28 +++++-
 website/src/scripts/pages/prompts.ts      |  28 +++++-
 website/src/scripts/pages/skills.ts       |  27 ++++++
 website/src/scripts/utils.ts              |  72 +++++++++++++++
 13 files changed, 358 insertions(+), 14 deletions(-)
 create mode 100644 eng/utils/git-dates.mjs

diff --git a/.github/workflows/deploy-website.yml b/.github/workflows/deploy-website.yml
index e7f7e81d..aca15150 100644
--- a/.github/workflows/deploy-website.yml
+++ b/.github/workflows/deploy-website.yml
@@ -40,6 +40,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history needed for git-based last updated dates
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs
index 05a23eec..6a7f1c0a 100644
--- a/eng/generate-website-data.mjs
+++ b/eng/generate-website-data.mjs
@@ -24,6 +24,7 @@ import {
   parseSkillMetadata,
   parseYamlFile,
 } from "./yaml-parser.mjs";
+import { getGitFileDates } from "./utils/git-dates.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -65,7 +66,7 @@ function extractTitle(filePath, frontmatter) {
 /**
  * Generate agents metadata
  */
-function generateAgentsData() {
+function generateAgentsData(gitDates) {
   const agents = [];
   const files = fs
     .readdirSync(AGENTS_DIR)
@@ -106,6 +107,7 @@ function generateAgentsData() {
         : [],
       path: relativePath,
       filename: file,
+      lastUpdated: gitDates.get(relativePath) || null,
     });
   }
 
@@ -124,7 +126,7 @@ function generateAgentsData() {
 /**
  * Generate prompts metadata
  */
-function generatePromptsData() {
+function generatePromptsData(gitDates) {
   const prompts = [];
   const files = fs
     .readdirSync(PROMPTS_DIR)
@@ -152,6 +154,7 @@ function generatePromptsData() {
       tools: tools,
       path: relativePath,
       filename: file,
+      lastUpdated: gitDates.get(relativePath) || null,
     });
   }
 
@@ -207,7 +210,7 @@ function extractExtensionFromPattern(pattern) {
 /**
  * Generate instructions metadata
  */
-function generateInstructionsData() {
+function generateInstructionsData(gitDates) {
   const instructions = [];
   const files = fs
     .readdirSync(INSTRUCTIONS_DIR)
@@ -254,6 +257,7 @@ function generateInstructionsData() {
       extensions: [...new Set(extensions)],
       path: relativePath,
       filename: file,
+      lastUpdated: gitDates.get(relativePath) || null,
     });
   }
 
@@ -317,7 +321,7 @@ function categorizeSkill(name, description) {
 /**
  * Generate skills metadata
  */
-function generateSkillsData() {
+function generateSkillsData(gitDates) {
   const skills = [];
 
   if (!fs.existsSync(SKILLS_DIR)) {
@@ -344,6 +348,9 @@ function generateSkillsData() {
       // Get all files in the skill folder recursively
       const files = getSkillFiles(skillPath, relativePath);
 
+      // Get last updated from SKILL.md file
+      const skillFilePath = `${relativePath}/SKILL.md`;
+
       skills.push({
         id: folder,
         name: metadata.name,
@@ -357,8 +364,9 @@ function generateSkillsData() {
         assetCount: metadata.assets.length,
         category: category,
         path: relativePath,
-        skillFile: `${relativePath}/SKILL.md`,
+        skillFile: skillFilePath,
         files: files,
+        lastUpdated: gitDates.get(skillFilePath) || null,
       });
     }
   }
@@ -407,7 +415,7 @@ function getSkillFiles(skillPath, relativePath) {
 /**
  * Generate collections metadata
  */
-function generateCollectionsData() {
+function generateCollectionsData(gitDates) {
   const collections = [];
 
   if (!fs.existsSync(COLLECTIONS_DIR)) {
@@ -448,6 +456,7 @@ function generateCollectionsData() {
         })),
         path: relativePath,
         filename: file,
+        lastUpdated: gitDates.get(relativePath) || null,
       });
     }
   }
@@ -543,6 +552,7 @@ function generateSearchIndex(
       title: agent.title,
       description: agent.description,
       path: agent.path,
+      lastUpdated: agent.lastUpdated,
       searchText: `${agent.title} ${agent.description} ${agent.tools.join(
         " "
       )}`.toLowerCase(),
@@ -556,6 +566,7 @@ function generateSearchIndex(
       title: prompt.title,
       description: prompt.description,
       path: prompt.path,
+      lastUpdated: prompt.lastUpdated,
       searchText: `${prompt.title} ${prompt.description}`.toLowerCase(),
     });
   }
@@ -567,6 +578,7 @@ function generateSearchIndex(
       title: instruction.title,
       description: instruction.description,
       path: instruction.path,
+      lastUpdated: instruction.lastUpdated,
       searchText: `${instruction.title} ${instruction.description} ${
         instruction.applyTo || ""
       }`.toLowerCase(),
@@ -580,6 +592,7 @@ function generateSearchIndex(
       title: skill.title,
       description: skill.description,
       path: skill.skillFile,
+      lastUpdated: skill.lastUpdated,
       searchText: `${skill.title} ${skill.description}`.toLowerCase(),
     });
   }
@@ -592,6 +605,7 @@ function generateSearchIndex(
       description: collection.description,
       path: collection.path,
       tags: collection.tags,
+      lastUpdated: collection.lastUpdated,
       searchText: `${collection.name} ${
         collection.description
       } ${collection.tags.join(" ")}`.toLowerCase(),
@@ -704,32 +718,40 @@ async function main() {
 
   ensureDataDir();
 
+  // Load git dates for all resource files (single efficient git command)
+  console.log("Loading git history for last updated dates...");
+  const gitDates = getGitFileDates(
+    ["agents/", "prompts/", "instructions/", "skills/", "collections/"],
+    ROOT_FOLDER
+  );
+  console.log(`✓ Loaded dates for ${gitDates.size} files\n`);
+
   // Generate all data
-  const agentsData = generateAgentsData();
+  const agentsData = generateAgentsData(gitDates);
   const agents = agentsData.items;
   console.log(
     `✓ Generated ${agents.length} agents (${agentsData.filters.models.length} models, ${agentsData.filters.tools.length} tools)`
   );
 
-  const promptsData = generatePromptsData();
+  const promptsData = generatePromptsData(gitDates);
   const prompts = promptsData.items;
   console.log(
     `✓ Generated ${prompts.length} prompts (${promptsData.filters.tools.length} tools)`
   );
 
-  const instructionsData = generateInstructionsData();
+  const instructionsData = generateInstructionsData(gitDates);
   const instructions = instructionsData.items;
   console.log(
     `✓ Generated ${instructions.length} instructions (${instructionsData.filters.extensions.length} extensions)`
   );
 
-  const skillsData = generateSkillsData();
+  const skillsData = generateSkillsData(gitDates);
   const skills = skillsData.items;
   console.log(
     `✓ Generated ${skills.length} skills (${skillsData.filters.categories.length} categories)`
   );
 
-  const collectionsData = generateCollectionsData();
+  const collectionsData = generateCollectionsData(gitDates);
   const collections = collectionsData.items;
   console.log(
     `✓ Generated ${collections.length} collections (${collectionsData.filters.tags.length} tags)`
diff --git a/eng/utils/git-dates.mjs b/eng/utils/git-dates.mjs
new file mode 100644
index 00000000..2f359699
--- /dev/null
+++ b/eng/utils/git-dates.mjs
@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+/**
+ * Utility to extract last modification dates from git history.
+ * Uses a single git log command for efficiency.
+ */
+
+import { execSync } from "child_process";
+import path from "path";
+
+/**
+ * Get the last modification date for all tracked files in specified directories.
+ * Returns a Map of file path -> ISO date string.
+ *
+ * @param {string[]} directories - Array of directory paths to scan
+ * @param {string} rootDir - Root directory for relative paths
+ * @returns {Map<string, string>} Map of relative file path to ISO date string
+ */
+export function getGitFileDates(directories, rootDir) {
+  const fileDates = new Map();
+
+  try {
+    // Get git log with file names for all specified directories
+    // Format: ISO date, then file names that were modified in that commit
+    const gitArgs = [
+      "--no-pager",
+      "log",
+      "--format=%aI", // Author date in ISO 8601 format
+      "--name-only",
+      "--diff-filter=ACMR", // Added, Copied, Modified, Renamed
+      "--",
+      ...directories,
+    ];
+
+    const output = execSync(`git ${gitArgs.join(" ")}`, {
+      encoding: "utf8",
+      cwd: rootDir,
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+
+    // Parse the output: alternating date lines and file name lines
+    // Format is:
+    // 2026-01-15T10:30:00+00:00
+    //
+    // file1.md
+    // file2.md
+    //
+    // 2026-01-14T09:00:00+00:00
+    // ...
+
+    let currentDate = null;
+    const lines = output.split("\n");
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+
+      if (!trimmed) {
+        continue;
+      }
+
+      // Check if this is a date line (ISO 8601 format)
+      if (/^\d{4}-\d{2}-\d{2}T/.test(trimmed)) {
+        currentDate = trimmed;
+      } else if (currentDate && trimmed) {
+        // This is a file path - only set if we haven't seen this file yet
+        // (first occurrence is the most recent modification)
+        if (!fileDates.has(trimmed)) {
+          fileDates.set(trimmed, currentDate);
+        }
+      }
+    }
+  } catch (error) {
+    // Git command failed - might not be a git repo or no history
+    console.warn("Warning: Could not get git dates:", error.message);
+  }
+
+  return fileDates;
+}
+
+/**
+ * Get the last modification date for a single file.
+ *
+ * @param {string} filePath - Path to the file (relative to git root)
+ * @param {string} rootDir - Root directory
+ * @returns {string|null} ISO date string or null if not found
+ */
+export function getGitFileDate(filePath, rootDir) {
+  try {
+    const output = execSync(
+      `git --no-pager log -1 --format="%aI" -- "${filePath}"`,
+      {
+        encoding: "utf8",
+        cwd: rootDir,
+        stdio: ["pipe", "pipe", "pipe"],
+      }
+    );
+
+    const date = output.trim();
+    return date || null;
+  } catch (error) {
+    return null;
+  }
+}
diff --git a/website/public/styles/global.css b/website/public/styles/global.css
index 55d6244a..dd548fd1 100644
--- a/website/public/styles/global.css
+++ b/website/public/styles/global.css
@@ -1415,6 +1415,14 @@ a:hover {
   flex-shrink: 0;
 }
 
+/* Last Updated */
+.last-updated {
+  font-size: 12px;
+  color: var(--color-text-muted);
+  cursor: default;
+  margin-left: auto;
+}
+
 /* Collection Items */
 .collection-items {
   margin-top: 12px;
diff --git a/website/src/pages/agents.astro b/website/src/pages/agents.astro
index 172cebc3..49288b77 100644
--- a/website/src/pages/agents.astro
+++ b/website/src/pages/agents.astro
@@ -35,6 +35,13 @@ import Modal from '../components/Modal.astro';
               Has Handoffs
             </label>
           </div>
+          <div class="filter-group">
+            <label for="sort-select">Sort:</label>
+            <select id="sort-select" aria-label="Sort by">
+              <option value="title">Name (A-Z)</option>
+              <option value="lastUpdated">Recently Updated</option>
+            </select>
+          </div>
           <button id="clear-filters" class="btn btn-secondary btn-small">Clear Filters</button>
         </div>
         
diff --git a/website/src/pages/instructions.astro b/website/src/pages/instructions.astro
index e9b1f0d1..63b4ac63 100644
--- a/website/src/pages/instructions.astro
+++ b/website/src/pages/instructions.astro
@@ -24,6 +24,13 @@ import Modal from '../components/Modal.astro';
             <label for="filter-extension">File Extension:</label>
             <select id="filter-extension" multiple aria-label="Filter by file extension"></select>
           </div>
+          <div class="filter-group">
+            <label for="sort-select">Sort:</label>
+            <select id="sort-select" aria-label="Sort by">
+              <option value="title">Name (A-Z)</option>
+              <option value="lastUpdated">Recently Updated</option>
+            </select>
+          </div>
           <button id="clear-filters" class="btn btn-secondary btn-small">Clear Filters</button>
         </div>
         
diff --git a/website/src/pages/prompts.astro b/website/src/pages/prompts.astro
index 00778338..9b7b390a 100644
--- a/website/src/pages/prompts.astro
+++ b/website/src/pages/prompts.astro
@@ -24,6 +24,13 @@ import Modal from '../components/Modal.astro';
             <label for="filter-tool">Tool:</label>
             <select id="filter-tool" multiple aria-label="Filter by tool"></select>
           </div>
+          <div class="filter-group">
+            <label for="sort-select">Sort:</label>
+            <select id="sort-select" aria-label="Sort by">
+              <option value="title">Name (A-Z)</option>
+              <option value="lastUpdated">Recently Updated</option>
+            </select>
+          </div>
           <button id="clear-filters" class="btn btn-secondary btn-small">Clear Filters</button>
         </div>
         
diff --git a/website/src/pages/skills.astro b/website/src/pages/skills.astro
index af40aad1..2866ae73 100644
--- a/website/src/pages/skills.astro
+++ b/website/src/pages/skills.astro
@@ -30,6 +30,13 @@ import Modal from '../components/Modal.astro';
               Has Bundled Assets
             </label>
           </div>
+          <div class="filter-group">
+            <label for="sort-select">Sort:</label>
+            <select id="sort-select" aria-label="Sort by">
+              <option value="title">Name (A-Z)</option>
+              <option value="lastUpdated">Recently Updated</option>
+            </select>
+          </div>
           <button id="clear-filters" class="btn btn-secondary btn-small">Clear Filters</button>
         </div>
         
diff --git a/website/src/scripts/pages/agents.ts b/website/src/scripts/pages/agents.ts
index 5fd6f71b..28a822af 100644
--- a/website/src/scripts/pages/agents.ts
+++ b/website/src/scripts/pages/agents.ts
@@ -3,7 +3,7 @@
  */
 import { createChoices, getChoicesValues, type Choices } from '../choices';
 import { FuzzySearch, SearchItem } from '../search';
-import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers } from '../utils';
+import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers, getLastUpdatedHtml } from '../utils';
 import { setupModal, openFileModal } from '../modal';
 
 interface Agent extends SearchItem {
@@ -11,6 +11,7 @@ interface Agent extends SearchItem {
   model?: string;
   tools?: string[];
   hasHandoffs?: boolean;
+  lastUpdated?: string | null;
 }
 
 interface AgentsData {
@@ -21,11 +22,14 @@ interface AgentsData {
   };
 }
 
+type SortOption = 'title' | 'lastUpdated';
+
 const resourceType = 'agent';
 let allItems: Agent[] = [];
 let search = new FuzzySearch<Agent>();
 let modelSelect: Choices;
 let toolSelect: Choices;
+let currentSort: SortOption = 'title';
 
 let currentFilters = {
   models: [] as string[],
@@ -33,6 +37,19 @@ let currentFilters = {
   hasHandoffs: false,
 };
 
+function sortItems(items: Agent[]): Agent[] {
+  return [...items].sort((a, b) => {
+    if (currentSort === 'lastUpdated') {
+      // Sort by last updated (newest first), with null/undefined at end
+      const dateA = a.lastUpdated ? new Date(a.lastUpdated).getTime() : 0;
+      const dateB = b.lastUpdated ? new Date(b.lastUpdated).getTime() : 0;
+      return dateB - dateA;
+    }
+    // Default: sort by title
+    return a.title.localeCompare(b.title);
+  });
+}
+
 function applyFiltersAndRender(): void {
   const searchInput = document.getElementById('search-input') as HTMLInputElement;
   const countEl = document.getElementById('results-count');
@@ -59,6 +76,9 @@ function applyFiltersAndRender(): void {
     results = results.filter(item => item.hasHandoffs);
   }
 
+  // Apply sorting
+  results = sortItems(results);
+
   renderItems(results, query);
 
   const activeFilters: string[] = [];
@@ -97,6 +117,7 @@ function renderItems(items: Agent[], query = ''): void {
           ${item.tools?.slice(0, 3).map(t => `<span class="resource-tag">${escapeHtml(t)}</span>`).join('') || ''}
           ${item.tools && item.tools.length > 3 ? `<span class="resource-tag">+${item.tools.length - 3} more</span>` : ''}
           ${item.hasHandoffs ? `<span class="resource-tag tag-handoffs">handoffs</span>` : ''}
+          ${getLastUpdatedHtml(item.lastUpdated)}
         </div>
       </div>
       <div class="resource-actions">
@@ -123,6 +144,7 @@ export async function initAgentsPage(): Promise<void> {
   const searchInput = document.getElementById('search-input') as HTMLInputElement;
   const handoffsCheckbox = document.getElementById('filter-handoffs') as HTMLInputElement;
   const clearFiltersBtn = document.getElementById('clear-filters');
+  const sortSelect = document.getElementById('sort-select') as HTMLSelectElement;
 
   const data = await fetchData<AgentsData>('agents.json');
   if (!data || !data.items) {
@@ -149,6 +171,12 @@ export async function initAgentsPage(): Promise<void> {
     applyFiltersAndRender();
   });
 
+  // Initialize sort select
+  sortSelect?.addEventListener('change', () => {
+    currentSort = sortSelect.value as SortOption;
+    applyFiltersAndRender();
+  });
+
   applyFiltersAndRender();
 
   searchInput?.addEventListener('input', debounce(() => applyFiltersAndRender(), 200));
@@ -160,10 +188,12 @@ export async function initAgentsPage(): Promise<void> {
 
   clearFiltersBtn?.addEventListener('click', () => {
     currentFilters = { models: [], tools: [], hasHandoffs: false };
+    currentSort = 'title';
     modelSelect.removeActiveItems();
     toolSelect.removeActiveItems();
     if (handoffsCheckbox) handoffsCheckbox.checked = false;
     if (searchInput) searchInput.value = '';
+    if (sortSelect) sortSelect.value = 'title';
     applyFiltersAndRender();
   });
 
diff --git a/website/src/scripts/pages/instructions.ts b/website/src/scripts/pages/instructions.ts
index 500e1757..0501ec42 100644
--- a/website/src/scripts/pages/instructions.ts
+++ b/website/src/scripts/pages/instructions.ts
@@ -3,13 +3,14 @@
  */
 import { createChoices, getChoicesValues, type Choices } from '../choices';
 import { FuzzySearch, SearchItem } from '../search';
-import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers } from '../utils';
+import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers, getLastUpdatedHtml } from '../utils';
 import { setupModal, openFileModal } from '../modal';
 
 interface Instruction extends SearchItem {
   path: string;
   applyTo?: string;
   extensions?: string[];
+  lastUpdated?: string | null;
 }
 
 interface InstructionsData {
@@ -19,11 +20,25 @@ interface InstructionsData {
   };
 }
 
+type SortOption = 'title' | 'lastUpdated';
+
 const resourceType = 'instruction';
 let allItems: Instruction[] = [];
 let search = new FuzzySearch<Instruction>();
 let extensionSelect: Choices;
 let currentFilters = { extensions: [] as string[] };
+let currentSort: SortOption = 'title';
+
+function sortItems(items: Instruction[]): Instruction[] {
+  return [...items].sort((a, b) => {
+    if (currentSort === 'lastUpdated') {
+      const dateA = a.lastUpdated ? new Date(a.lastUpdated).getTime() : 0;
+      const dateB = b.lastUpdated ? new Date(b.lastUpdated).getTime() : 0;
+      return dateB - dateA;
+    }
+    return a.title.localeCompare(b.title);
+  });
+}
 
 function applyFiltersAndRender(): void {
   const searchInput = document.getElementById('search-input') as HTMLInputElement;
@@ -41,6 +56,8 @@ function applyFiltersAndRender(): void {
     });
   }
 
+  results = sortItems(results);
+
   renderItems(results, query);
   let countText = `${results.length} of ${allItems.length} instructions`;
   if (currentFilters.extensions.length > 0) {
@@ -67,6 +84,7 @@ function renderItems(items: Instruction[], query = ''): void {
           ${item.applyTo ? `<span class="resource-tag">applies to: ${escapeHtml(item.applyTo)}</span>` : ''}
           ${item.extensions?.slice(0, 4).map(e => `<span class="resource-tag tag-extension">${escapeHtml(e)}</span>`).join('') || ''}
           ${item.extensions && item.extensions.length > 4 ? `<span class="resource-tag">+${item.extensions.length - 4} more</span>` : ''}
+          ${getLastUpdatedHtml(item.lastUpdated)}
         </div>
       </div>
       <div class="resource-actions">
@@ -92,6 +110,7 @@ export async function initInstructionsPage(): Promise<void> {
   const list = document.getElementById('resource-list');
   const searchInput = document.getElementById('search-input') as HTMLInputElement;
   const clearFiltersBtn = document.getElementById('clear-filters');
+  const sortSelect = document.getElementById('sort-select') as HTMLSelectElement;
 
   const data = await fetchData<InstructionsData>('instructions.json');
   if (!data || !data.items) {
@@ -109,13 +128,20 @@ export async function initInstructionsPage(): Promise<void> {
     applyFiltersAndRender();
   });
 
+  sortSelect?.addEventListener('change', () => {
+    currentSort = sortSelect.value as SortOption;
+    applyFiltersAndRender();
+  });
+
   applyFiltersAndRender();
   searchInput?.addEventListener('input', debounce(() => applyFiltersAndRender(), 200));
 
   clearFiltersBtn?.addEventListener('click', () => {
     currentFilters = { extensions: [] };
+    currentSort = 'title';
     extensionSelect.removeActiveItems();
     if (searchInput) searchInput.value = '';
+    if (sortSelect) sortSelect.value = 'title';
     applyFiltersAndRender();
   });
 
diff --git a/website/src/scripts/pages/prompts.ts b/website/src/scripts/pages/prompts.ts
index e660d727..02799ad6 100644
--- a/website/src/scripts/pages/prompts.ts
+++ b/website/src/scripts/pages/prompts.ts
@@ -3,12 +3,13 @@
  */
 import { createChoices, getChoicesValues, type Choices } from '../choices';
 import { FuzzySearch, SearchItem } from '../search';
-import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers } from '../utils';
+import { fetchData, debounce, escapeHtml, getGitHubUrl, getInstallDropdownHtml, setupDropdownCloseHandlers, getActionButtonsHtml, setupActionHandlers, getLastUpdatedHtml } from '../utils';
 import { setupModal, openFileModal } from '../modal';
 
 interface Prompt extends SearchItem {
   path: string;
   tools?: string[];
+  lastUpdated?: string | null;
 }
 
 interface PromptsData {
@@ -18,11 +19,25 @@ interface PromptsData {
   };
 }
 
+type SortOption = 'title' | 'lastUpdated';
+
 const resourceType = 'prompt';
 let allItems: Prompt[] = [];
 let search = new FuzzySearch<Prompt>();
 let toolSelect: Choices;
 let currentFilters = { tools: [] as string[] };
+let currentSort: SortOption = 'title';
+
+function sortItems(items: Prompt[]): Prompt[] {
+  return [...items].sort((a, b) => {
+    if (currentSort === 'lastUpdated') {
+      const dateA = a.lastUpdated ? new Date(a.lastUpdated).getTime() : 0;
+      const dateB = b.lastUpdated ? new Date(b.lastUpdated).getTime() : 0;
+      return dateB - dateA;
+    }
+    return a.title.localeCompare(b.title);
+  });
+}
 
 function applyFiltersAndRender(): void {
   const searchInput = document.getElementById('search-input') as HTMLInputElement;
@@ -37,6 +52,8 @@ function applyFiltersAndRender(): void {
     );
   }
 
+  results = sortItems(results);
+
   renderItems(results, query);
   let countText = `${results.length} of ${allItems.length} prompts`;
   if (currentFilters.tools.length > 0) {
@@ -62,6 +79,7 @@ function renderItems(items: Prompt[], query = ''): void {
         <div class="resource-meta">
           ${item.tools?.slice(0, 4).map(t => `<span class="resource-tag">${escapeHtml(t)}</span>`).join('') || ''}
           ${item.tools && item.tools.length > 4 ? `<span class="resource-tag">+${item.tools.length - 4} more</span>` : ''}
+          ${getLastUpdatedHtml(item.lastUpdated)}
         </div>
       </div>
       <div class="resource-actions">
@@ -87,6 +105,7 @@ export async function initPromptsPage(): Promise<void> {
   const list = document.getElementById('resource-list');
   const searchInput = document.getElementById('search-input') as HTMLInputElement;
   const clearFiltersBtn = document.getElementById('clear-filters');
+  const sortSelect = document.getElementById('sort-select') as HTMLSelectElement;
 
   const data = await fetchData<PromptsData>('prompts.json');
   if (!data || !data.items) {
@@ -104,13 +123,20 @@ export async function initPromptsPage(): Promise<void> {
     applyFiltersAndRender();
   });
 
+  sortSelect?.addEventListener('change', () => {
+    currentSort = sortSelect.value as SortOption;
+    applyFiltersAndRender();
+  });
+
   applyFiltersAndRender();
   searchInput?.addEventListener('input', debounce(() => applyFiltersAndRender(), 200));
 
   clearFiltersBtn?.addEventListener('click', () => {
     currentFilters = { tools: [] };
+    currentSort = 'title';
     toolSelect.removeActiveItems();
     if (searchInput) searchInput.value = '';
+    if (sortSelect) sortSelect.value = 'title';
     applyFiltersAndRender();
   });
 
diff --git a/website/src/scripts/pages/skills.ts b/website/src/scripts/pages/skills.ts
index 9689833f..e079ff4e 100644
--- a/website/src/scripts/pages/skills.ts
+++ b/website/src/scripts/pages/skills.ts
@@ -10,6 +10,7 @@ import {
   getGitHubUrl,
   getRawGitHubUrl,
   showToast,
+  getLastUpdatedHtml,
 } from "../utils";
 import { setupModal, openFileModal } from "../modal";
 import JSZip from "../jszip";
@@ -27,6 +28,7 @@ interface Skill extends SearchItem {
   hasAssets: boolean;
   assetCount: number;
   files: SkillFile[];
+  lastUpdated?: string | null;
 }
 
 interface SkillsData {
@@ -36,6 +38,8 @@ interface SkillsData {
   };
 }
 
+type SortOption = 'title' | 'lastUpdated';
+
 const resourceType = "skill";
 let allItems: Skill[] = [];
 let search = new FuzzySearch<Skill>();
@@ -44,6 +48,18 @@ let currentFilters = {
   categories: [] as string[],
   hasAssets: false,
 };
+let currentSort: SortOption = 'title';
+
+function sortItems(items: Skill[]): Skill[] {
+  return [...items].sort((a, b) => {
+    if (currentSort === 'lastUpdated') {
+      const dateA = a.lastUpdated ? new Date(a.lastUpdated).getTime() : 0;
+      const dateB = b.lastUpdated ? new Date(b.lastUpdated).getTime() : 0;
+      return dateB - dateA;
+    }
+    return a.title.localeCompare(b.title);
+  });
+}
 
 function applyFiltersAndRender(): void {
   const searchInput = document.getElementById(
@@ -63,6 +79,8 @@ function applyFiltersAndRender(): void {
     results = results.filter((item) => item.hasAssets);
   }
 
+  results = sortItems(results);
+
   renderItems(results, query);
   const activeFilters: string[] = [];
   if (currentFilters.categories.length > 0)
@@ -116,6 +134,7 @@ function renderItems(items: Skill[], query = ""): void {
           <span class="resource-tag">${item.files.length} file${
         item.files.length === 1 ? "" : "s"
       }</span>
+          ${getLastUpdatedHtml(item.lastUpdated)}
         </div>
       </div>
       <div class="resource-actions">
@@ -236,6 +255,7 @@ export async function initSkillsPage(): Promise<void> {
     "filter-has-assets"
   ) as HTMLInputElement;
   const clearFiltersBtn = document.getElementById("clear-filters");
+  const sortSelect = document.getElementById("sort-select") as HTMLSelectElement;
 
   const data = await fetchData<SkillsData>("skills.json");
   if (!data || !data.items) {
@@ -262,6 +282,11 @@ export async function initSkillsPage(): Promise<void> {
     applyFiltersAndRender();
   });
 
+  sortSelect?.addEventListener("change", () => {
+    currentSort = sortSelect.value as SortOption;
+    applyFiltersAndRender();
+  });
+
   applyFiltersAndRender();
   searchInput?.addEventListener(
     "input",
@@ -275,9 +300,11 @@ export async function initSkillsPage(): Promise<void> {
 
   clearFiltersBtn?.addEventListener("click", () => {
     currentFilters = { categories: [], hasAssets: false };
+    currentSort = 'title';
     categorySelect.removeActiveItems();
     if (hasAssetsCheckbox) hasAssetsCheckbox.checked = false;
     if (searchInput) searchInput.value = "";
+    if (sortSelect) sortSelect.value = "title";
     applyFiltersAndRender();
   });
 
diff --git a/website/src/scripts/utils.ts b/website/src/scripts/utils.ts
index 479c7082..4e381020 100644
--- a/website/src/scripts/utils.ts
+++ b/website/src/scripts/utils.ts
@@ -429,3 +429,75 @@ export function setupActionHandlers(): void {
 
 let dropdownHandlersReady = false;
 let actionHandlersReady = false;
+
+/**
+ * Format a date as relative time (e.g., "3 days ago")
+ * @param isoDate - ISO 8601 date string
+ * @returns Relative time string
+ */
+export function formatRelativeTime(isoDate: string | null | undefined): string {
+  if (!isoDate) return "Unknown";
+
+  const date = new Date(isoDate);
+  if (isNaN(date.getTime())) return "Unknown";
+
+  const now = new Date();
+  const diffMs = now.getTime() - date.getTime();
+  const diffSeconds = Math.floor(diffMs / 1000);
+  const diffMinutes = Math.floor(diffSeconds / 60);
+  const diffHours = Math.floor(diffMinutes / 60);
+  const diffDays = Math.floor(diffHours / 24);
+  const diffWeeks = Math.floor(diffDays / 7);
+  const diffMonths = Math.floor(diffDays / 30);
+  const diffYears = Math.floor(diffDays / 365);
+
+  if (diffDays === 0) {
+    if (diffHours === 0) {
+      if (diffMinutes === 0) return "just now";
+      return diffMinutes === 1 ? "1 minute ago" : `${diffMinutes} minutes ago`;
+    }
+    return diffHours === 1 ? "1 hour ago" : `${diffHours} hours ago`;
+  }
+  if (diffDays === 1) return "yesterday";
+  if (diffDays < 7) return `${diffDays} days ago`;
+  if (diffWeeks === 1) return "1 week ago";
+  if (diffWeeks < 4) return `${diffWeeks} weeks ago`;
+  if (diffMonths === 1) return "1 month ago";
+  if (diffMonths < 12) return `${diffMonths} months ago`;
+  if (diffYears === 1) return "1 year ago";
+  return `${diffYears} years ago`;
+}
+
+/**
+ * Format a date for display (e.g., "January 15, 2026")
+ * @param isoDate - ISO 8601 date string
+ * @returns Formatted date string
+ */
+export function formatFullDate(isoDate: string | null | undefined): string {
+  if (!isoDate) return "Unknown";
+
+  const date = new Date(isoDate);
+  if (isNaN(date.getTime())) return "Unknown";
+
+  return date.toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+  });
+}
+
+/**
+ * Generate HTML for displaying last updated time with hover tooltip
+ * @param isoDate - ISO 8601 date string
+ * @returns HTML string with relative time and title attribute
+ */
+export function getLastUpdatedHtml(isoDate: string | null | undefined): string {
+  const relativeTime = formatRelativeTime(isoDate);
+  const fullDate = formatFullDate(isoDate);
+
+  if (relativeTime === "Unknown") {
+    return `<span class="last-updated">Updated: Unknown</span>`;
+  }
+
+  return `<span class="last-updated" title="${escapeHtml(fullDate)}">Updated ${relativeTime}</span>`;
+}

From 7300b8ccff338a2701ef8c536041b080faba7f70 Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 12:33:58 +1100
Subject: [PATCH 21/49] chore: Add dateA, dateB to codespell ignore list

These are valid variable names used in sorting comparison functions
for the last updated date feature.
---
 .codespellrc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.codespellrc b/.codespellrc
index 7f9b3fa8..39d8ab1d 100644
--- a/.codespellrc
+++ b/.codespellrc
@@ -11,6 +11,7 @@
 # categor - TypeScript template literal in website/src/scripts/pages/skills.ts:70 (categor${...length > 1 ? "ies" : "y"})
 # aline - proper name (Aline Ávila, contributor)
 # ative - part of "Declarative Agents" in TypeSpec M365 Copilot documentation (collections/typespec-m365-copilot.collection.md)
-ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques
+# dateA, dateB - variable names used in sorting comparison functions
+ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques,dateA,dateB
 # Skip certain files and directories
 skip = .git,node_modules,package-lock.json,*.lock,website/build,website/.docusaurus

From fbc72656ab86cb59fcf2fa1de345f7264b062f62 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 3 Feb 2026 01:35:13 +0000
Subject: [PATCH 22/49] Add llms.txt file generation script and output

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 eng/generate-llms-txt.mjs | 248 ++++++++++++++++++
 llms.txt                  | 527 ++++++++++++++++++++++++++++++++++++++
 package.json              |   3 +-
 3 files changed, 777 insertions(+), 1 deletion(-)
 create mode 100644 eng/generate-llms-txt.mjs
 create mode 100644 llms.txt

diff --git a/eng/generate-llms-txt.mjs b/eng/generate-llms-txt.mjs
new file mode 100644
index 00000000..ffa5cb62
--- /dev/null
+++ b/eng/generate-llms-txt.mjs
@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+
+import fs from "fs";
+import path from "path";
+import {
+  AGENTS_DIR,
+  INSTRUCTIONS_DIR,
+  PROMPTS_DIR,
+  SKILLS_DIR,
+  ROOT_FOLDER,
+} from "./constants.mjs";
+import { parseFrontmatter, parseSkillMetadata } from "./yaml-parser.mjs";
+
+/**
+ * Extracts the name from a file based on its frontmatter or filename
+ * @param {string} filePath - Path to the file (or directory for skills)
+ * @param {string} fileType - Type of file (agent, prompt, instruction, skill)
+ * @returns {string} - The name of the resource
+ */
+function extractName(filePath, fileType) {
+  try {
+    if (fileType === "skill") {
+      // For skills, filePath is the skill directory
+      const skillMetadata = parseSkillMetadata(filePath);
+      return skillMetadata?.name || path.basename(filePath);
+    }
+
+    const frontmatter = parseFrontmatter(filePath);
+    if (frontmatter?.name) {
+      return frontmatter.name;
+    }
+
+    // Fallback to filename
+    const basename = path.basename(filePath, path.extname(filePath));
+    return basename
+      .replace(/\.(agent|prompt|instructions)$/, "")
+      .replace(/[-_]/g, " ")
+      .replace(/\b\w/g, (l) => l.toUpperCase());
+  } catch (error) {
+    console.error(`Error extracting name from ${filePath}: ${error.message}`);
+    const basename = path.basename(filePath, path.extname(filePath));
+    return basename.replace(/[-_]/g, " ");
+  }
+}
+
+/**
+ * Extracts the description from a file's frontmatter
+ * @param {string} filePath - Path to the file (or directory for skills)
+ * @param {string} fileType - Type of file (agent, prompt, instruction, skill)
+ * @returns {string} - The description of the resource
+ */
+function extractDescription(filePath, fileType) {
+  try {
+    if (fileType === "skill") {
+      // For skills, filePath is the skill directory
+      const skillMetadata = parseSkillMetadata(filePath);
+      return skillMetadata?.description || "No description available";
+    }
+
+    const frontmatter = parseFrontmatter(filePath);
+    return frontmatter?.description || "No description available";
+  } catch (error) {
+    console.error(
+      `Error extracting description from ${filePath}: ${error.message}`
+    );
+    return "No description available";
+  }
+}
+
+/**
+ * Gets the relative URL path for a resource
+ * @param {string} filePath - Full path to the file
+ * @param {string} baseDir - Base directory to calculate relative path from
+ * @returns {string} - Relative URL path
+ */
+function getRelativeUrl(filePath, baseDir) {
+  const relativePath = path.relative(ROOT_FOLDER, filePath);
+  return relativePath.replace(/\\/g, "/");
+}
+
+/**
+ * Generates llms.txt content according to the llmstxt.org specification
+ * @returns {string} - The llms.txt file content
+ */
+function generateLlmsTxt() {
+  let content = "";
+
+  // H1 header (required)
+  content += "# Awesome GitHub Copilot\n\n";
+
+  // Summary blockquote (optional but recommended)
+  content +=
+    "> A community-driven collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot experiences across various domains, languages, and use cases.\n\n";
+
+  // Add overview section
+  content += "## Overview\n\n";
+  content +=
+    "This repository provides resources to customize and enhance GitHub Copilot:\n\n";
+  content +=
+    "- **Agents**: Specialized GitHub Copilot agents that integrate with MCP servers\n";
+  content +=
+    "- **Prompts**: Task-specific prompts for code generation and problem-solving\n";
+  content +=
+    "- **Instructions**: Coding standards and best practices applied to specific file patterns\n";
+  content +=
+    "- **Skills**: Self-contained folders with instructions and bundled resources for specialized tasks\n\n";
+
+  // Process Agents
+  content += "## Agents\n\n";
+  const agentFiles = fs
+    .readdirSync(AGENTS_DIR)
+    .filter((file) => file.endsWith(".agent.md"))
+    .sort();
+
+  agentFiles.forEach((file) => {
+    const filePath = path.join(AGENTS_DIR, file);
+    const name = extractName(filePath, "agent");
+    const description = extractDescription(filePath, "agent");
+    const url = getRelativeUrl(filePath, ROOT_FOLDER);
+
+    content += `- [${name}](${url}): ${description}\n`;
+  });
+
+  content += "\n";
+
+  // Process Prompts
+  content += "## Prompts\n\n";
+  const promptFiles = fs
+    .readdirSync(PROMPTS_DIR)
+    .filter((file) => file.endsWith(".prompt.md"))
+    .sort();
+
+  promptFiles.forEach((file) => {
+    const filePath = path.join(PROMPTS_DIR, file);
+    const name = extractName(filePath, "prompt");
+    const description = extractDescription(filePath, "prompt");
+    const url = getRelativeUrl(filePath, ROOT_FOLDER);
+
+    content += `- [${name}](${url}): ${description}\n`;
+  });
+
+  content += "\n";
+
+  // Process Instructions
+  content += "## Instructions\n\n";
+  const instructionFiles = fs
+    .readdirSync(INSTRUCTIONS_DIR)
+    .filter((file) => file.endsWith(".instructions.md"))
+    .sort();
+
+  instructionFiles.forEach((file) => {
+    const filePath = path.join(INSTRUCTIONS_DIR, file);
+    const name = extractName(filePath, "instruction");
+    const description = extractDescription(filePath, "instruction");
+    const url = getRelativeUrl(filePath, ROOT_FOLDER);
+
+    content += `- [${name}](${url}): ${description}\n`;
+  });
+
+  content += "\n";
+
+  // Process Skills
+  content += "## Skills\n\n";
+  const skillDirs = fs
+    .readdirSync(SKILLS_DIR)
+    .filter((item) => {
+      const itemPath = path.join(SKILLS_DIR, item);
+      return fs.statSync(itemPath).isDirectory();
+    })
+    .sort();
+
+  skillDirs.forEach((dir) => {
+    const skillDirPath = path.join(SKILLS_DIR, dir);
+    const skillPath = path.join(skillDirPath, "SKILL.md");
+    
+    if (fs.existsSync(skillPath)) {
+      const name = extractName(skillDirPath, "skill");
+      const description = extractDescription(skillDirPath, "skill");
+      const url = getRelativeUrl(skillDirPath, ROOT_FOLDER);
+
+      content += `- [${name}](${url}): ${description}\n`;
+    }
+  });
+
+  content += "\n";
+
+  // Add documentation links
+  content += "## Documentation\n\n";
+  content +=
+    "- [README.md](README.md): Main documentation and getting started guide\n";
+  content +=
+    "- [CONTRIBUTING.md](CONTRIBUTING.md): Guidelines for contributing to this repository\n";
+  content +=
+    "- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): Community standards and expectations\n";
+  content += "- [SECURITY.md](SECURITY.md): Security policies and reporting\n";
+  content += "- [AGENTS.md](AGENTS.md): Project overview and setup commands\n\n";
+
+  // Add repository information
+  content += "## Repository\n\n";
+  content +=
+    "- **GitHub**: https://github.com/github/awesome-copilot\n";
+  content += "- **License**: MIT\n";
+  content +=
+    "- **Website**: https://github.github.io/awesome-copilot\n";
+
+  return content;
+}
+
+/**
+ * Main function to generate and write the llms.txt file
+ */
+function main() {
+  console.log("Generating llms.txt file...");
+
+  try {
+    const content = generateLlmsTxt();
+    const outputPath = path.join(ROOT_FOLDER, "llms.txt");
+
+    fs.writeFileSync(outputPath, content, "utf8");
+
+    console.log(`✓ llms.txt generated successfully at ${outputPath}`);
+
+    // Count resources
+    const lines = content.split("\n");
+    const agentCount = lines.filter((l) =>
+      l.startsWith("- [") && l.includes("agents/")
+    ).length;
+    const promptCount = lines.filter((l) =>
+      l.startsWith("- [") && l.includes("prompts/")
+    ).length;
+    const instructionCount = lines.filter((l) =>
+      l.startsWith("- [") && l.includes("instructions/")
+    ).length;
+    const skillCount = lines.filter((l) =>
+      l.startsWith("- [") && l.includes("skills/")
+    ).length;
+
+    console.log(`  - ${agentCount} agents`);
+    console.log(`  - ${promptCount} prompts`);
+    console.log(`  - ${instructionCount} instructions`);
+    console.log(`  - ${skillCount} skills`);
+  } catch (error) {
+    console.error(`Error generating llms.txt: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+main();
diff --git a/llms.txt b/llms.txt
new file mode 100644
index 00000000..e91134f0
--- /dev/null
+++ b/llms.txt
@@ -0,0 +1,527 @@
+# Awesome GitHub Copilot
+
+> A community-driven collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot experiences across various domains, languages, and use cases.
+
+## Overview
+
+This repository provides resources to customize and enhance GitHub Copilot:
+
+- **Agents**: Specialized GitHub Copilot agents that integrate with MCP servers
+- **Prompts**: Task-specific prompts for code generation and problem-solving
+- **Instructions**: Coding standards and best practices applied to specific file patterns
+- **Skills**: Self-contained folders with instructions and bundled resources for specialized tasks
+
+## Agents
+
+- [4.1 Beast Mode v3.1](agents/4.1-Beast.agent.md): GPT 4.1 as a top-notch coding agent.
+- [C# Expert](agents/CSharpExpert.agent.md): An agent designed to assist with software development tasks for .NET projects.
+- [Thinking Beast Mode](agents/Thinking-Beast-Mode.agent.md): A transcendent coding agent with quantum cognitive architecture, adversarial intelligence, and unrestricted creative freedom.
+- [Ultimate Transparent Thinking Beast Mode](agents/Ultimate-Transparent-Thinking-Beast-Mode.agent.md): Ultimate Transparent Thinking Beast Mode
+- [WinForms Expert](agents/WinFormsExpert.agent.md): Support development of .NET (OOP) WinForms Designer compatible Apps.
+- [Accessibility](agents/accessibility.agent.md): Expert assistant for web accessibility (WCAG 2.1/2.2), inclusive UX, and a11y testing
+- [Address Comments](agents/address-comments.agent.md): Address PR comments
+- [ADR Generator](agents/adr-generator.agent.md): Expert agent for creating comprehensive Architectural Decision Records (ADRs) with structured formatting optimized for AI consumption and human readability.
+- [Aem Frontend Specialist](agents/aem-frontend-specialist.agent.md): Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration
+- [Amplitude Experiment Implementation](agents/amplitude-experiment-implementation.agent.md): This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features.
+- [Api Architect](agents/api-architect.agent.md): Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code.
+- [apify-integration-expert](agents/apify-integration-expert.agent.md): Expert agent for integrating Apify Actors into codebases. Handles Actor selection, workflow design, implementation across JavaScript/TypeScript and Python, testing, and production-ready deployment.
+- [Arch Linux Expert](agents/arch-linux-expert.agent.md): Arch Linux specialist focused on pacman, rolling-release maintenance, and Arch-centric system administration workflows.
+- [Senior Cloud Architect](agents/arch.agent.md): Expert in modern architecture design patterns, NFR requirements, and creating comprehensive architectural diagrams and documentation
+- [arm-migration-agent](agents/arm-migration.agent.md): Arm Cloud Migration Assistant accelerates moving x86 workloads to Arm infrastructure. It scans the repository for architecture assumptions, portability issues, container base image and dependency incompatibilities, and recommends Arm-optimized changes. It can drive multi-arch container builds, validate performance, and guide optimization, enabling smooth cross-platform deployment directly inside GitHub.
+- [Atlassian Requirements To Jira](agents/atlassian-requirements-to-jira.agent.md): Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow.
+- [azure-iac-exporter](agents/azure-iac-exporter.agent.md): Export existing Azure resources to Infrastructure as Code templates via Azure Resource Graph analysis, Azure Resource Manager API calls, and azure-iac-generator integration. Use this skill when the user asks to export, convert, migrate, or extract existing Azure resources to IaC templates (Bicep, ARM Templates, Terraform, Pulumi).
+- [azure-iac-generator](agents/azure-iac-generator.agent.md): Central hub for generating Infrastructure as Code (Bicep, ARM, Terraform, Pulumi) with format-specific validation and best practices. Use this skill when the user asks to generate, create, write, or build infrastructure code, deployment code, or IaC templates in any format (Bicep, ARM Templates, Terraform, Pulumi).
+- [Azure Logic Apps Expert Mode](agents/azure-logic-apps-expert.agent.md): Expert guidance for Azure Logic Apps development focusing on workflow design, integration patterns, and JSON-based Workflow Definition Language.
+- [Azure Principal Architect mode instructions](agents/azure-principal-architect.agent.md): Provide expert Azure Principal Architect guidance using Azure Well-Architected Framework principles and Microsoft best practices.
+- [Azure SaaS Architect mode instructions](agents/azure-saas-architect.agent.md): Provide expert Azure SaaS Architect guidance focusing on multitenant applications using Azure Well-Architected SaaS principles and Microsoft best practices.
+- [Azure AVM Bicep mode](agents/azure-verified-modules-bicep.agent.md): Create, update, or review Azure IaC in Bicep using Azure Verified Modules (AVM).
+- [Azure AVM Terraform mode](agents/azure-verified-modules-terraform.agent.md): Create, update, or review Azure IaC in Terraform using Azure Verified Modules (AVM).
+- [Bicep Implement](agents/bicep-implement.agent.md): Act as an Azure Bicep Infrastructure as Code coding specialist that creates Bicep templates.
+- [Bicep Plan](agents/bicep-plan.agent.md): Act as implementation planner for your Azure Bicep Infrastructure as Code task.
+- [Blueprint Mode Codex](agents/blueprint-mode-codex.agent.md): Executes structured workflows with strict correctness and maintainability. Enforces a minimal tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling.
+- [Blueprint Mode](agents/blueprint-mode.agent.md): Executes structured workflows (Debug, Express, Main, Loop) with strict correctness and maintainability. Enforces an improved tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling.
+- [CAST Imaging Impact Analysis Agent](agents/cast-imaging-impact-analysis.agent.md): Specialized agent for comprehensive change impact assessment and risk analysis in software systems using CAST Imaging
+- [CAST Imaging Software Discovery Agent](agents/cast-imaging-software-discovery.agent.md): Specialized agent for comprehensive software application discovery and architectural mapping through static code analysis using CAST Imaging
+- [CAST Imaging Structural Quality Advisor Agent](agents/cast-imaging-structural-quality-advisor.agent.md): Specialized agent for identifying, analyzing, and providing remediation guidance for code quality issues using CAST Imaging
+- [CentOS Linux Expert](agents/centos-linux-expert.agent.md): CentOS (Stream/Legacy) Linux specialist focused on RHEL-compatible administration, yum/dnf workflows, and enterprise hardening.
+- [Clojure Interactive Programming](agents/clojure-interactive-programming.agent.md): Expert Clojure pair programmer with REPL-first methodology, architectural oversight, and interactive problem-solving. Enforces quality standards, prevents workarounds, and develops solutions incrementally through live REPL evaluation before file modifications.
+- [VSCode Tour Expert](agents/code-tour.agent.md): Expert agent for creating and maintaining VSCode CodeTour files with comprehensive schema support and best practices
+- [Comet Opik](agents/comet-opik.agent.md): Unified Comet Opik agent for instrumenting LLM apps, managing prompts/projects, auditing prompts, and investigating traces/metrics via the latest Opik MCP server.
+- [Context7-Expert](agents/context7.agent.md): Expert in latest library versions, best practices, and correct syntax using up-to-date documentation
+- [Critical Thinking](agents/critical-thinking.agent.md): Challenge assumptions and encourage critical thinking to ensure the best possible solution and outcomes.
+- [Csharp Dotnet Janitor](agents/csharp-dotnet-janitor.agent.md): Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.
+- [C# MCP Server Expert](agents/csharp-mcp-expert.agent.md): Expert assistant for developing Model Context Protocol (MCP) servers in C#
+- [Custom Agent Foundry](agents/custom-agent-foundry.agent.md): Expert at designing and creating VS Code custom agents with optimal configurations
+- [Debian Linux Expert](agents/debian-linux-expert.agent.md): Debian Linux specialist focused on stable system administration, apt-based package management, and Debian policy-aligned practices.
+- [Debug](agents/debug.agent.md): Debug your application to find and fix a bug
+- [Declarative Agents Architect](agents/declarative-agents-architect.agent.md): No description available
+- [Demonstrate Understanding](agents/demonstrate-understanding.agent.md): Validate user understanding of code, design patterns, and implementation details through guided questioning.
+- [Devils Advocate](agents/devils-advocate.agent.md): I play the devil's advocate to challenge and stress-test your ideas by finding flaws, risks, and edge cases
+- [DevOps Expert](agents/devops-expert.agent.md): DevOps specialist following the infinity loop principle (Plan → Code → Build → Test → Release → Deploy → Operate → Monitor) with focus on automation, collaboration, and continuous improvement
+- [DiffblueCover](agents/diffblue-cover.agent.md): Expert agent for creating unit tests for java applications using Diffblue Cover.
+- [MAUI Expert](agents/dotnet-maui.agent.md): Support development of .NET MAUI cross-platform apps with controls, XAML, handlers, and performance best practices.
+- [Dotnet Upgrade](agents/dotnet-upgrade.agent.md): Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.
+- [droid](agents/droid.agent.md): Provides installation guidance, usage examples, and automation patterns for the Droid CLI, with emphasis on droid exec for CI/CD and non-interactive automation
+- [Drupal Expert](agents/drupal-expert.agent.md): Expert assistant for Drupal development, architecture, and best practices using PHP 8.3+ and modern Drupal patterns
+- [Dynatrace Expert](agents/dynatrace-expert.agent.md): The Dynatrace Expert Agent integrates observability and security capabilities directly into GitHub workflows, enabling development teams to investigate incidents, validate deployments, triage errors, detect performance regressions, validate releases, and manage security vulnerabilities by autonomously analysing traces, logs, and Dynatrace findings. This enables targeted and precise remediation of identified issues directly within the repository.
+- [elasticsearch-agent](agents/elasticsearch-observability.agent.md): Our expert AI assistant for debugging code (O11y), optimizing vector search (RAG), and remediating security threats using live Elastic data.
+- [Electron Code Review Mode Instructions](agents/electron-angular-native.agent.md): Code Review Mode tailored for Electron app with Node.js backend (main), Angular frontend (render), and native integration layer (e.g., AppleScript, shell, or native tooling). Services in other repos are not reviewed here.
+- [Expert Cpp Software Engineer](agents/expert-cpp-software-engineer.agent.md): Provide expert C++ software engineering guidance using modern C++ and industry best practices.
+- [Expert .NET software engineer mode instructions](agents/expert-dotnet-software-engineer.agent.md): Provide expert .NET software engineering guidance using modern software design patterns.
+- [Expert Nextjs Developer](agents/expert-nextjs-developer.agent.md): Expert Next.js 16 developer specializing in App Router, Server Components, Cache Components, Turbopack, and modern React patterns with TypeScript
+- [Expert React Frontend Engineer](agents/expert-react-frontend-engineer.agent.md): Expert React 19.2 frontend engineer specializing in modern hooks, Server Components, Actions, TypeScript, and performance optimization
+- [Fedora Linux Expert](agents/fedora-linux-expert.agent.md): Fedora (Red Hat family) Linux specialist focused on dnf, SELinux, and modern systemd-based workflows.
+- [Gilfoyle](agents/gilfoyle.agent.md): Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code.
+- [GitHub Actions Expert](agents/github-actions-expert.agent.md): GitHub Actions specialist focused on secure CI/CD workflows, action pinning, OIDC authentication, permissions least privilege, and supply-chain security
+- [Go MCP Server Development Expert](agents/go-mcp-expert.agent.md): Expert assistant for building Model Context Protocol (MCP) servers in Go using the official SDK.
+- [GPT 5 Beast Mode](agents/gpt-5-beast-mode.agent.md): Beast Mode 2.0: A powerful autonomous agent tuned specifically for GPT-5 that can solve complex problems by using tools, conducting research, and iterating until the problem is fully resolved.
+- [Hlbpa](agents/hlbpa.agent.md): Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing.
+- [Implementation Plan Generation Mode](agents/implementation-plan.agent.md): Generate an implementation plan for new features or refactoring existing code.
+- [Janitor](agents/janitor.agent.md): Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation.
+- [Java MCP Expert](agents/java-mcp-expert.agent.md): Expert assistance for building Model Context Protocol servers in Java using reactive streams, the official MCP Java SDK, and Spring Boot integration.
+- [JFrog Security Agent](agents/jfrog-sec.agent.md): The dedicated Application Security agent for automated security remediation. Verifies package and version compliance, and suggests vulnerability fixes using JFrog security intelligence.
+- [Kotlin MCP Server Development Expert](agents/kotlin-mcp-expert.agent.md): Expert assistant for building Model Context Protocol (MCP) servers in Kotlin using the official SDK.
+- [Kusto Assistant](agents/kusto-assistant.agent.md): Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server
+- [Laravel Expert Agent](agents/laravel-expert-agent.agent.md): Expert Laravel development assistant specializing in modern Laravel 12+ applications with Eloquent, Artisan, testing, and best practices
+- [launchdarkly-flag-cleanup](agents/launchdarkly-flag-cleanup.agent.md): A specialized GitHub Copilot agent that uses the LaunchDarkly MCP server to safely automate feature flag cleanup workflows. This agent determines removal readiness, identifies the correct forward value, and creates PRs that preserve production behavior while removing obsolete flags and updating stale defaults.
+- [Lingo.dev Localization (i18n) Agent](agents/lingodotdev-i18n.agent.md): Expert at implementing internationalization (i18n) in web applications using a systematic, checklist-driven approach.
+- [MCP M365 Agent Expert](agents/mcp-m365-agent-expert.agent.md): Expert assistant for building MCP-based declarative agents for Microsoft 365 Copilot with Model Context Protocol integration
+- [Mentor](agents/mentor.agent.md): Help mentor the engineer by providing guidance and support.
+- [Meta Agentic Project Scaffold](agents/meta-agentic-project-scaffold.agent.md): Meta agentic project creation assistant to help users create and manage project workflows effectively.
+- [Microsoft Agent Framework Dotnet](agents/microsoft-agent-framework-dotnet.agent.md): Create, update, refactor, explain or work with code using the .NET version of Microsoft Agent Framework.
+- [Microsoft Agent Framework Python](agents/microsoft-agent-framework-python.agent.md): Create, update, refactor, explain or work with code using the Python version of Microsoft Agent Framework.
+- [Microsoft Study Mode](agents/microsoft-study-mode.agent.md): Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers.
+- [Microsoft Learn Contributor](agents/microsoft_learn_contributor.agent.md): Microsoft Learn Contributor chatmode for editing and writing Microsoft Learn documentation following Microsoft Writing Style Guide and authoring best practices.
+- [Modernization](agents/modernization.agent.md): Human-in-the-loop modernization assistant for analyzing, documenting, and planning complete project modernization with architectural recommendations.
+- [Monday Bug Context Fixer](agents/monday-bug-fixer.agent.md): Elite bug-fixing agent that enriches task context from Monday.com platform data. Gathers related items, docs, comments, epics, and requirements to deliver production-quality fixes with comprehensive PRs.
+- [mongodb-performance-advisor](agents/mongodb-performance-advisor.agent.md): Analyze MongoDB database performance, offer query and index optimization insights and provide actionable recommendations to improve overall usage of the database.
+- [MS-SQL Database Administrator](agents/ms-sql-dba.agent.md): Work with Microsoft SQL Server databases using the MS SQL extension.
+- [neo4j-docker-client-generator](agents/neo4j-docker-client-generator.agent.md): AI agent that generates simple, high-quality Python Neo4j client libraries from GitHub issues with proper best practices
+- [Neon Migration Specialist](agents/neon-migration-specialist.agent.md): Safe Postgres migrations with zero-downtime using Neon's branching workflow. Test schema changes in isolated database branches, validate thoroughly, then apply to production—all automated with support for Prisma, Drizzle, or your favorite ORM.
+- [Neon Performance Analyzer](agents/neon-optimization-analyzer.agent.md): Identify and fix slow Postgres queries automatically using Neon's branching workflow. Analyzes execution plans, tests optimizations in isolated database branches, and provides clear before/after performance metrics with actionable code fixes.
+- [octopus-release-notes-with-mcp](agents/octopus-deploy-release-notes-mcp.agent.md): Generate release notes for a release in Octopus Deploy. The tools for this MCP server provide access to the Octopus Deploy APIs.
+- [OpenAPI to Application Generator](agents/openapi-to-application.agent.md): Expert assistant for generating working applications from OpenAPI specifications
+- [PagerDuty Incident Responder](agents/pagerduty-incident-responder.agent.md): Responds to PagerDuty incidents by analyzing incident context, identifying recent code changes, and suggesting fixes via GitHub PRs.
+- [PHP MCP Expert](agents/php-mcp-expert.agent.md): Expert assistant for PHP MCP server development using the official PHP SDK with attribute-based discovery
+- [Pimcore Expert](agents/pimcore-expert.agent.md): Expert Pimcore development assistant specializing in CMS, DAM, PIM, and E-Commerce solutions with Symfony integration
+- [Plan Mode - Strategic Planning & Architecture](agents/plan.agent.md): Strategic planning and architecture assistant focused on thoughtful analysis before implementation. Helps developers understand codebases, clarify requirements, and develop comprehensive implementation strategies.
+- [Planning mode instructions](agents/planner.agent.md): Generate an implementation plan for new features or refactoring existing code.
+- [Platform SRE for Kubernetes](agents/platform-sre-kubernetes.agent.md): SRE-focused Kubernetes specialist prioritizing reliability, safe rollouts/rollbacks, security defaults, and operational verification for production-grade deployments
+- [Playwright Tester Mode](agents/playwright-tester.agent.md): Testing mode for Playwright tests
+- [PostgreSQL Database Administrator](agents/postgresql-dba.agent.md): Work with PostgreSQL databases using the PostgreSQL extension.
+- [Power BI Data Modeling Expert Mode](agents/power-bi-data-modeling-expert.agent.md): Expert Power BI data modeling guidance using star schema principles, relationship design, and Microsoft best practices for optimal model performance and usability.
+- [Power BI DAX Expert Mode](agents/power-bi-dax-expert.agent.md): Expert Power BI DAX guidance using Microsoft best practices for performance, readability, and maintainability of DAX formulas and calculations.
+- [Power BI Performance Expert Mode](agents/power-bi-performance-expert.agent.md): Expert Power BI performance optimization guidance for troubleshooting, monitoring, and improving the performance of Power BI models, reports, and queries.
+- [Power BI Visualization Expert Mode](agents/power-bi-visualization-expert.agent.md): Expert Power BI report design and visualization guidance using Microsoft best practices for creating effective, performant, and user-friendly reports and dashboards.
+- [Power Platform Expert](agents/power-platform-expert.agent.md): Power Platform expert providing guidance on Code Apps, canvas apps, Dataverse, connectors, and Power Platform best practices
+- [Power Platform MCP Integration Expert](agents/power-platform-mcp-integration-expert.agent.md): Expert in Power Platform custom connector development with MCP integration for Copilot Studio - comprehensive knowledge of schemas, protocols, and integration patterns
+- [Create PRD Chat Mode](agents/prd.agent.md): Generate a comprehensive Product Requirements Document (PRD) in Markdown, detailing user stories, acceptance criteria, technical considerations, and metrics. Optionally create GitHub issues upon user confirmation.
+- [Principal Software Engineer](agents/principal-software-engineer.agent.md): Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation.
+- [Prompt Builder](agents/prompt-builder.agent.md): Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai
+- [Prompt Engineer](agents/prompt-engineer.agent.md): A specialized chat mode for analyzing and improving prompts. Every user input is treated as a prompt to be improved. It first provides a detailed analysis of the original prompt within a <reasoning> tag, evaluating it against a systematic framework based on OpenAI's prompt engineering best practices. Following the analysis, it generates a new, improved prompt.
+- [Python MCP Server Expert](agents/python-mcp-expert.agent.md): Expert assistant for developing Model Context Protocol (MCP) servers in Python
+- [Refine Issue](agents/refine-issue.agent.md): Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs
+- [Repo Architect](agents/repo-architect.agent.md): Bootstraps and validates agentic project structures for GitHub Copilot (VS Code) and OpenCode CLI workflows. Run after `opencode /init` or VS Code Copilot initialization to scaffold proper folder hierarchies, instructions, agents, skills, and prompts.
+- [Technical spike research mode](agents/research-technical-spike.agent.md): Systematically research and validate technical spike documents through exhaustive investigation and controlled experimentation.
+- [Ruby MCP Expert](agents/ruby-mcp-expert.agent.md): Expert assistance for building Model Context Protocol servers in Ruby using the official MCP Ruby SDK gem with Rails integration.
+- [Rust Beast Mode](agents/rust-gpt-4.1-beast-mode.agent.md): Rust GPT-4.1 Coding Beast Mode for VS Code
+- [Rust MCP Expert](agents/rust-mcp-expert.agent.md): Expert assistant for Rust MCP server development using the rmcp SDK with tokio async runtime
+- [Salesforce Expert Agent](agents/salesforce-expert.agent.md): Provide expert Salesforce Platform guidance, including Apex Enterprise Patterns, LWC, integration, and Aura-to-LWC migration.
+- [SE: DevOps/CI](agents/se-gitops-ci-specialist.agent.md): DevOps specialist for CI/CD pipelines, deployment debugging, and GitOps workflows focused on making deployments boring and reliable
+- [SE: Product Manager](agents/se-product-manager-advisor.agent.md): Product management guidance for creating GitHub issues, aligning business value with user needs, and making data-driven product decisions
+- [SE: Responsible AI](agents/se-responsible-ai-code.agent.md): Responsible AI specialist ensuring AI works for everyone through bias prevention, accessibility compliance, ethical development, and inclusive design
+- [SE: Security](agents/se-security-reviewer.agent.md): Security-focused code review specialist with OWASP Top 10, Zero Trust, LLM security, and enterprise security standards
+- [SE: Architect](agents/se-system-architecture-reviewer.agent.md): System architecture review specialist with Well-Architected frameworks, design validation, and scalability analysis for AI and distributed systems
+- [SE: Tech Writer](agents/se-technical-writer.agent.md): Technical writing specialist for creating developer documentation, technical blogs, tutorials, and educational content
+- [SE: UX Designer](agents/se-ux-ui-designer.agent.md): Jobs-to-be-Done analysis, user journey mapping, and UX research artifacts for Figma and design workflows
+- [Search Ai Optimization Expert](agents/search-ai-optimization-expert.agent.md): Expert guidance for modern search optimization: SEO, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO) with AI-ready content strategies
+- [Semantic Kernel Dotnet](agents/semantic-kernel-dotnet.agent.md): Create, update, refactor, explain or work with code using the .NET version of Semantic Kernel.
+- [Semantic Kernel Python](agents/semantic-kernel-python.agent.md): Create, update, refactor, explain or work with code using the Python version of Semantic Kernel.
+- [Shopify Expert](agents/shopify-expert.agent.md): Expert Shopify development assistant specializing in theme development, Liquid templating, app development, and Shopify APIs
+- [Simple App Idea Generator](agents/simple-app-idea-generator.agent.md): Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation.
+- [Software Engineer Agent V1](agents/software-engineer-agent-v1.agent.md): Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.
+- [Specification](agents/specification.agent.md): Generate or update specification documents for new or existing functionality.
+- [stackhawk-security-onboarding](agents/stackhawk-security-onboarding.agent.md): Automatically set up StackHawk security testing for your repository with generated configuration and GitHub Actions workflow
+- [Swift MCP Expert](agents/swift-mcp-expert.agent.md): Expert assistance for building Model Context Protocol servers in Swift using modern concurrency features and the official MCP Swift SDK.
+- [Task Planner Instructions](agents/task-planner.agent.md): Task planner for creating actionable implementation plans - Brought to you by microsoft/edge-ai
+- [Task Researcher Instructions](agents/task-researcher.agent.md): Task research specialist for comprehensive project analysis - Brought to you by microsoft/edge-ai
+- [TDD Green Phase - Make Tests Pass Quickly](agents/tdd-green.agent.md): Implement minimal code to satisfy GitHub issue requirements and make failing tests pass without over-engineering.
+- [TDD Red Phase - Write Failing Tests First](agents/tdd-red.agent.md): Guide test-first development by writing failing tests that describe desired behaviour from GitHub issue context before implementation exists.
+- [TDD Refactor Phase - Improve Quality & Security](agents/tdd-refactor.agent.md): Improve code quality, apply security best practices, and enhance design whilst maintaining green tests and GitHub issue compliance.
+- [Tech Debt Remediation Plan](agents/tech-debt-remediation-plan.agent.md): Generate technical debt remediation plans for code, tests, and documentation.
+- [technical-content-evaluator](agents/technical-content-evaluator.agent.md): Elite technical content editor and curriculum architect for evaluating technical training materials, documentation, and educational content. Reviews for technical accuracy, pedagogical excellence, content flow, code validation, and ensures A-grade quality standards.
+- [Azure Terraform IaC Implementation Specialist](agents/terraform-azure-implement.agent.md): Act as an Azure Terraform Infrastructure as Code coding specialist that creates and reviews Terraform for Azure resources.
+- [Azure Terraform Infrastructure Planning](agents/terraform-azure-planning.agent.md): Act as implementation planner for your Azure Terraform Infrastructure as Code task.
+- [Terraform IaC Reviewer](agents/terraform-iac-reviewer.agent.md): Terraform-focused agent that reviews and creates safer IaC changes with emphasis on state safety, least privilege, module patterns, drift detection, and plan/apply discipline
+- [Terraform Agent](agents/terraform.agent.md): Terraform infrastructure specialist with automated HCP Terraform workflows. Leverages Terraform MCP server for registry integration, workspace management, and run orchestration. Generates compliant code using latest provider/module versions, manages private registries, automates variable sets, and orchestrates infrastructure deployments with proper validation and security practices.
+- [TypeScript MCP Server Expert](agents/typescript-mcp-expert.agent.md): Expert assistant for developing Model Context Protocol (MCP) servers in TypeScript
+- [Voidbeast Gpt41enhanced](agents/voidbeast-gpt41enhanced.agent.md): 4.1 voidBeast_GPT41Enhanced 1.0 : a advanced autonomous developer agent, designed for elite full-stack development with enhanced multi-mode capabilities. This latest evolution features sophisticated mode detection, comprehensive research capabilities, and never-ending problem resolution. Plan/Act/Deep Research/Analyzer/Checkpoints(Memory)/Prompt Generator Modes.
+- [Wg Code Alchemist](agents/wg-code-alchemist.agent.md): Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design
+- [Wg Code Sentinel](agents/wg-code-sentinel.agent.md): Ask WG Code Sentinel to review your code for security issues.
+
+## Prompts
+
+- [Add Educational Comments](prompts/add-educational-comments.prompt.md): Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.
+- [Ai Prompt Engineering Safety Review](prompts/ai-prompt-engineering-safety-review.prompt.md): Comprehensive AI prompt engineering safety review and improvement prompt. Analyzes prompts for safety, bias, security vulnerabilities, and effectiveness while providing detailed improvement recommendations with extensive frameworks, testing methodologies, and educational content.
+- [Apple App Store Reviewer](prompts/apple-appstore-reviewer.prompt.md): Serves as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons.
+- [Arch Linux Triage](prompts/arch-linux-triage.prompt.md): Triage and resolve Arch Linux issues with pacman, systemd, and rolling-release best practices.
+- [Architecture Blueprint Generator](prompts/architecture-blueprint-generator.prompt.md): Comprehensive project architecture blueprint generator that analyzes codebases to create detailed architectural documentation. Automatically detects technology stacks and architectural patterns, generates visual diagrams, documents implementation patterns, and provides extensible blueprints for maintaining architectural consistency and guiding new development.
+- [Aspnet Minimal Api Openapi](prompts/aspnet-minimal-api-openapi.prompt.md): Create ASP.NET Minimal API endpoints with proper OpenAPI documentation
+- [Az Cost Optimize](prompts/az-cost-optimize.prompt.md): Analyze Azure resources used in the app (IaC files and/or resources in a target rg) and optimize costs - creating GitHub issues for identified optimizations.
+- [Azure Resource Health Diagnose](prompts/azure-resource-health-diagnose.prompt.md): Analyze Azure resource health, diagnose issues from logs and telemetry, and create a remediation plan for identified problems.
+- [Boost Prompt](prompts/boost-prompt.prompt.md): Interactive prompt refinement workflow: interrogates scope, deliverables, constraints; copies final markdown to clipboard; never writes code. Requires the Joyride extension.
+- [Breakdown Epic Arch](prompts/breakdown-epic-arch.prompt.md): Prompt for creating the high-level technical architecture for an Epic, based on a Product Requirements Document.
+- [Breakdown Epic Pm](prompts/breakdown-epic-pm.prompt.md): Prompt for creating an Epic Product Requirements Document (PRD) for a new epic. This PRD will be used as input for generating a technical architecture specification.
+- [Breakdown Feature Implementation](prompts/breakdown-feature-implementation.prompt.md): Prompt for creating detailed feature implementation plans, following Epoch monorepo structure.
+- [Breakdown Feature Prd](prompts/breakdown-feature-prd.prompt.md): Prompt for creating Product Requirements Documents (PRDs) for new features, based on an Epic.
+- [Breakdown Plan](prompts/breakdown-plan.prompt.md): Issue Planning and Automation prompt that generates comprehensive project plans with Epic > Feature > Story/Enabler > Test hierarchy, dependencies, priorities, and automated tracking.
+- [Breakdown Test](prompts/breakdown-test.prompt.md): Test Planning and Quality Assurance prompt that generates comprehensive test strategies, task breakdowns, and quality validation plans for GitHub projects.
+- [Centos Linux Triage](prompts/centos-linux-triage.prompt.md): Triage and resolve CentOS issues using RHEL-compatible tooling, SELinux-aware practices, and firewalld.
+- [Code Exemplars Blueprint Generator](prompts/code-exemplars-blueprint-generator.prompt.md): Technology-agnostic prompt generator that creates customizable AI prompts for scanning codebases and identifying high-quality code exemplars. Supports multiple programming languages (.NET, Java, JavaScript, TypeScript, React, Angular, Python) with configurable analysis depth, categorization methods, and documentation formats to establish coding standards and maintain consistency across development teams.
+- [Comment Code Generate A Tutorial](prompts/comment-code-generate-a-tutorial.prompt.md): Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial.
+- [Containerize Aspnet Framework](prompts/containerize-aspnet-framework.prompt.md): Containerize an ASP.NET .NET Framework project by creating Dockerfile and .dockerfile files customized for the project.
+- [Containerize Aspnetcore](prompts/containerize-aspnetcore.prompt.md): Containerize an ASP.NET Core project by creating Dockerfile and .dockerfile files customized for the project.
+- [Conventional Commit](prompts/conventional-commit.prompt.md): Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and validation.
+- [Convert Plaintext To Md](prompts/convert-plaintext-to-md.prompt.md): Convert a text-based document to markdown following instructions from prompt, or if a documented option is passed, follow the instructions for that option.
+- [Copilot Instructions Blueprint Generator](prompts/copilot-instructions-blueprint-generator.prompt.md): Technology-agnostic blueprint generator for creating comprehensive copilot-instructions.md files that guide GitHub Copilot to produce code consistent with project standards, architecture patterns, and exact technology versions by analyzing existing codebase patterns and avoiding assumptions.
+- [Cosmosdb Datamodeling](prompts/cosmosdb-datamodeling.prompt.md): Step-by-step guide for capturing key application requirements for NoSQL use-case and produce Azure Cosmos DB Data NoSQL Model design using best practices and common patterns, artifacts_produced: "cosmosdb_requirements.md" file and "cosmosdb_data_model.md" file
+- [Create Agentsmd](prompts/create-agentsmd.prompt.md): Prompt for generating an AGENTS.md file for a repository
+- [Create Architectural Decision Record](prompts/create-architectural-decision-record.prompt.md): Create an Architectural Decision Record (ADR) document for AI-optimized decision documentation.
+- [Create Github Action Workflow Specification](prompts/create-github-action-workflow-specification.prompt.md): Create a formal specification for an existing GitHub Actions CI/CD workflow, optimized for AI consumption and workflow maintenance.
+- [Create Github Issue Feature From Specification](prompts/create-github-issue-feature-from-specification.prompt.md): Create GitHub Issue for feature request from specification file using feature_request.yml template.
+- [Create Github Issues Feature From Implementation Plan](prompts/create-github-issues-feature-from-implementation-plan.prompt.md): Create GitHub Issues from implementation plan phases using feature_request.yml or chore_request.yml templates.
+- [Create Github Issues For Unmet Specification Requirements](prompts/create-github-issues-for-unmet-specification-requirements.prompt.md): Create GitHub Issues for unimplemented requirements from specification files using feature_request.yml template.
+- [Create Github Pull Request From Specification](prompts/create-github-pull-request-from-specification.prompt.md): Create GitHub Pull Request for feature request from specification file using pull_request_template.md template.
+- [Create Implementation Plan](prompts/create-implementation-plan.prompt.md): Create a new implementation plan file for new features, refactoring existing code or upgrading packages, design, architecture or infrastructure.
+- [Create Llms](prompts/create-llms.prompt.md): Create an llms.txt file from scratch based on repository structure following the llms.txt specification at https://llmstxt.org/
+- [Create Oo Component Documentation](prompts/create-oo-component-documentation.prompt.md): Create comprehensive, standardized documentation for object-oriented components following industry best practices and architectural documentation standards.
+- [Create Readme](prompts/create-readme.prompt.md): Create a README.md file for the project
+- [Create Specification](prompts/create-specification.prompt.md): Create a new specification file for the solution, optimized for Generative AI consumption.
+- [Create Spring Boot Java Project](prompts/create-spring-boot-java-project.prompt.md): Create Spring Boot Java Project Skeleton
+- [Create Spring Boot Kotlin Project](prompts/create-spring-boot-kotlin-project.prompt.md): Create Spring Boot Kotlin Project Skeleton
+- [Create Technical Spike](prompts/create-technical-spike.prompt.md): Create time-boxed technical spike documents for researching and resolving critical development decisions before implementation.
+- [Create Tldr Page](prompts/create-tldr-page.prompt.md): Create a tldr page from documentation URLs and command examples, requiring both URL and command name.
+- [Csharp Async](prompts/csharp-async.prompt.md): Get best practices for C# async programming
+- [Csharp Docs](prompts/csharp-docs.prompt.md): Ensure that C# types are documented with XML comments and follow best practices for documentation.
+- [Csharp Mcp Server Generator](prompts/csharp-mcp-server-generator.prompt.md): Generate a complete MCP server project in C# with tools, prompts, and proper configuration
+- [Csharp Mstest](prompts/csharp-mstest.prompt.md): Get best practices for MSTest unit testing, including data-driven tests
+- [Csharp Nunit](prompts/csharp-nunit.prompt.md): Get best practices for NUnit unit testing, including data-driven tests
+- [Csharp Tunit](prompts/csharp-tunit.prompt.md): Get best practices for TUnit unit testing, including data-driven tests
+- [Csharp Xunit](prompts/csharp-xunit.prompt.md): Get best practices for XUnit unit testing, including data-driven tests
+- [Dataverse Python Advanced Patterns](prompts/dataverse-python-advanced-patterns.prompt.md): Generate production code for Dataverse SDK using advanced patterns, error handling, and optimization techniques.
+- [Dataverse Python - Production Code Generator](prompts/dataverse-python-production-code.prompt.md): Generate production-ready Python code using Dataverse SDK with error handling, optimization, and best practices
+- [Dataverse Python Quickstart Generator](prompts/dataverse-python-quickstart.prompt.md): Generate Python SDK setup + CRUD + bulk + paging snippets using official patterns.
+- [Dataverse Python - Use Case Solution Builder](prompts/dataverse-python-usecase-builder.prompt.md): Generate complete solutions for specific Dataverse SDK use cases with architecture recommendations
+- [Debian Linux Triage](prompts/debian-linux-triage.prompt.md): Triage and resolve Debian Linux issues with apt, systemd, and AppArmor-aware guidance.
+- [Declarative Agents](prompts/declarative-agents.prompt.md): Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration
+- [Devops Rollout Plan](prompts/devops-rollout-plan.prompt.md): Generate comprehensive rollout plans with preflight checks, step-by-step deployment, verification signals, rollback procedures, and communication plans for infrastructure and application changes
+- [Documentation Writer](prompts/documentation-writer.prompt.md): Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.
+- [Dotnet Best Practices](prompts/dotnet-best-practices.prompt.md): Ensure .NET/C# code meets best practices for the solution/project.
+- [Dotnet Design Pattern Review](prompts/dotnet-design-pattern-review.prompt.md): Review the C#/.NET code for design pattern implementation and suggest improvements.
+- [.NET Upgrade Analysis Prompts](prompts/dotnet-upgrade.prompt.md): Ready-to-use prompts for comprehensive .NET framework upgrade analysis and execution
+- [Editorconfig](prompts/editorconfig.prompt.md): Generates a comprehensive and best-practice-oriented .editorconfig file based on project analysis and user preferences.
+- [Ef Core](prompts/ef-core.prompt.md): Get best practices for Entity Framework Core
+- [Fedora Linux Triage](prompts/fedora-linux-triage.prompt.md): Triage and resolve Fedora issues with dnf, systemd, and SELinux-aware guidance.
+- [Finalize Agent Prompt](prompts/finalize-agent-prompt.prompt.md): Finalize prompt file using the role of an AI agent to polish the prompt for the end user.
+- [First Ask](prompts/first-ask.prompt.md): Interactive, input-tool powered, task refinement workflow: interrogates scope, deliverables, constraints before carrying out the task; Requires the Joyride extension.
+- [Folder Structure Blueprint Generator](prompts/folder-structure-blueprint-generator.prompt.md): Comprehensive technology-agnostic prompt for analyzing and documenting project folder structures. Auto-detects project types (.NET, Java, React, Angular, Python, Node.js, Flutter), generates detailed blueprints with visualization options, naming conventions, file placement patterns, and extension templates for maintaining consistent code organization across diverse technology stacks.
+- [Gen Specs As Issues](prompts/gen-specs-as-issues.prompt.md): This workflow guides you through a systematic approach to identify missing features, prioritize them, and create detailed specifications for implementation.
+- [Generate Custom Instructions From Codebase](prompts/generate-custom-instructions-from-codebase.prompt.md): Migration and code evolution instructions generator for GitHub Copilot. Analyzes differences between two project versions (branches, commits, or releases) to create precise instructions allowing Copilot to maintain consistency during technology migrations, major refactoring, or framework version upgrades.
+- [Git Flow Branch Creator](prompts/git-flow-branch-creator.prompt.md): Intelligent Git Flow branch creator that analyzes git status/diff and creates appropriate branches following the nvie Git Flow branching model.
+- [Github Copilot Starter](prompts/github-copilot-starter.prompt.md): Set up complete GitHub Copilot configuration for a new project based on technology stack
+- [Go Mcp Server Generator](prompts/go-mcp-server-generator.prompt.md): Generate a complete Go MCP server project with proper structure, dependencies, and implementation using the official github.com/modelcontextprotocol/go-sdk.
+- [Java Add Graalvm Native Image Support](prompts/java-add-graalvm-native-image-support.prompt.md): GraalVM Native Image expert that adds native image support to Java applications, builds the project, analyzes build errors, applies fixes, and iterates until successful compilation using Oracle best practices.
+- [Java Docs](prompts/java-docs.prompt.md): Ensure that Java types are documented with Javadoc comments and follow best practices for documentation.
+- [Java Junit](prompts/java-junit.prompt.md): Get best practices for JUnit 5 unit testing, including data-driven tests
+- [Java Mcp Server Generator](prompts/java-mcp-server-generator.prompt.md): Generate a complete Model Context Protocol server project in Java using the official MCP Java SDK with reactive streams and optional Spring Boot integration.
+- [Java Refactoring Extract Method](prompts/java-refactoring-extract-method.prompt.md): Refactoring using Extract Methods in Java Language
+- [Java Refactoring Remove Parameter](prompts/java-refactoring-remove-parameter.prompt.md): Refactoring using Remove Parameter in Java Language
+- [Java Springboot](prompts/java-springboot.prompt.md): Get best practices for developing applications with Spring Boot.
+- [Javascript Typescript Jest](prompts/javascript-typescript-jest.prompt.md): Best practices for writing JavaScript/TypeScript tests using Jest, including mocking strategies, test structure, and common patterns.
+- [Kotlin Mcp Server Generator](prompts/kotlin-mcp-server-generator.prompt.md): Generate a complete Kotlin MCP server project with proper structure, dependencies, and implementation using the official io.modelcontextprotocol:kotlin-sdk library.
+- [Kotlin Springboot](prompts/kotlin-springboot.prompt.md): Get best practices for developing applications with Spring Boot and Kotlin.
+- [Mcp Copilot Studio Server Generator](prompts/mcp-copilot-studio-server-generator.prompt.md): Generate a complete MCP server implementation optimized for Copilot Studio integration with proper schema constraints and streamable HTTP support
+- [Mcp Create Adaptive Cards](prompts/mcp-create-adaptive-cards.prompt.md): No description available
+- [Mcp Create Declarative Agent](prompts/mcp-create-declarative-agent.prompt.md): No description available
+- [Mcp Deploy Manage Agents](prompts/mcp-deploy-manage-agents.prompt.md): No description available
+- [Memory Merger](prompts/memory-merger.prompt.md): Merges mature lessons from a domain memory file into its instruction file. Syntax: `/memory-merger >domain [scope]` where scope is `global` (default), `user`, `workspace`, or `ws`.
+- [Mkdocs Translations](prompts/mkdocs-translations.prompt.md): Generate a language translation for a mkdocs documentation stack.
+- [Model Recommendation](prompts/model-recommendation.prompt.md): Analyze chatmode or prompt files and recommend optimal AI models based on task complexity, required capabilities, and cost-efficiency
+- [Multi Stage Dockerfile](prompts/multi-stage-dockerfile.prompt.md): Create optimized multi-stage Dockerfiles for any language or framework
+- [My Issues](prompts/my-issues.prompt.md): List my issues in the current repository
+- [My Pull Requests](prompts/my-pull-requests.prompt.md): List my pull requests in the current repository
+- [Next Intl Add Language](prompts/next-intl-add-language.prompt.md): Add new language to a Next.js + next-intl application
+- [Openapi To Application Code](prompts/openapi-to-application-code.prompt.md): Generate a complete, production-ready application from an OpenAPI specification
+- [Php Mcp Server Generator](prompts/php-mcp-server-generator.prompt.md): Generate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK
+- [Playwright Automation Fill In Form](prompts/playwright-automation-fill-in-form.prompt.md): Automate filling in a form using Playwright MCP
+- [Playwright Explore Website](prompts/playwright-explore-website.prompt.md): Website exploration for testing using Playwright MCP
+- [Playwright Generate Test](prompts/playwright-generate-test.prompt.md): Generate a Playwright test based on a scenario using Playwright MCP
+- [Postgresql Code Review](prompts/postgresql-code-review.prompt.md): PostgreSQL-specific code review assistant focusing on PostgreSQL best practices, anti-patterns, and unique quality standards. Covers JSONB operations, array usage, custom types, schema design, function optimization, and PostgreSQL-exclusive security features like Row Level Security (RLS).
+- [Postgresql Optimization](prompts/postgresql-optimization.prompt.md): PostgreSQL-specific development assistant focusing on unique PostgreSQL features, advanced data types, and PostgreSQL-exclusive capabilities. Covers JSONB operations, array types, custom types, range/geometric types, full-text search, window functions, and PostgreSQL extensions ecosystem.
+- [Power Apps Code App Scaffold](prompts/power-apps-code-app-scaffold.prompt.md): Scaffold a complete Power Apps Code App project with PAC CLI setup, SDK integration, and connector configuration
+- [Power Bi Dax Optimization](prompts/power-bi-dax-optimization.prompt.md): Comprehensive Power BI DAX formula optimization prompt for improving performance, readability, and maintainability of DAX calculations.
+- [Power Bi Model Design Review](prompts/power-bi-model-design-review.prompt.md): Comprehensive Power BI data model design review prompt for evaluating model architecture, relationships, and optimization opportunities.
+- [Power Bi Performance Troubleshooting](prompts/power-bi-performance-troubleshooting.prompt.md): Systematic Power BI performance troubleshooting prompt for identifying, diagnosing, and resolving performance issues in Power BI models, reports, and queries.
+- [Power Bi Report Design Consultation](prompts/power-bi-report-design-consultation.prompt.md): Power BI report visualization design prompt for creating effective, user-friendly, and accessible reports with optimal chart selection and layout design.
+- [Power Platform Mcp Connector Suite](prompts/power-platform-mcp-connector-suite.prompt.md): Generate complete Power Platform custom connector with MCP integration for Copilot Studio - includes schema generation, troubleshooting, and validation
+- [Project Workflow Analysis Blueprint Generator](prompts/project-workflow-analysis-blueprint-generator.prompt.md): Comprehensive technology-agnostic prompt generator for documenting end-to-end application workflows. Automatically detects project architecture patterns, technology stacks, and data flow patterns to generate detailed implementation blueprints covering entry points, service layers, data access, error handling, and testing approaches across multiple technologies including .NET, Java/Spring, React, and microservices architectures.
+- [Prompt Builder](prompts/prompt-builder.prompt.md): Guide users through creating high-quality GitHub Copilot prompts with proper structure, tools, and best practices.
+- [Pytest Coverage](prompts/pytest-coverage.prompt.md): Run pytest tests with coverage, discover lines missing coverage, and increase coverage to 100%.
+- [Python Mcp Server Generator](prompts/python-mcp-server-generator.prompt.md): Generate a complete MCP server project in Python with tools, resources, and proper configuration
+- [Readme Blueprint Generator](prompts/readme-blueprint-generator.prompt.md): Intelligent README.md generation prompt that analyzes project documentation structure and creates comprehensive repository documentation. Scans .github/copilot directory files and copilot-instructions.md to extract project information, technology stack, architecture, development workflow, coding standards, and testing approaches while generating well-structured markdown documentation with proper formatting, cross-references, and developer-focused content.
+- [Remember Interactive Programming](prompts/remember-interactive-programming.prompt.md): A micro-prompt that reminds the agent that it is an interactive programmer. Works great in Clojure when Copilot has access to the REPL (probably via Backseat Driver). Will work with any system that has a live REPL that the agent can use. Adapt the prompt with any specific reminders in your workflow and/or workspace.
+- [Remember](prompts/remember.prompt.md): Transforms lessons learned into domain-organized memory instructions (global or workspace). Syntax: `/remember [>domain [scope]] lesson clue` where scope is `global` (default), `user`, `workspace`, or `ws`.
+- [Repo Story Time](prompts/repo-story-time.prompt.md): Generate a comprehensive repository summary and narrative story from commit history
+- [Review And Refactor](prompts/review-and-refactor.prompt.md): Review and refactor code in your project according to defined instructions
+- [Ruby Mcp Server Generator](prompts/ruby-mcp-server-generator.prompt.md): Generate a complete Model Context Protocol server project in Ruby using the official MCP Ruby SDK gem.
+- [rust-mcp-server-generator](prompts/rust-mcp-server-generator.prompt.md): Generate a complete Rust Model Context Protocol server project with tools, prompts, resources, and tests using the official rmcp SDK
+- [Shuffle Json Data](prompts/shuffle-json-data.prompt.md): Shuffle repetitive JSON objects safely by validating schema consistency before randomising entries.
+- [Sql Code Review](prompts/sql-code-review.prompt.md): Universal SQL code review assistant that performs comprehensive security, maintainability, and code quality analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Focuses on SQL injection prevention, access control, code standards, and anti-pattern detection. Complements SQL optimization prompt for complete development coverage.
+- [Sql Optimization](prompts/sql-optimization.prompt.md): Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guidance.
+- [sa-generate](prompts/structured-autonomy-generate.prompt.md): Structured Autonomy Implementation Generator Prompt
+- [sa-implement](prompts/structured-autonomy-implement.prompt.md): Structured Autonomy Implementation Prompt
+- [sa-plan](prompts/structured-autonomy-plan.prompt.md): Structured Autonomy Planning Prompt
+- [Suggest Awesome Github Copilot Agents](prompts/suggest-awesome-github-copilot-agents.prompt.md): Suggest relevant GitHub Copilot Custom Agents files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom agents in this repository, and identifying outdated agents that need updates.
+- [Suggest Awesome Github Copilot Collections](prompts/suggest-awesome-github-copilot-collections.prompt.md): Suggest relevant GitHub Copilot collections from the awesome-copilot repository based on current repository context and chat history, providing automatic download and installation of collection assets, and identifying outdated collection assets that need updates.
+- [Suggest Awesome Github Copilot Instructions](prompts/suggest-awesome-github-copilot-instructions.prompt.md): Suggest relevant GitHub Copilot instruction files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing instructions in this repository, and identifying outdated instructions that need updates.
+- [Suggest Awesome Github Copilot Prompts](prompts/suggest-awesome-github-copilot-prompts.prompt.md): Suggest relevant GitHub Copilot prompt files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing prompts in this repository, and identifying outdated prompts that need updates.
+- [Swift Mcp Server Generator](prompts/swift-mcp-server-generator.prompt.md): Generate a complete Model Context Protocol server project in Swift using the official MCP Swift SDK package.
+- [Technology Stack Blueprint Generator](prompts/technology-stack-blueprint-generator.prompt.md): Comprehensive technology stack blueprint generator that analyzes codebases to create detailed architectural documentation. Automatically detects technology stacks, programming languages, and implementation patterns across multiple platforms (.NET, Java, JavaScript, React, Python). Generates configurable blueprints with version information, licensing details, usage patterns, coding conventions, and visual diagrams. Provides implementation-ready templates and maintains architectural consistency for guided development.
+- [Tldr Prompt](prompts/tldr-prompt.prompt.md): Create tldr summaries for GitHub Copilot files (prompts, agents, instructions, collections), MCP servers, or documentation from URLs and queries.
+- [Typescript Mcp Server Generator](prompts/typescript-mcp-server-generator.prompt.md): Generate a complete MCP server project in TypeScript with tools, resources, and proper configuration
+- [Typespec Api Operations](prompts/typespec-api-operations.prompt.md): Add GET, POST, PATCH, and DELETE operations to a TypeSpec API plugin with proper routing, parameters, and adaptive cards
+- [Typespec Create Agent](prompts/typespec-create-agent.prompt.md): Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot
+- [Typespec Create Api Plugin](prompts/typespec-create-api-plugin.prompt.md): Generate a TypeSpec API plugin with REST operations, authentication, and Adaptive Cards for Microsoft 365 Copilot
+- [Update Avm Modules In Bicep](prompts/update-avm-modules-in-bicep.prompt.md): Update Azure Verified Modules (AVM) to latest versions in Bicep files.
+- [Update Implementation Plan](prompts/update-implementation-plan.prompt.md): Update an existing implementation plan file with new or update requirements to provide new features, refactoring existing code or upgrading packages, design, architecture or infrastructure.
+- [Update Llms](prompts/update-llms.prompt.md): Update the llms.txt file in the root folder to reflect changes in documentation or specifications following the llms.txt specification at https://llmstxt.org/
+- [Update Markdown File Index](prompts/update-markdown-file-index.prompt.md): Update a markdown file section with an index/table of files from a specified folder.
+- [Update Oo Component Documentation](prompts/update-oo-component-documentation.prompt.md): Update existing object-oriented component documentation following industry best practices and architectural documentation standards.
+- [Update Specification](prompts/update-specification.prompt.md): Update an existing specification file for the solution, optimized for Generative AI consumption based on new requirements or updates to any existing code.
+- [Write Coding Standards From File](prompts/write-coding-standards-from-file.prompt.md): Write a coding standards document for a project using the coding styles from the file(s) and/or folder(s) passed as arguments in the prompt.
+
+## Instructions
+
+- [A11y](instructions/a11y.instructions.md): Guidance for creating more accessible code
+- [Agent Skills](instructions/agent-skills.instructions.md): Guidelines for creating high-quality Agent Skills for GitHub Copilot
+- [Agents](instructions/agents.instructions.md): Guidelines for creating custom agent files for GitHub Copilot
+- [Ai Prompt Engineering Safety Best Practices](instructions/ai-prompt-engineering-safety-best-practices.instructions.md): Comprehensive best practices for AI prompt engineering, safety frameworks, bias mitigation, and responsible AI usage for Copilot and LLMs.
+- [Angular](instructions/angular.instructions.md): Angular-specific coding standards and best practices
+- [Ansible](instructions/ansible.instructions.md): Ansible conventions and best practices
+- [Apex](instructions/apex.instructions.md): Guidelines and best practices for Apex development on the Salesforce Platform
+- [Arch Linux](instructions/arch-linux.instructions.md): Guidance for Arch Linux administration, pacman workflows, and rolling-release best practices.
+- [Aspnet Rest Apis](instructions/aspnet-rest-apis.instructions.md): Guidelines for building REST APIs with ASP.NET
+- [Astro](instructions/astro.instructions.md): Astro development standards and best practices for content-driven websites
+- [Azure Devops Pipelines](instructions/azure-devops-pipelines.instructions.md): Best practices for Azure DevOps Pipeline YAML files
+- [Azure Functions Typescript](instructions/azure-functions-typescript.instructions.md): TypeScript patterns for Azure Functions
+- [Azure Logic Apps Power Automate](instructions/azure-logic-apps-power-automate.instructions.md): Guidelines for developing Azure Logic Apps and Power Automate workflows with best practices for Workflow Definition Language (WDL), integration patterns, and enterprise automation
+- [Azure Verified Modules Bicep](instructions/azure-verified-modules-bicep.instructions.md): Azure Verified Modules (AVM) and Bicep
+- [Azure Verified Modules Terraform](instructions/azure-verified-modules-terraform.instructions.md):  Azure Verified Modules (AVM) and Terraform
+- [Bicep Code Best Practices](instructions/bicep-code-best-practices.instructions.md): Infrastructure as Code with Bicep
+- [Blazor](instructions/blazor.instructions.md): Blazor component and application patterns
+- [Centos Linux](instructions/centos-linux.instructions.md): Guidance for CentOS administration, RHEL-compatible tooling, and SELinux-aware operations.
+- [Clojure](instructions/clojure.instructions.md): Clojure-specific coding patterns, inline def usage, code block templates, and namespace handling for Clojure development.
+- [Cmake Vcpkg](instructions/cmake-vcpkg.instructions.md): C++ project configuration and package management
+- [Code Review Generic](instructions/code-review-generic.instructions.md): Generic code review instructions that can be customized for any project using GitHub Copilot
+- [Codexer](instructions/codexer.instructions.md): Advanced Python research assistant with Context 7 MCP integration, focusing on speed, reliability, and 10+ years of software development expertise
+- [Coldfusion Cfc](instructions/coldfusion-cfc.instructions.md): ColdFusion Coding Standards for CFC component and application patterns
+- [Coldfusion Cfm](instructions/coldfusion-cfm.instructions.md): ColdFusion cfm files and application patterns
+- [Collections](instructions/collections.instructions.md): Guidelines for creating and managing awesome-copilot collections
+- [Containerization Docker Best Practices](instructions/containerization-docker-best-practices.instructions.md): Comprehensive best practices for creating optimized, secure, and efficient Docker images and managing containers. Covers multi-stage builds, image layer optimization, security scanning, and runtime best practices.
+- [Convert Cassandra To Spring Data Cosmos](instructions/convert-cassandra-to-spring-data-cosmos.instructions.md): Step-by-step guide for converting Spring Boot Cassandra applications to use Azure Cosmos DB with Spring Data Cosmos
+- [Convert Jpa To Spring Data Cosmos](instructions/convert-jpa-to-spring-data-cosmos.instructions.md): Step-by-step guide for converting Spring Boot JPA applications to use Azure Cosmos DB with Spring Data Cosmos
+- [GitHub Copilot SDK C# Instructions](instructions/copilot-sdk-csharp.instructions.md): This file provides guidance on building C# applications using GitHub Copilot SDK.
+- [GitHub Copilot SDK Go Instructions](instructions/copilot-sdk-go.instructions.md): This file provides guidance on building Go applications using GitHub Copilot SDK.
+- [GitHub Copilot SDK Node.js Instructions](instructions/copilot-sdk-nodejs.instructions.md): This file provides guidance on building Node.js/TypeScript applications using GitHub Copilot SDK.
+- [GitHub Copilot SDK Python Instructions](instructions/copilot-sdk-python.instructions.md): This file provides guidance on building Python applications using GitHub Copilot SDK.
+- [Copilot Thought Logging](instructions/copilot-thought-logging.instructions.md): See process Copilot is following where you can edit this to reshape the interaction or save when follow up may be needed
+- [Csharp Ja](instructions/csharp-ja.instructions.md): C# アプリケーション構築指針 by @tsubakimoto
+- [Csharp Ko](instructions/csharp-ko.instructions.md): C# 애플리케이션 개발을 위한 코드 작성 규칙 by @jgkim999
+- [Csharp Mcp Server](instructions/csharp-mcp-server.instructions.md): Instructions for building Model Context Protocol (MCP) servers using the C# SDK
+- [Csharp](instructions/csharp.instructions.md): Guidelines for building C# applications
+- [Dart N Flutter](instructions/dart-n-flutter.instructions.md): Instructions for writing Dart and Flutter code following the official recommendations.
+- [Dataverse Python Advanced Features](instructions/dataverse-python-advanced-features.instructions.md): No description available
+- [Dataverse Python Agentic Workflows](instructions/dataverse-python-agentic-workflows.instructions.md): No description available
+- [Dataverse Python Api Reference](instructions/dataverse-python-api-reference.instructions.md): No description available
+- [Dataverse Python Authentication Security](instructions/dataverse-python-authentication-security.instructions.md): No description available
+- [Dataverse Python Best Practices](instructions/dataverse-python-best-practices.instructions.md): No description available
+- [Dataverse Python Error Handling](instructions/dataverse-python-error-handling.instructions.md): No description available
+- [Dataverse Python File Operations](instructions/dataverse-python-file-operations.instructions.md): No description available
+- [Dataverse Python Modules](instructions/dataverse-python-modules.instructions.md): No description available
+- [Dataverse Python Pandas Integration](instructions/dataverse-python-pandas-integration.instructions.md): No description available
+- [Dataverse Python Performance Optimization](instructions/dataverse-python-performance-optimization.instructions.md): No description available
+- [Dataverse Python Real World Usecases](instructions/dataverse-python-real-world-usecases.instructions.md): No description available
+- [Dataverse Python Sdk](instructions/dataverse-python-sdk.instructions.md): No description available
+- [Dataverse Python Testing Debugging](instructions/dataverse-python-testing-debugging.instructions.md): No description available
+- [Dataverse Python](instructions/dataverse-python.instructions.md): No description available
+- [Debian Linux](instructions/debian-linux.instructions.md): Guidance for Debian-based Linux administration, apt workflows, and Debian policy conventions.
+- [Declarative Agents Microsoft365](instructions/declarative-agents-microsoft365.instructions.md): Comprehensive development guidelines for Microsoft 365 Copilot declarative agents with schema v1.5, TypeSpec integration, and Microsoft 365 Agents Toolkit workflows
+- [Devbox Image Definition](instructions/devbox-image-definition.instructions.md): Authoring recommendations for creating YAML based image definition files for use with Microsoft Dev Box Team Customizations
+- [Devops Core Principles](instructions/devops-core-principles.instructions.md): Foundational instructions covering core DevOps principles, culture (CALMS), and key metrics (DORA) to guide GitHub Copilot in understanding and promoting effective software delivery.
+- [Dotnet Architecture Good Practices](instructions/dotnet-architecture-good-practices.instructions.md): DDD and .NET architecture guidelines
+- [Dotnet Framework](instructions/dotnet-framework.instructions.md): Guidance for working with .NET Framework projects. Includes project structure, C# language version, NuGet management, and best practices.
+- [Dotnet Maui 9 To Dotnet Maui 10 Upgrade](instructions/dotnet-maui-9-to-dotnet-maui-10-upgrade.instructions.md): Instructions for upgrading .NET MAUI applications from version 9 to version 10, including breaking changes, deprecated APIs, and migration strategies for ListView to CollectionView.
+- [Dotnet Maui](instructions/dotnet-maui.instructions.md): .NET MAUI component and application patterns
+- [.NET Framework Upgrade Specialist](instructions/dotnet-upgrade.instructions.md): Specialized agent for comprehensive .NET framework upgrades with progressive tracking and validation
+- [Dotnet Wpf](instructions/dotnet-wpf.instructions.md): .NET WPF component and application patterns
+- [Fedora Linux](instructions/fedora-linux.instructions.md): Guidance for Fedora (Red Hat family) systems, dnf workflows, SELinux, and modern systemd practices.
+- [Genaiscript](instructions/genaiscript.instructions.md): AI-powered script generation guidelines
+- [Generate Modern Terraform Code For Azure](instructions/generate-modern-terraform-code-for-azure.instructions.md): Guidelines for generating modern Terraform code for Azure
+- [Gilfoyle Code Review](instructions/gilfoyle-code-review.instructions.md): Gilfoyle-style code review instructions that channel the sardonic technical supremacy of Silicon Valley's most arrogant systems architect.
+- [Github Actions Ci Cd Best Practices](instructions/github-actions-ci-cd-best-practices.instructions.md): Comprehensive guide for building robust, secure, and efficient CI/CD pipelines using GitHub Actions. Covers workflow structure, jobs, steps, environment variables, secret management, caching, matrix strategies, testing, and deployment strategies.
+- [Go Mcp Server](instructions/go-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk package.
+- [Go](instructions/go.instructions.md): Instructions for writing Go code following idiomatic Go practices and community standards
+- [Html Css Style Color Guide](instructions/html-css-style-color-guide.instructions.md): Color usage guidelines and styling rules for HTML elements to ensure accessible, professional designs.
+- [Instructions](instructions/instructions.instructions.md): Guidelines for creating high-quality custom instruction files for GitHub Copilot
+- [Java 11 To Java 17 Upgrade](instructions/java-11-to-java-17-upgrade.instructions.md): Comprehensive best practices for adopting new Java 17 features since the release of Java 11.
+- [Java 17 To Java 21 Upgrade](instructions/java-17-to-java-21-upgrade.instructions.md): Comprehensive best practices for adopting new Java 21 features since the release of Java 17.
+- [Java 21 To Java 25 Upgrade](instructions/java-21-to-java-25-upgrade.instructions.md): Comprehensive best practices for adopting new Java 25 features since the release of Java 21.
+- [Java Mcp Server](instructions/java-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Java using the official MCP Java SDK with reactive streams and Spring integration.
+- [Java](instructions/java.instructions.md): Guidelines for building Java base applications
+- [Joyride User Project](instructions/joyride-user-project.instructions.md): Expert assistance for Joyride User Script projects - REPL-driven ClojureScript and user space automation of VS Code
+- [Joyride Workspace Automation](instructions/joyride-workspace-automation.instructions.md): Expert assistance for Joyride Workspace automation - REPL-driven and user space ClojureScript automation within specific VS Code workspaces
+- [Kotlin Mcp Server](instructions/kotlin-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Kotlin using the official io.modelcontextprotocol:kotlin-sdk library.
+- [Kubernetes Deployment Best Practices](instructions/kubernetes-deployment-best-practices.instructions.md): Comprehensive best practices for deploying and managing applications on Kubernetes. Covers Pods, Deployments, Services, Ingress, ConfigMaps, Secrets, health checks, resource limits, scaling, and security contexts.
+- [Kubernetes Manifests](instructions/kubernetes-manifests.instructions.md): Best practices for Kubernetes YAML manifests including labeling conventions, security contexts, pod security, resource management, probes, and validation commands
+- [Langchain Python](instructions/langchain-python.instructions.md): Instructions for using LangChain with Python
+- [Localization](instructions/localization.instructions.md): Guidelines for localizing markdown documents
+- [Lwc](instructions/lwc.instructions.md): Guidelines and best practices for developing Lightning Web Components (LWC) on Salesforce Platform.
+- [Makefile](instructions/makefile.instructions.md): Best practices for authoring GNU Make Makefiles
+- [Markdown](instructions/markdown.instructions.md): Documentation and content creation standards
+- [Mcp M365 Copilot](instructions/mcp-m365-copilot.instructions.md): Best practices for building MCP-based declarative agents and API plugins for Microsoft 365 Copilot with Model Context Protocol integration
+- [Memory Bank](instructions/memory-bank.instructions.md): No description available
+- [Mongo Dba](instructions/mongo-dba.instructions.md): Instructions for customizing GitHub Copilot behavior for MONGODB DBA chat mode.
+- [Ms Sql Dba](instructions/ms-sql-dba.instructions.md): Instructions for customizing GitHub Copilot behavior for MS-SQL DBA chat mode.
+- [Nestjs](instructions/nestjs.instructions.md): NestJS development standards and best practices for building scalable Node.js server-side applications
+- [Nextjs Tailwind](instructions/nextjs-tailwind.instructions.md): Next.js + Tailwind development standards and instructions
+- [Nextjs](instructions/nextjs.instructions.md): Best practices for building Next.js (App Router) apps with modern caching, tooling, and server/client boundaries (aligned with Next.js 16.1.1).
+- [Nodejs Javascript Vitest](instructions/nodejs-javascript-vitest.instructions.md): Guidelines for writing Node.js and JavaScript code with Vitest testing
+- [Object Calisthenics](instructions/object-calisthenics.instructions.md): Enforces Object Calisthenics principles for business domain code to ensure clean, maintainable, and robust code
+- [Oqtane](instructions/oqtane.instructions.md): Oqtane Module patterns
+- [Pcf Alm](instructions/pcf-alm.instructions.md): Application lifecycle management (ALM) for PCF code components
+- [Pcf Api Reference](instructions/pcf-api-reference.instructions.md): Complete PCF API reference with all interfaces and their availability in model-driven and canvas apps
+- [Pcf Best Practices](instructions/pcf-best-practices.instructions.md): Best practices and guidance for developing PCF code components
+- [Pcf Canvas Apps](instructions/pcf-canvas-apps.instructions.md): Code components for canvas apps implementation, security, and configuration
+- [Pcf Code Components](instructions/pcf-code-components.instructions.md): Understanding code components structure and implementation
+- [Pcf Community Resources](instructions/pcf-community-resources.instructions.md): PCF community resources including gallery, videos, blogs, and development tools
+- [Pcf Dependent Libraries](instructions/pcf-dependent-libraries.instructions.md): Using dependent libraries in PCF components
+- [Pcf Events](instructions/pcf-events.instructions.md): Define and handle custom events in PCF components
+- [Pcf Fluent Modern Theming](instructions/pcf-fluent-modern-theming.instructions.md): Style components with modern theming using Fluent UI
+- [Pcf Limitations](instructions/pcf-limitations.instructions.md): Limitations and restrictions of Power Apps Component Framework
+- [Pcf Manifest Schema](instructions/pcf-manifest-schema.instructions.md): Complete manifest schema reference for PCF components with all available XML elements
+- [Pcf Model Driven Apps](instructions/pcf-model-driven-apps.instructions.md): Code components for model-driven apps implementation and configuration
+- [Pcf Overview](instructions/pcf-overview.instructions.md): Power Apps Component Framework overview and fundamentals
+- [Pcf Power Pages](instructions/pcf-power-pages.instructions.md): Using code components in Power Pages sites
+- [Pcf React Platform Libraries](instructions/pcf-react-platform-libraries.instructions.md): React controls and platform libraries for PCF components
+- [Pcf Sample Components](instructions/pcf-sample-components.instructions.md): How to use and run PCF sample components from the PowerApps-Samples repository
+- [Pcf Tooling](instructions/pcf-tooling.instructions.md): Get Microsoft Power Platform CLI tooling for Power Apps Component Framework
+- [Performance Optimization](instructions/performance-optimization.instructions.md): The most comprehensive, practical, and engineer-authored performance optimization instructions for all languages, frameworks, and stacks. Covers frontend, backend, and database best practices with actionable guidance, scenario-based checklists, troubleshooting, and pro tips.
+- [Php Mcp Server](instructions/php-mcp-server.instructions.md): Best practices for building Model Context Protocol servers in PHP using the official PHP SDK with attribute-based discovery and multiple transport options
+- [Php Symfony](instructions/php-symfony.instructions.md): Symfony development standards aligned with official Symfony Best Practices
+- [Playwright Dotnet](instructions/playwright-dotnet.instructions.md): Playwright .NET test generation instructions
+- [Playwright Python](instructions/playwright-python.instructions.md): Playwright Python AI test generation instructions based on official documentation.
+- [Playwright Typescript](instructions/playwright-typescript.instructions.md): Playwright test generation instructions
+- [Power Apps Canvas Yaml](instructions/power-apps-canvas-yaml.instructions.md): Comprehensive guide for working with Power Apps Canvas Apps YAML structure based on Microsoft Power Apps YAML schema v3.0. Covers Power Fx formulas, control structures, data types, and source control best practices.
+- [Power Apps Code Apps](instructions/power-apps-code-apps.instructions.md): Power Apps Code Apps development standards and best practices for TypeScript, React, and Power Platform integration
+- [Power Bi Custom Visuals Development](instructions/power-bi-custom-visuals-development.instructions.md): Comprehensive Power BI custom visuals development guide covering React, D3.js integration, TypeScript patterns, testing frameworks, and advanced visualization techniques.
+- [Power Bi Data Modeling Best Practices](instructions/power-bi-data-modeling-best-practices.instructions.md): Comprehensive Power BI data modeling best practices based on Microsoft guidance for creating efficient, scalable, and maintainable semantic models using star schema principles.
+- [Power Bi Dax Best Practices](instructions/power-bi-dax-best-practices.instructions.md): Comprehensive Power BI DAX best practices and patterns based on Microsoft guidance for creating efficient, maintainable, and performant DAX formulas.
+- [Power Bi Devops Alm Best Practices](instructions/power-bi-devops-alm-best-practices.instructions.md): Comprehensive guide for Power BI DevOps, Application Lifecycle Management (ALM), CI/CD pipelines, deployment automation, and version control best practices.
+- [Power Bi Report Design Best Practices](instructions/power-bi-report-design-best-practices.instructions.md): Comprehensive Power BI report design and visualization best practices based on Microsoft guidance for creating effective, accessible, and performant reports and dashboards.
+- [Power Bi Security Rls Best Practices](instructions/power-bi-security-rls-best-practices.instructions.md): Comprehensive Power BI Row-Level Security (RLS) and advanced security patterns implementation guide with dynamic security, best practices, and governance strategies.
+- [Power Platform Connector](instructions/power-platform-connector.instructions.md): Comprehensive development guidelines for Power Platform Custom Connectors using JSON Schema definitions. Covers API definitions (Swagger 2.0), API properties, and settings configuration with Microsoft extensions.
+- [Power Platform Mcp Development](instructions/power-platform-mcp-development.instructions.md): Instructions for developing Power Platform custom connectors with Model Context Protocol (MCP) integration for Microsoft Copilot Studio
+- [Powershell Pester 5](instructions/powershell-pester-5.instructions.md): PowerShell Pester testing best practices based on Pester v5 conventions
+- [Powershell](instructions/powershell.instructions.md): PowerShell cmdlet and scripting best practices based on Microsoft guidelines
+- [Prompt](instructions/prompt.instructions.md): Guidelines for creating high-quality prompt files for GitHub Copilot
+- [Python Mcp Server](instructions/python-mcp-server.instructions.md): Instructions for building Model Context Protocol (MCP) servers using the Python SDK
+- [Python](instructions/python.instructions.md): Python coding conventions and guidelines
+- [Quarkus Mcp Server Sse](instructions/quarkus-mcp-server-sse.instructions.md): Quarkus and MCP Server with HTTP SSE transport development standards and instructions
+- [Quarkus](instructions/quarkus.instructions.md): Quarkus development standards and instructions
+- [R](instructions/r.instructions.md): R language and document formats (R, Rmd, Quarto): coding standards and Copilot guidance for idiomatic, safe, and consistent code generation.
+- [Reactjs](instructions/reactjs.instructions.md): ReactJS development standards and best practices
+- [Ruby Mcp Server](instructions/ruby-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Ruby using the official MCP Ruby SDK gem.
+- [Ruby On Rails](instructions/ruby-on-rails.instructions.md): Ruby on Rails coding conventions and guidelines
+- [Rust Mcp Server](instructions/rust-mcp-server.instructions.md): Best practices for building Model Context Protocol servers in Rust using the official rmcp SDK with async/await patterns
+- [Rust](instructions/rust.instructions.md): Rust programming language coding conventions and best practices
+- [Scala2](instructions/scala2.instructions.md): Scala 2.12/2.13 programming language coding conventions and best practices following Databricks style guide for functional programming, type safety, and production code quality.
+- [Security And Owasp](instructions/security-and-owasp.instructions.md): Comprehensive secure coding instructions for all languages and frameworks, based on OWASP Top 10 and industry best practices.
+- [Self Explanatory Code Commenting](instructions/self-explanatory-code-commenting.instructions.md): Guidelines for GitHub Copilot to write comments to achieve self-explanatory code with less comments. Examples are in JavaScript but it should work on any language that has comments.
+- [Shell](instructions/shell.instructions.md): Shell scripting best practices and conventions for bash, sh, zsh, and other shells
+- [Spec Driven Workflow V1](instructions/spec-driven-workflow-v1.instructions.md): Specification-Driven Workflow v1 provides a structured approach to software development, ensuring that requirements are clearly defined, designs are meticulously planned, and implementations are thoroughly documented and validated.
+- [Springboot 4 Migration](instructions/springboot-4-migration.instructions.md): Comprehensive guide for migrating Spring Boot applications from 3.x to 4.0, focusing on Gradle Kotlin DSL and version catalogs
+- [Springboot](instructions/springboot.instructions.md): Guidelines for building Spring Boot base applications
+- [Sql Sp Generation](instructions/sql-sp-generation.instructions.md): Guidelines for generating SQL statements and stored procedures
+- [Svelte](instructions/svelte.instructions.md): Svelte 5 and SvelteKit development standards and best practices for component-based user interfaces and full-stack applications
+- [Swift Mcp Server](instructions/swift-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Swift using the official MCP Swift SDK package.
+- [Tailwind V4 Vite](instructions/tailwind-v4-vite.instructions.md): Tailwind CSS v4+ installation and configuration for Vite projects using the official @tailwindcss/vite plugin
+- [Taming Copilot](instructions/taming-copilot.instructions.md): Prevent Copilot from wreaking havoc across your codebase, keeping it under control.
+- [Tanstack Start Shadcn Tailwind](instructions/tanstack-start-shadcn-tailwind.instructions.md): Guidelines for building TanStack Start applications
+- [Task Implementation](instructions/task-implementation.instructions.md): Instructions for implementing task plans with progressive tracking and change record - Brought to you by microsoft/edge-ai
+- [Tasksync](instructions/tasksync.instructions.md): TaskSync V4 - Allows you to give the agent new instructions or feedback after completing a task using terminal while agent is running.
+- [Terraform Azure](instructions/terraform-azure.instructions.md): Create or modify solutions built using Terraform on Azure.
+- [Terraform Sap Btp](instructions/terraform-sap-btp.instructions.md): Terraform conventions and guidelines for SAP Business Technology Platform (SAP BTP).
+- [Terraform](instructions/terraform.instructions.md): Terraform Conventions and Guidelines
+- [Typescript 5 Es2022](instructions/typescript-5-es2022.instructions.md): Guidelines for TypeScript Development targeting TypeScript 5.x and ES2022 output
+- [Typescript Mcp Server](instructions/typescript-mcp-server.instructions.md): Instructions for building Model Context Protocol (MCP) servers using the TypeScript SDK
+- [Typespec M365 Copilot](instructions/typespec-m365-copilot.instructions.md): Guidelines and best practices for building TypeSpec-based declarative agents and API plugins for Microsoft 365 Copilot
+- [Update Code From Shorthand](instructions/update-code-from-shorthand.instructions.md): Shorthand code will be in the file provided from the prompt or raw data in the prompt, and will be used to update the code file when the prompt has the text `UPDATE CODE FROM SHORTHAND`.
+- [Update Docs On Code Change](instructions/update-docs-on-code-change.instructions.md): Automatically update README.md and documentation files when application code changes require documentation updates
+- [Vsixtoolkit](instructions/vsixtoolkit.instructions.md): Guidelines for Visual Studio extension (VSIX) development using Community.VisualStudio.Toolkit
+- [Vuejs3](instructions/vuejs3.instructions.md): VueJS 3 development standards and best practices with Composition API and TypeScript
+- [Wordpress](instructions/wordpress.instructions.md): Coding, security, and testing rules for WordPress plugins and themes
+
+## Skills
+
+- [agentic-eval](skills/agentic-eval): Patterns and techniques for evaluating and improving AI agent outputs. Use this skill when:
+- Implementing self-critique and reflection loops
+- Building evaluator-optimizer pipelines for quality-critical generation
+- Creating test-driven code refinement workflows
+- Designing rubric-based or LLM-as-judge evaluation systems
+- Adding iterative improvement to agent outputs (code, reports, analysis)
+- Measuring and improving agent response quality
+- [appinsights-instrumentation](skills/appinsights-instrumentation): Instrument a webapp to send useful telemetry data to Azure App Insights
+- [azure-deployment-preflight](skills/azure-deployment-preflight): Performs comprehensive preflight validation of Bicep deployments to Azure, including template syntax validation, what-if analysis, and permission checks. Use this skill before any deployment to Azure to preview changes, identify potential issues, and ensure the deployment will succeed. Activate when users mention deploying to Azure, validating Bicep files, checking deployment permissions, previewing infrastructure changes, running what-if, or preparing for azd provision.
+- [azure-devops-cli](skills/azure-devops-cli): Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.
+- [azure-resource-visualizer](skills/azure-resource-visualizer): Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources. Use this skill when the user asks for a diagram of their Azure resources or help in understanding how the resources relate to each other.
+- [azure-role-selector](skills/azure-role-selector): When user is asking for guidance for which role to assign to an identity given desired permissions, this agent helps them understand the role that will meet the requirements with least privilege access and how to apply that role.
+- [azure-static-web-apps](skills/azure-static-web-apps): Helps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configuring staticwebapp.config.json, adding Azure Functions APIs to SWA, or setting up GitHub Actions CI/CD for Static Web Apps.
+- [chrome-devtools](skills/chrome-devtools): Expert-level browser automation, debugging, and performance analysis using Chrome DevTools MCP. Use for interacting with web pages, capturing screenshots, analyzing network traffic, and profiling performance.
+- [copilot-sdk](skills/copilot-sdk): Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent.
+- [gh-cli](skills/gh-cli): GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line.
+- [git-commit](skills/git-commit): Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping
+- [github-issues](skills/github-issues): Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, or manage issue workflows. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", or any GitHub issue management task.
+- [image-manipulation-image-magick](skills/image-manipulation-image-magick): Process and manipulate images using ImageMagick. Supports resizing, format conversion, batch processing, and retrieving image metadata. Use when working with images, creating thumbnails, resizing wallpapers, or performing batch image operations.
+- [legacy-circuit-mockups](skills/legacy-circuit-mockups): Generate breadboard circuit mockups and visual diagrams using HTML5 Canvas drawing techniques. Use when asked to create circuit layouts, visualize electronic component placements, draw breadboard diagrams, mockup 6502 builds, generate retro computer schematics, or design vintage electronics projects. Supports 555 timers, W65C02S microprocessors, 28C256 EEPROMs, W65C22 VIA chips, 7400-series logic gates, LEDs, resistors, capacitors, switches, buttons, crystals, and wires.
+- [make-skill-template](skills/make-skill-template): Create new Agent Skills for GitHub Copilot from prompts or by duplicating this template. Use when asked to "create a skill", "make a new skill", "scaffold a skill", or when building specialized AI capabilities with bundled resources. Generates SKILL.md files with proper frontmatter, directory structure, and optional scripts/references/assets folders.
+- [markdown-to-html](skills/markdown-to-html): Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.
+- [mcp-cli](skills/mcp-cli): Interface for MCP (Model Context Protocol) servers via CLI. Use when you need to interact with external tools, APIs, or data sources through MCP servers, list available MCP servers/tools, or call MCP tools from command line.
+- [microsoft-code-reference](skills/microsoft-code-reference): Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs.
+- [microsoft-docs](skills/microsoft-docs): Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices.
+- [nuget-manager](skills/nuget-manager): Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions.
+- [plantuml-ascii](skills/plantuml-ascii): Generate ASCII art diagrams using PlantUML text mode. Use when user asks to create ASCII diagrams, text-based diagrams, terminal-friendly diagrams, or mentions plantuml ascii, text diagram, ascii art diagram. Supports: Converting PlantUML diagrams to ASCII art, Creating sequence diagrams, class diagrams, flowcharts in ASCII format, Generating Unicode-enhanced ASCII art with -utxt flag
+- [prd](skills/prd): Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis.
+- [refactor](skills/refactor): Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.
+- [scoutqa-test](skills/scoutqa-test): This skill should be used when the user asks to "test this website", "run exploratory testing", "check for accessibility issues", "verify the login flow works", "find bugs on this page", or requests automated QA testing. Triggers on web application testing scenarios including smoke tests, accessibility audits, e-commerce flows, and user flow validation using ScoutQA CLI. IMPORTANT: Use this skill proactively after implementing web application features to verify they work correctly - don't wait for the user to ask for testing.
+- [snowflake-semanticview](skills/snowflake-semanticview): Create, alter, and validate Snowflake semantic views using Snowflake CLI (snow). Use when asked to build or troubleshoot semantic views/semantic layer definitions with CREATE/ALTER SEMANTIC VIEW, to validate semantic-view DDL against Snowflake via CLI, or to guide Snowflake CLI installation and connection setup.
+- [terraform-azurerm-set-diff-analyzer](skills/terraform-azurerm-set-diff-analyzer): Analyze Terraform plan JSON output for AzureRM Provider to distinguish between false-positive diffs (order-only changes in Set-type attributes) and actual resource changes. Use when reviewing terraform plan output for Azure resources like Application Gateway, Load Balancer, Firewall, Front Door, NSG, and other resources with Set-type attributes that cause spurious diffs due to internal ordering changes.
+- [vscode-ext-commands](skills/vscode-ext-commands): Guidelines for contributing commands in VS Code extensions. Indicates naming convention, visibility, localization and other relevant attributes, following VS Code extension development guidelines, libraries and good practices
+- [vscode-ext-localization](skills/vscode-ext-localization): Guidelines for proper localization of VS Code extensions, following VS Code extension development guidelines, libraries and good practices
+- [web-design-reviewer](skills/web-design-reviewer): This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers on requests like "review website design", "check the UI", "fix the layout", "find design problems". Detects issues with responsive design, accessibility, visual consistency, and layout breakage, then performs fixes at the source code level.
+- [webapp-testing](skills/webapp-testing): Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
+- [winapp-cli](skills/winapp-cli): Windows App Development CLI (winapp) for building, packaging, and deploying Windows applications. Use when asked to initialize Windows app projects, create MSIX packages, generate AppxManifest.xml, manage development certificates, add package identity for debugging, sign packages, or access Windows SDK build tools. Supports .NET, C++, Electron, Rust, Tauri, and cross-platform frameworks targeting Windows.
+- [workiq-copilot](skills/workiq-copilot): Guides the Copilot CLI on how to use the WorkIQ CLI/MCP server to query Microsoft 365 Copilot data (emails, meetings, docs, Teams, people) for live context, summaries, and recommendations.
+
+## Documentation
+
+- [README.md](README.md): Main documentation and getting started guide
+- [CONTRIBUTING.md](CONTRIBUTING.md): Guidelines for contributing to this repository
+- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): Community standards and expectations
+- [SECURITY.md](SECURITY.md): Security policies and reporting
+- [AGENTS.md](AGENTS.md): Project overview and setup commands
+
+## Repository
+
+- **GitHub**: https://github.com/github/awesome-copilot
+- **License**: MIT
+- **Website**: https://github.github.io/awesome-copilot
diff --git a/package.json b/package.json
index 5a392bb4..3e7ba97a 100644
--- a/package.json
+++ b/package.json
@@ -6,7 +6,8 @@
   "private": true,
   "scripts": {
     "start": "npm run build",
-    "build": "node ./eng/update-readme.mjs",
+    "build": "node ./eng/update-readme.mjs && node ./eng/generate-llms-txt.mjs",
+    "llms:generate": "node ./eng/generate-llms-txt.mjs",
     "contributors:add": "all-contributors add",
     "contributors:report": "node ./eng/contributor-report.mjs",
     "contributors:generate": "all-contributors generate",

From 3d1d2c1aa02280ecbbca3562d020a668b7a52e5a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 3 Feb 2026 01:36:00 +0000
Subject: [PATCH 23/49] Fix multiline descriptions in llms.txt to be
 single-line

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 eng/generate-llms-txt.mjs | 10 +++++++---
 llms.txt                  | 12 +++---------
 2 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/eng/generate-llms-txt.mjs b/eng/generate-llms-txt.mjs
index ffa5cb62..d4d9ab1b 100644
--- a/eng/generate-llms-txt.mjs
+++ b/eng/generate-llms-txt.mjs
@@ -47,18 +47,22 @@ function extractName(filePath, fileType) {
  * Extracts the description from a file's frontmatter
  * @param {string} filePath - Path to the file (or directory for skills)
  * @param {string} fileType - Type of file (agent, prompt, instruction, skill)
- * @returns {string} - The description of the resource
+ * @returns {string} - The description of the resource (single line)
  */
 function extractDescription(filePath, fileType) {
   try {
     if (fileType === "skill") {
       // For skills, filePath is the skill directory
       const skillMetadata = parseSkillMetadata(filePath);
-      return skillMetadata?.description || "No description available";
+      const description = skillMetadata?.description || "No description available";
+      // Convert multiline descriptions to single line
+      return description.replace(/\s+/g, " ").trim();
     }
 
     const frontmatter = parseFrontmatter(filePath);
-    return frontmatter?.description || "No description available";
+    const description = frontmatter?.description || "No description available";
+    // Convert multiline descriptions to single line
+    return description.replace(/\s+/g, " ").trim();
   } catch (error) {
     console.error(
       `Error extracting description from ${filePath}: ${error.message}`
diff --git a/llms.txt b/llms.txt
index e91134f0..8fbc0783 100644
--- a/llms.txt
+++ b/llms.txt
@@ -22,7 +22,7 @@ This repository provides resources to customize and enhance GitHub Copilot:
 - [Address Comments](agents/address-comments.agent.md): Address PR comments
 - [ADR Generator](agents/adr-generator.agent.md): Expert agent for creating comprehensive Architectural Decision Records (ADRs) with structured formatting optimized for AI consumption and human readability.
 - [Aem Frontend Specialist](agents/aem-frontend-specialist.agent.md): Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration
-- [Amplitude Experiment Implementation](agents/amplitude-experiment-implementation.agent.md): This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features.
+- [Amplitude Experiment Implementation](agents/amplitude-experiment-implementation.agent.md): This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features.
 - [Api Architect](agents/api-architect.agent.md): Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code.
 - [apify-integration-expert](agents/apify-integration-expert.agent.md): Expert agent for integrating Apify Actors into codebases. Handles Actor selection, workflow design, implementation across JavaScript/TypeScript and Python, testing, and production-ready deployment.
 - [Arch Linux Expert](agents/arch-linux-expert.agent.md): Arch Linux specialist focused on pacman, rolling-release maintenance, and Arch-centric system administration workflows.
@@ -316,7 +316,7 @@ This repository provides resources to customize and enhance GitHub Copilot:
 - [Azure Functions Typescript](instructions/azure-functions-typescript.instructions.md): TypeScript patterns for Azure Functions
 - [Azure Logic Apps Power Automate](instructions/azure-logic-apps-power-automate.instructions.md): Guidelines for developing Azure Logic Apps and Power Automate workflows with best practices for Workflow Definition Language (WDL), integration patterns, and enterprise automation
 - [Azure Verified Modules Bicep](instructions/azure-verified-modules-bicep.instructions.md): Azure Verified Modules (AVM) and Bicep
-- [Azure Verified Modules Terraform](instructions/azure-verified-modules-terraform.instructions.md):  Azure Verified Modules (AVM) and Terraform
+- [Azure Verified Modules Terraform](instructions/azure-verified-modules-terraform.instructions.md): Azure Verified Modules (AVM) and Terraform
 - [Bicep Code Best Practices](instructions/bicep-code-best-practices.instructions.md): Infrastructure as Code with Bicep
 - [Blazor](instructions/blazor.instructions.md): Blazor component and application patterns
 - [Centos Linux](instructions/centos-linux.instructions.md): Guidance for CentOS administration, RHEL-compatible tooling, and SELinux-aware operations.
@@ -473,13 +473,7 @@ This repository provides resources to customize and enhance GitHub Copilot:
 
 ## Skills
 
-- [agentic-eval](skills/agentic-eval): Patterns and techniques for evaluating and improving AI agent outputs. Use this skill when:
-- Implementing self-critique and reflection loops
-- Building evaluator-optimizer pipelines for quality-critical generation
-- Creating test-driven code refinement workflows
-- Designing rubric-based or LLM-as-judge evaluation systems
-- Adding iterative improvement to agent outputs (code, reports, analysis)
-- Measuring and improving agent response quality
+- [agentic-eval](skills/agentic-eval): Patterns and techniques for evaluating and improving AI agent outputs. Use this skill when: - Implementing self-critique and reflection loops - Building evaluator-optimizer pipelines for quality-critical generation - Creating test-driven code refinement workflows - Designing rubric-based or LLM-as-judge evaluation systems - Adding iterative improvement to agent outputs (code, reports, analysis) - Measuring and improving agent response quality
 - [appinsights-instrumentation](skills/appinsights-instrumentation): Instrument a webapp to send useful telemetry data to Azure App Insights
 - [azure-deployment-preflight](skills/azure-deployment-preflight): Performs comprehensive preflight validation of Bicep deployments to Azure, including template syntax validation, what-if analysis, and permission checks. Use this skill before any deployment to Azure to preview changes, identify potential issues, and ensure the deployment will succeed. Activate when users mention deploying to Azure, validating Bicep files, checking deployment permissions, previewing infrastructure changes, running what-if, or preparing for azd provision.
 - [azure-devops-cli](skills/azure-devops-cli): Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.

From a2e8bc2f25c25783654733fa370863ac4f3753f2 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 3 Feb 2026 01:36:34 +0000
Subject: [PATCH 24/49] Add llms.txt documentation to README

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index bec39297..a2f59774 100644
--- a/README.md
+++ b/README.md
@@ -54,6 +54,10 @@ To make it easy to add these customizations to your editor, we have created a [M
 
 </details>
 
+## 📄 llms.txt
+
+This repository includes an [`llms.txt`](llms.txt) file following the [llmstxt.org](https://llmstxt.org/) specification, making it easy for Large Language Models to discover and understand all available agents, prompts, instructions, and skills. This machine-readable file provides a structured overview of the repository's resources with names and descriptions.
+
 ## 🔧 How to Use
 
 ### 🤖 Custom Agents

From 2d996d8ab209769ed8ef1531305632bc4c9146ce Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 3 Feb 2026 01:37:35 +0000
Subject: [PATCH 25/49] Address code review feedback: improve code quality

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 eng/generate-llms-txt.mjs | 29 +++++++++++------------------
 1 file changed, 11 insertions(+), 18 deletions(-)

diff --git a/eng/generate-llms-txt.mjs b/eng/generate-llms-txt.mjs
index d4d9ab1b..621900f5 100644
--- a/eng/generate-llms-txt.mjs
+++ b/eng/generate-llms-txt.mjs
@@ -183,6 +183,8 @@ function generateLlmsTxt() {
       const url = getRelativeUrl(skillDirPath, ROOT_FOLDER);
 
       content += `- [${name}](${url}): ${description}\n`;
+    } else {
+      console.warn(`Warning: Skill directory '${dir}' found without SKILL.md file`);
     }
   });
 
@@ -224,25 +226,16 @@ function main() {
 
     console.log(`✓ llms.txt generated successfully at ${outputPath}`);
 
-    // Count resources
-    const lines = content.split("\n");
-    const agentCount = lines.filter((l) =>
-      l.startsWith("- [") && l.includes("agents/")
-    ).length;
-    const promptCount = lines.filter((l) =>
-      l.startsWith("- [") && l.includes("prompts/")
-    ).length;
-    const instructionCount = lines.filter((l) =>
-      l.startsWith("- [") && l.includes("instructions/")
-    ).length;
-    const skillCount = lines.filter((l) =>
-      l.startsWith("- [") && l.includes("skills/")
-    ).length;
+    // Count resources using a helper function
+    const countResources = (dirName) => {
+      const lines = content.split("\n");
+      return lines.filter((l) => l.startsWith("- [") && l.includes(`${dirName}/`)).length;
+    };
 
-    console.log(`  - ${agentCount} agents`);
-    console.log(`  - ${promptCount} prompts`);
-    console.log(`  - ${instructionCount} instructions`);
-    console.log(`  - ${skillCount} skills`);
+    console.log(`  - ${countResources("agents")} agents`);
+    console.log(`  - ${countResources("prompts")} prompts`);
+    console.log(`  - ${countResources("instructions")} instructions`);
+    console.log(`  - ${countResources("skills")} skills`);
   } catch (error) {
     console.error(`Error generating llms.txt: ${error.message}`);
     process.exit(1);

From 7e23ac9527ac409a1b01f64b8874e6514d02e1b2 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 3 Feb 2026 01:46:18 +0000
Subject: [PATCH 26/49] Generate llms.txt in website/public for GitHub Pages

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 .gitignore                |   4 +
 README.md                 |   2 +-
 eng/generate-llms-txt.mjs |  14 +-
 llms.txt                  | 521 --------------------------------------
 package.json              |   4 +-
 5 files changed, 18 insertions(+), 527 deletions(-)
 delete mode 100644 llms.txt

diff --git a/.gitignore b/.gitignore
index 3452d2df..5167cf50 100644
--- a/.gitignore
+++ b/.gitignore
@@ -7,7 +7,11 @@ reports/
 .DS_Store
 *.tmp
 
+# Generated files
+/llms.txt
+
 # Website build artifacts
 website/dist/
 website/.astro/
 website/public/data/*
+website/public/llms.txt
diff --git a/README.md b/README.md
index a2f59774..5398041d 100644
--- a/README.md
+++ b/README.md
@@ -56,7 +56,7 @@ To make it easy to add these customizations to your editor, we have created a [M
 
 ## 📄 llms.txt
 
-This repository includes an [`llms.txt`](llms.txt) file following the [llmstxt.org](https://llmstxt.org/) specification, making it easy for Large Language Models to discover and understand all available agents, prompts, instructions, and skills. This machine-readable file provides a structured overview of the repository's resources with names and descriptions.
+An [`llms.txt`](https://github.github.io/awesome-copilot/llms.txt) file following the [llmstxt.org](https://llmstxt.org/) specification is available on the GitHub Pages site. This machine-readable file makes it easy for Large Language Models to discover and understand all available agents, prompts, instructions, and skills, providing a structured overview of the repository's resources with names and descriptions.
 
 ## 🔧 How to Use
 
diff --git a/eng/generate-llms-txt.mjs b/eng/generate-llms-txt.mjs
index 621900f5..bdffdfd3 100644
--- a/eng/generate-llms-txt.mjs
+++ b/eng/generate-llms-txt.mjs
@@ -214,13 +214,19 @@ function generateLlmsTxt() {
 
 /**
  * Main function to generate and write the llms.txt file
+ * @param {string} [outputDir] - Optional output directory. Defaults to repository root.
  */
-function main() {
+function main(outputDir = ROOT_FOLDER) {
   console.log("Generating llms.txt file...");
 
   try {
     const content = generateLlmsTxt();
-    const outputPath = path.join(ROOT_FOLDER, "llms.txt");
+    const outputPath = path.join(outputDir, "llms.txt");
+
+    // Ensure output directory exists
+    if (!fs.existsSync(outputDir)) {
+      fs.mkdirSync(outputDir, { recursive: true });
+    }
 
     fs.writeFileSync(outputPath, content, "utf8");
 
@@ -242,4 +248,6 @@ function main() {
   }
 }
 
-main();
+// Support command-line argument for output directory
+const outputDir = process.argv[2];
+main(outputDir);
diff --git a/llms.txt b/llms.txt
deleted file mode 100644
index 8fbc0783..00000000
--- a/llms.txt
+++ /dev/null
@@ -1,521 +0,0 @@
-# Awesome GitHub Copilot
-
-> A community-driven collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot experiences across various domains, languages, and use cases.
-
-## Overview
-
-This repository provides resources to customize and enhance GitHub Copilot:
-
-- **Agents**: Specialized GitHub Copilot agents that integrate with MCP servers
-- **Prompts**: Task-specific prompts for code generation and problem-solving
-- **Instructions**: Coding standards and best practices applied to specific file patterns
-- **Skills**: Self-contained folders with instructions and bundled resources for specialized tasks
-
-## Agents
-
-- [4.1 Beast Mode v3.1](agents/4.1-Beast.agent.md): GPT 4.1 as a top-notch coding agent.
-- [C# Expert](agents/CSharpExpert.agent.md): An agent designed to assist with software development tasks for .NET projects.
-- [Thinking Beast Mode](agents/Thinking-Beast-Mode.agent.md): A transcendent coding agent with quantum cognitive architecture, adversarial intelligence, and unrestricted creative freedom.
-- [Ultimate Transparent Thinking Beast Mode](agents/Ultimate-Transparent-Thinking-Beast-Mode.agent.md): Ultimate Transparent Thinking Beast Mode
-- [WinForms Expert](agents/WinFormsExpert.agent.md): Support development of .NET (OOP) WinForms Designer compatible Apps.
-- [Accessibility](agents/accessibility.agent.md): Expert assistant for web accessibility (WCAG 2.1/2.2), inclusive UX, and a11y testing
-- [Address Comments](agents/address-comments.agent.md): Address PR comments
-- [ADR Generator](agents/adr-generator.agent.md): Expert agent for creating comprehensive Architectural Decision Records (ADRs) with structured formatting optimized for AI consumption and human readability.
-- [Aem Frontend Specialist](agents/aem-frontend-specialist.agent.md): Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration
-- [Amplitude Experiment Implementation](agents/amplitude-experiment-implementation.agent.md): This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features.
-- [Api Architect](agents/api-architect.agent.md): Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code.
-- [apify-integration-expert](agents/apify-integration-expert.agent.md): Expert agent for integrating Apify Actors into codebases. Handles Actor selection, workflow design, implementation across JavaScript/TypeScript and Python, testing, and production-ready deployment.
-- [Arch Linux Expert](agents/arch-linux-expert.agent.md): Arch Linux specialist focused on pacman, rolling-release maintenance, and Arch-centric system administration workflows.
-- [Senior Cloud Architect](agents/arch.agent.md): Expert in modern architecture design patterns, NFR requirements, and creating comprehensive architectural diagrams and documentation
-- [arm-migration-agent](agents/arm-migration.agent.md): Arm Cloud Migration Assistant accelerates moving x86 workloads to Arm infrastructure. It scans the repository for architecture assumptions, portability issues, container base image and dependency incompatibilities, and recommends Arm-optimized changes. It can drive multi-arch container builds, validate performance, and guide optimization, enabling smooth cross-platform deployment directly inside GitHub.
-- [Atlassian Requirements To Jira](agents/atlassian-requirements-to-jira.agent.md): Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow.
-- [azure-iac-exporter](agents/azure-iac-exporter.agent.md): Export existing Azure resources to Infrastructure as Code templates via Azure Resource Graph analysis, Azure Resource Manager API calls, and azure-iac-generator integration. Use this skill when the user asks to export, convert, migrate, or extract existing Azure resources to IaC templates (Bicep, ARM Templates, Terraform, Pulumi).
-- [azure-iac-generator](agents/azure-iac-generator.agent.md): Central hub for generating Infrastructure as Code (Bicep, ARM, Terraform, Pulumi) with format-specific validation and best practices. Use this skill when the user asks to generate, create, write, or build infrastructure code, deployment code, or IaC templates in any format (Bicep, ARM Templates, Terraform, Pulumi).
-- [Azure Logic Apps Expert Mode](agents/azure-logic-apps-expert.agent.md): Expert guidance for Azure Logic Apps development focusing on workflow design, integration patterns, and JSON-based Workflow Definition Language.
-- [Azure Principal Architect mode instructions](agents/azure-principal-architect.agent.md): Provide expert Azure Principal Architect guidance using Azure Well-Architected Framework principles and Microsoft best practices.
-- [Azure SaaS Architect mode instructions](agents/azure-saas-architect.agent.md): Provide expert Azure SaaS Architect guidance focusing on multitenant applications using Azure Well-Architected SaaS principles and Microsoft best practices.
-- [Azure AVM Bicep mode](agents/azure-verified-modules-bicep.agent.md): Create, update, or review Azure IaC in Bicep using Azure Verified Modules (AVM).
-- [Azure AVM Terraform mode](agents/azure-verified-modules-terraform.agent.md): Create, update, or review Azure IaC in Terraform using Azure Verified Modules (AVM).
-- [Bicep Implement](agents/bicep-implement.agent.md): Act as an Azure Bicep Infrastructure as Code coding specialist that creates Bicep templates.
-- [Bicep Plan](agents/bicep-plan.agent.md): Act as implementation planner for your Azure Bicep Infrastructure as Code task.
-- [Blueprint Mode Codex](agents/blueprint-mode-codex.agent.md): Executes structured workflows with strict correctness and maintainability. Enforces a minimal tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling.
-- [Blueprint Mode](agents/blueprint-mode.agent.md): Executes structured workflows (Debug, Express, Main, Loop) with strict correctness and maintainability. Enforces an improved tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling.
-- [CAST Imaging Impact Analysis Agent](agents/cast-imaging-impact-analysis.agent.md): Specialized agent for comprehensive change impact assessment and risk analysis in software systems using CAST Imaging
-- [CAST Imaging Software Discovery Agent](agents/cast-imaging-software-discovery.agent.md): Specialized agent for comprehensive software application discovery and architectural mapping through static code analysis using CAST Imaging
-- [CAST Imaging Structural Quality Advisor Agent](agents/cast-imaging-structural-quality-advisor.agent.md): Specialized agent for identifying, analyzing, and providing remediation guidance for code quality issues using CAST Imaging
-- [CentOS Linux Expert](agents/centos-linux-expert.agent.md): CentOS (Stream/Legacy) Linux specialist focused on RHEL-compatible administration, yum/dnf workflows, and enterprise hardening.
-- [Clojure Interactive Programming](agents/clojure-interactive-programming.agent.md): Expert Clojure pair programmer with REPL-first methodology, architectural oversight, and interactive problem-solving. Enforces quality standards, prevents workarounds, and develops solutions incrementally through live REPL evaluation before file modifications.
-- [VSCode Tour Expert](agents/code-tour.agent.md): Expert agent for creating and maintaining VSCode CodeTour files with comprehensive schema support and best practices
-- [Comet Opik](agents/comet-opik.agent.md): Unified Comet Opik agent for instrumenting LLM apps, managing prompts/projects, auditing prompts, and investigating traces/metrics via the latest Opik MCP server.
-- [Context7-Expert](agents/context7.agent.md): Expert in latest library versions, best practices, and correct syntax using up-to-date documentation
-- [Critical Thinking](agents/critical-thinking.agent.md): Challenge assumptions and encourage critical thinking to ensure the best possible solution and outcomes.
-- [Csharp Dotnet Janitor](agents/csharp-dotnet-janitor.agent.md): Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.
-- [C# MCP Server Expert](agents/csharp-mcp-expert.agent.md): Expert assistant for developing Model Context Protocol (MCP) servers in C#
-- [Custom Agent Foundry](agents/custom-agent-foundry.agent.md): Expert at designing and creating VS Code custom agents with optimal configurations
-- [Debian Linux Expert](agents/debian-linux-expert.agent.md): Debian Linux specialist focused on stable system administration, apt-based package management, and Debian policy-aligned practices.
-- [Debug](agents/debug.agent.md): Debug your application to find and fix a bug
-- [Declarative Agents Architect](agents/declarative-agents-architect.agent.md): No description available
-- [Demonstrate Understanding](agents/demonstrate-understanding.agent.md): Validate user understanding of code, design patterns, and implementation details through guided questioning.
-- [Devils Advocate](agents/devils-advocate.agent.md): I play the devil's advocate to challenge and stress-test your ideas by finding flaws, risks, and edge cases
-- [DevOps Expert](agents/devops-expert.agent.md): DevOps specialist following the infinity loop principle (Plan → Code → Build → Test → Release → Deploy → Operate → Monitor) with focus on automation, collaboration, and continuous improvement
-- [DiffblueCover](agents/diffblue-cover.agent.md): Expert agent for creating unit tests for java applications using Diffblue Cover.
-- [MAUI Expert](agents/dotnet-maui.agent.md): Support development of .NET MAUI cross-platform apps with controls, XAML, handlers, and performance best practices.
-- [Dotnet Upgrade](agents/dotnet-upgrade.agent.md): Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.
-- [droid](agents/droid.agent.md): Provides installation guidance, usage examples, and automation patterns for the Droid CLI, with emphasis on droid exec for CI/CD and non-interactive automation
-- [Drupal Expert](agents/drupal-expert.agent.md): Expert assistant for Drupal development, architecture, and best practices using PHP 8.3+ and modern Drupal patterns
-- [Dynatrace Expert](agents/dynatrace-expert.agent.md): The Dynatrace Expert Agent integrates observability and security capabilities directly into GitHub workflows, enabling development teams to investigate incidents, validate deployments, triage errors, detect performance regressions, validate releases, and manage security vulnerabilities by autonomously analysing traces, logs, and Dynatrace findings. This enables targeted and precise remediation of identified issues directly within the repository.
-- [elasticsearch-agent](agents/elasticsearch-observability.agent.md): Our expert AI assistant for debugging code (O11y), optimizing vector search (RAG), and remediating security threats using live Elastic data.
-- [Electron Code Review Mode Instructions](agents/electron-angular-native.agent.md): Code Review Mode tailored for Electron app with Node.js backend (main), Angular frontend (render), and native integration layer (e.g., AppleScript, shell, or native tooling). Services in other repos are not reviewed here.
-- [Expert Cpp Software Engineer](agents/expert-cpp-software-engineer.agent.md): Provide expert C++ software engineering guidance using modern C++ and industry best practices.
-- [Expert .NET software engineer mode instructions](agents/expert-dotnet-software-engineer.agent.md): Provide expert .NET software engineering guidance using modern software design patterns.
-- [Expert Nextjs Developer](agents/expert-nextjs-developer.agent.md): Expert Next.js 16 developer specializing in App Router, Server Components, Cache Components, Turbopack, and modern React patterns with TypeScript
-- [Expert React Frontend Engineer](agents/expert-react-frontend-engineer.agent.md): Expert React 19.2 frontend engineer specializing in modern hooks, Server Components, Actions, TypeScript, and performance optimization
-- [Fedora Linux Expert](agents/fedora-linux-expert.agent.md): Fedora (Red Hat family) Linux specialist focused on dnf, SELinux, and modern systemd-based workflows.
-- [Gilfoyle](agents/gilfoyle.agent.md): Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code.
-- [GitHub Actions Expert](agents/github-actions-expert.agent.md): GitHub Actions specialist focused on secure CI/CD workflows, action pinning, OIDC authentication, permissions least privilege, and supply-chain security
-- [Go MCP Server Development Expert](agents/go-mcp-expert.agent.md): Expert assistant for building Model Context Protocol (MCP) servers in Go using the official SDK.
-- [GPT 5 Beast Mode](agents/gpt-5-beast-mode.agent.md): Beast Mode 2.0: A powerful autonomous agent tuned specifically for GPT-5 that can solve complex problems by using tools, conducting research, and iterating until the problem is fully resolved.
-- [Hlbpa](agents/hlbpa.agent.md): Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing.
-- [Implementation Plan Generation Mode](agents/implementation-plan.agent.md): Generate an implementation plan for new features or refactoring existing code.
-- [Janitor](agents/janitor.agent.md): Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation.
-- [Java MCP Expert](agents/java-mcp-expert.agent.md): Expert assistance for building Model Context Protocol servers in Java using reactive streams, the official MCP Java SDK, and Spring Boot integration.
-- [JFrog Security Agent](agents/jfrog-sec.agent.md): The dedicated Application Security agent for automated security remediation. Verifies package and version compliance, and suggests vulnerability fixes using JFrog security intelligence.
-- [Kotlin MCP Server Development Expert](agents/kotlin-mcp-expert.agent.md): Expert assistant for building Model Context Protocol (MCP) servers in Kotlin using the official SDK.
-- [Kusto Assistant](agents/kusto-assistant.agent.md): Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server
-- [Laravel Expert Agent](agents/laravel-expert-agent.agent.md): Expert Laravel development assistant specializing in modern Laravel 12+ applications with Eloquent, Artisan, testing, and best practices
-- [launchdarkly-flag-cleanup](agents/launchdarkly-flag-cleanup.agent.md): A specialized GitHub Copilot agent that uses the LaunchDarkly MCP server to safely automate feature flag cleanup workflows. This agent determines removal readiness, identifies the correct forward value, and creates PRs that preserve production behavior while removing obsolete flags and updating stale defaults.
-- [Lingo.dev Localization (i18n) Agent](agents/lingodotdev-i18n.agent.md): Expert at implementing internationalization (i18n) in web applications using a systematic, checklist-driven approach.
-- [MCP M365 Agent Expert](agents/mcp-m365-agent-expert.agent.md): Expert assistant for building MCP-based declarative agents for Microsoft 365 Copilot with Model Context Protocol integration
-- [Mentor](agents/mentor.agent.md): Help mentor the engineer by providing guidance and support.
-- [Meta Agentic Project Scaffold](agents/meta-agentic-project-scaffold.agent.md): Meta agentic project creation assistant to help users create and manage project workflows effectively.
-- [Microsoft Agent Framework Dotnet](agents/microsoft-agent-framework-dotnet.agent.md): Create, update, refactor, explain or work with code using the .NET version of Microsoft Agent Framework.
-- [Microsoft Agent Framework Python](agents/microsoft-agent-framework-python.agent.md): Create, update, refactor, explain or work with code using the Python version of Microsoft Agent Framework.
-- [Microsoft Study Mode](agents/microsoft-study-mode.agent.md): Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers.
-- [Microsoft Learn Contributor](agents/microsoft_learn_contributor.agent.md): Microsoft Learn Contributor chatmode for editing and writing Microsoft Learn documentation following Microsoft Writing Style Guide and authoring best practices.
-- [Modernization](agents/modernization.agent.md): Human-in-the-loop modernization assistant for analyzing, documenting, and planning complete project modernization with architectural recommendations.
-- [Monday Bug Context Fixer](agents/monday-bug-fixer.agent.md): Elite bug-fixing agent that enriches task context from Monday.com platform data. Gathers related items, docs, comments, epics, and requirements to deliver production-quality fixes with comprehensive PRs.
-- [mongodb-performance-advisor](agents/mongodb-performance-advisor.agent.md): Analyze MongoDB database performance, offer query and index optimization insights and provide actionable recommendations to improve overall usage of the database.
-- [MS-SQL Database Administrator](agents/ms-sql-dba.agent.md): Work with Microsoft SQL Server databases using the MS SQL extension.
-- [neo4j-docker-client-generator](agents/neo4j-docker-client-generator.agent.md): AI agent that generates simple, high-quality Python Neo4j client libraries from GitHub issues with proper best practices
-- [Neon Migration Specialist](agents/neon-migration-specialist.agent.md): Safe Postgres migrations with zero-downtime using Neon's branching workflow. Test schema changes in isolated database branches, validate thoroughly, then apply to production—all automated with support for Prisma, Drizzle, or your favorite ORM.
-- [Neon Performance Analyzer](agents/neon-optimization-analyzer.agent.md): Identify and fix slow Postgres queries automatically using Neon's branching workflow. Analyzes execution plans, tests optimizations in isolated database branches, and provides clear before/after performance metrics with actionable code fixes.
-- [octopus-release-notes-with-mcp](agents/octopus-deploy-release-notes-mcp.agent.md): Generate release notes for a release in Octopus Deploy. The tools for this MCP server provide access to the Octopus Deploy APIs.
-- [OpenAPI to Application Generator](agents/openapi-to-application.agent.md): Expert assistant for generating working applications from OpenAPI specifications
-- [PagerDuty Incident Responder](agents/pagerduty-incident-responder.agent.md): Responds to PagerDuty incidents by analyzing incident context, identifying recent code changes, and suggesting fixes via GitHub PRs.
-- [PHP MCP Expert](agents/php-mcp-expert.agent.md): Expert assistant for PHP MCP server development using the official PHP SDK with attribute-based discovery
-- [Pimcore Expert](agents/pimcore-expert.agent.md): Expert Pimcore development assistant specializing in CMS, DAM, PIM, and E-Commerce solutions with Symfony integration
-- [Plan Mode - Strategic Planning & Architecture](agents/plan.agent.md): Strategic planning and architecture assistant focused on thoughtful analysis before implementation. Helps developers understand codebases, clarify requirements, and develop comprehensive implementation strategies.
-- [Planning mode instructions](agents/planner.agent.md): Generate an implementation plan for new features or refactoring existing code.
-- [Platform SRE for Kubernetes](agents/platform-sre-kubernetes.agent.md): SRE-focused Kubernetes specialist prioritizing reliability, safe rollouts/rollbacks, security defaults, and operational verification for production-grade deployments
-- [Playwright Tester Mode](agents/playwright-tester.agent.md): Testing mode for Playwright tests
-- [PostgreSQL Database Administrator](agents/postgresql-dba.agent.md): Work with PostgreSQL databases using the PostgreSQL extension.
-- [Power BI Data Modeling Expert Mode](agents/power-bi-data-modeling-expert.agent.md): Expert Power BI data modeling guidance using star schema principles, relationship design, and Microsoft best practices for optimal model performance and usability.
-- [Power BI DAX Expert Mode](agents/power-bi-dax-expert.agent.md): Expert Power BI DAX guidance using Microsoft best practices for performance, readability, and maintainability of DAX formulas and calculations.
-- [Power BI Performance Expert Mode](agents/power-bi-performance-expert.agent.md): Expert Power BI performance optimization guidance for troubleshooting, monitoring, and improving the performance of Power BI models, reports, and queries.
-- [Power BI Visualization Expert Mode](agents/power-bi-visualization-expert.agent.md): Expert Power BI report design and visualization guidance using Microsoft best practices for creating effective, performant, and user-friendly reports and dashboards.
-- [Power Platform Expert](agents/power-platform-expert.agent.md): Power Platform expert providing guidance on Code Apps, canvas apps, Dataverse, connectors, and Power Platform best practices
-- [Power Platform MCP Integration Expert](agents/power-platform-mcp-integration-expert.agent.md): Expert in Power Platform custom connector development with MCP integration for Copilot Studio - comprehensive knowledge of schemas, protocols, and integration patterns
-- [Create PRD Chat Mode](agents/prd.agent.md): Generate a comprehensive Product Requirements Document (PRD) in Markdown, detailing user stories, acceptance criteria, technical considerations, and metrics. Optionally create GitHub issues upon user confirmation.
-- [Principal Software Engineer](agents/principal-software-engineer.agent.md): Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation.
-- [Prompt Builder](agents/prompt-builder.agent.md): Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai
-- [Prompt Engineer](agents/prompt-engineer.agent.md): A specialized chat mode for analyzing and improving prompts. Every user input is treated as a prompt to be improved. It first provides a detailed analysis of the original prompt within a <reasoning> tag, evaluating it against a systematic framework based on OpenAI's prompt engineering best practices. Following the analysis, it generates a new, improved prompt.
-- [Python MCP Server Expert](agents/python-mcp-expert.agent.md): Expert assistant for developing Model Context Protocol (MCP) servers in Python
-- [Refine Issue](agents/refine-issue.agent.md): Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs
-- [Repo Architect](agents/repo-architect.agent.md): Bootstraps and validates agentic project structures for GitHub Copilot (VS Code) and OpenCode CLI workflows. Run after `opencode /init` or VS Code Copilot initialization to scaffold proper folder hierarchies, instructions, agents, skills, and prompts.
-- [Technical spike research mode](agents/research-technical-spike.agent.md): Systematically research and validate technical spike documents through exhaustive investigation and controlled experimentation.
-- [Ruby MCP Expert](agents/ruby-mcp-expert.agent.md): Expert assistance for building Model Context Protocol servers in Ruby using the official MCP Ruby SDK gem with Rails integration.
-- [Rust Beast Mode](agents/rust-gpt-4.1-beast-mode.agent.md): Rust GPT-4.1 Coding Beast Mode for VS Code
-- [Rust MCP Expert](agents/rust-mcp-expert.agent.md): Expert assistant for Rust MCP server development using the rmcp SDK with tokio async runtime
-- [Salesforce Expert Agent](agents/salesforce-expert.agent.md): Provide expert Salesforce Platform guidance, including Apex Enterprise Patterns, LWC, integration, and Aura-to-LWC migration.
-- [SE: DevOps/CI](agents/se-gitops-ci-specialist.agent.md): DevOps specialist for CI/CD pipelines, deployment debugging, and GitOps workflows focused on making deployments boring and reliable
-- [SE: Product Manager](agents/se-product-manager-advisor.agent.md): Product management guidance for creating GitHub issues, aligning business value with user needs, and making data-driven product decisions
-- [SE: Responsible AI](agents/se-responsible-ai-code.agent.md): Responsible AI specialist ensuring AI works for everyone through bias prevention, accessibility compliance, ethical development, and inclusive design
-- [SE: Security](agents/se-security-reviewer.agent.md): Security-focused code review specialist with OWASP Top 10, Zero Trust, LLM security, and enterprise security standards
-- [SE: Architect](agents/se-system-architecture-reviewer.agent.md): System architecture review specialist with Well-Architected frameworks, design validation, and scalability analysis for AI and distributed systems
-- [SE: Tech Writer](agents/se-technical-writer.agent.md): Technical writing specialist for creating developer documentation, technical blogs, tutorials, and educational content
-- [SE: UX Designer](agents/se-ux-ui-designer.agent.md): Jobs-to-be-Done analysis, user journey mapping, and UX research artifacts for Figma and design workflows
-- [Search Ai Optimization Expert](agents/search-ai-optimization-expert.agent.md): Expert guidance for modern search optimization: SEO, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO) with AI-ready content strategies
-- [Semantic Kernel Dotnet](agents/semantic-kernel-dotnet.agent.md): Create, update, refactor, explain or work with code using the .NET version of Semantic Kernel.
-- [Semantic Kernel Python](agents/semantic-kernel-python.agent.md): Create, update, refactor, explain or work with code using the Python version of Semantic Kernel.
-- [Shopify Expert](agents/shopify-expert.agent.md): Expert Shopify development assistant specializing in theme development, Liquid templating, app development, and Shopify APIs
-- [Simple App Idea Generator](agents/simple-app-idea-generator.agent.md): Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation.
-- [Software Engineer Agent V1](agents/software-engineer-agent-v1.agent.md): Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.
-- [Specification](agents/specification.agent.md): Generate or update specification documents for new or existing functionality.
-- [stackhawk-security-onboarding](agents/stackhawk-security-onboarding.agent.md): Automatically set up StackHawk security testing for your repository with generated configuration and GitHub Actions workflow
-- [Swift MCP Expert](agents/swift-mcp-expert.agent.md): Expert assistance for building Model Context Protocol servers in Swift using modern concurrency features and the official MCP Swift SDK.
-- [Task Planner Instructions](agents/task-planner.agent.md): Task planner for creating actionable implementation plans - Brought to you by microsoft/edge-ai
-- [Task Researcher Instructions](agents/task-researcher.agent.md): Task research specialist for comprehensive project analysis - Brought to you by microsoft/edge-ai
-- [TDD Green Phase - Make Tests Pass Quickly](agents/tdd-green.agent.md): Implement minimal code to satisfy GitHub issue requirements and make failing tests pass without over-engineering.
-- [TDD Red Phase - Write Failing Tests First](agents/tdd-red.agent.md): Guide test-first development by writing failing tests that describe desired behaviour from GitHub issue context before implementation exists.
-- [TDD Refactor Phase - Improve Quality & Security](agents/tdd-refactor.agent.md): Improve code quality, apply security best practices, and enhance design whilst maintaining green tests and GitHub issue compliance.
-- [Tech Debt Remediation Plan](agents/tech-debt-remediation-plan.agent.md): Generate technical debt remediation plans for code, tests, and documentation.
-- [technical-content-evaluator](agents/technical-content-evaluator.agent.md): Elite technical content editor and curriculum architect for evaluating technical training materials, documentation, and educational content. Reviews for technical accuracy, pedagogical excellence, content flow, code validation, and ensures A-grade quality standards.
-- [Azure Terraform IaC Implementation Specialist](agents/terraform-azure-implement.agent.md): Act as an Azure Terraform Infrastructure as Code coding specialist that creates and reviews Terraform for Azure resources.
-- [Azure Terraform Infrastructure Planning](agents/terraform-azure-planning.agent.md): Act as implementation planner for your Azure Terraform Infrastructure as Code task.
-- [Terraform IaC Reviewer](agents/terraform-iac-reviewer.agent.md): Terraform-focused agent that reviews and creates safer IaC changes with emphasis on state safety, least privilege, module patterns, drift detection, and plan/apply discipline
-- [Terraform Agent](agents/terraform.agent.md): Terraform infrastructure specialist with automated HCP Terraform workflows. Leverages Terraform MCP server for registry integration, workspace management, and run orchestration. Generates compliant code using latest provider/module versions, manages private registries, automates variable sets, and orchestrates infrastructure deployments with proper validation and security practices.
-- [TypeScript MCP Server Expert](agents/typescript-mcp-expert.agent.md): Expert assistant for developing Model Context Protocol (MCP) servers in TypeScript
-- [Voidbeast Gpt41enhanced](agents/voidbeast-gpt41enhanced.agent.md): 4.1 voidBeast_GPT41Enhanced 1.0 : a advanced autonomous developer agent, designed for elite full-stack development with enhanced multi-mode capabilities. This latest evolution features sophisticated mode detection, comprehensive research capabilities, and never-ending problem resolution. Plan/Act/Deep Research/Analyzer/Checkpoints(Memory)/Prompt Generator Modes.
-- [Wg Code Alchemist](agents/wg-code-alchemist.agent.md): Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design
-- [Wg Code Sentinel](agents/wg-code-sentinel.agent.md): Ask WG Code Sentinel to review your code for security issues.
-
-## Prompts
-
-- [Add Educational Comments](prompts/add-educational-comments.prompt.md): Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.
-- [Ai Prompt Engineering Safety Review](prompts/ai-prompt-engineering-safety-review.prompt.md): Comprehensive AI prompt engineering safety review and improvement prompt. Analyzes prompts for safety, bias, security vulnerabilities, and effectiveness while providing detailed improvement recommendations with extensive frameworks, testing methodologies, and educational content.
-- [Apple App Store Reviewer](prompts/apple-appstore-reviewer.prompt.md): Serves as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons.
-- [Arch Linux Triage](prompts/arch-linux-triage.prompt.md): Triage and resolve Arch Linux issues with pacman, systemd, and rolling-release best practices.
-- [Architecture Blueprint Generator](prompts/architecture-blueprint-generator.prompt.md): Comprehensive project architecture blueprint generator that analyzes codebases to create detailed architectural documentation. Automatically detects technology stacks and architectural patterns, generates visual diagrams, documents implementation patterns, and provides extensible blueprints for maintaining architectural consistency and guiding new development.
-- [Aspnet Minimal Api Openapi](prompts/aspnet-minimal-api-openapi.prompt.md): Create ASP.NET Minimal API endpoints with proper OpenAPI documentation
-- [Az Cost Optimize](prompts/az-cost-optimize.prompt.md): Analyze Azure resources used in the app (IaC files and/or resources in a target rg) and optimize costs - creating GitHub issues for identified optimizations.
-- [Azure Resource Health Diagnose](prompts/azure-resource-health-diagnose.prompt.md): Analyze Azure resource health, diagnose issues from logs and telemetry, and create a remediation plan for identified problems.
-- [Boost Prompt](prompts/boost-prompt.prompt.md): Interactive prompt refinement workflow: interrogates scope, deliverables, constraints; copies final markdown to clipboard; never writes code. Requires the Joyride extension.
-- [Breakdown Epic Arch](prompts/breakdown-epic-arch.prompt.md): Prompt for creating the high-level technical architecture for an Epic, based on a Product Requirements Document.
-- [Breakdown Epic Pm](prompts/breakdown-epic-pm.prompt.md): Prompt for creating an Epic Product Requirements Document (PRD) for a new epic. This PRD will be used as input for generating a technical architecture specification.
-- [Breakdown Feature Implementation](prompts/breakdown-feature-implementation.prompt.md): Prompt for creating detailed feature implementation plans, following Epoch monorepo structure.
-- [Breakdown Feature Prd](prompts/breakdown-feature-prd.prompt.md): Prompt for creating Product Requirements Documents (PRDs) for new features, based on an Epic.
-- [Breakdown Plan](prompts/breakdown-plan.prompt.md): Issue Planning and Automation prompt that generates comprehensive project plans with Epic > Feature > Story/Enabler > Test hierarchy, dependencies, priorities, and automated tracking.
-- [Breakdown Test](prompts/breakdown-test.prompt.md): Test Planning and Quality Assurance prompt that generates comprehensive test strategies, task breakdowns, and quality validation plans for GitHub projects.
-- [Centos Linux Triage](prompts/centos-linux-triage.prompt.md): Triage and resolve CentOS issues using RHEL-compatible tooling, SELinux-aware practices, and firewalld.
-- [Code Exemplars Blueprint Generator](prompts/code-exemplars-blueprint-generator.prompt.md): Technology-agnostic prompt generator that creates customizable AI prompts for scanning codebases and identifying high-quality code exemplars. Supports multiple programming languages (.NET, Java, JavaScript, TypeScript, React, Angular, Python) with configurable analysis depth, categorization methods, and documentation formats to establish coding standards and maintain consistency across development teams.
-- [Comment Code Generate A Tutorial](prompts/comment-code-generate-a-tutorial.prompt.md): Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial.
-- [Containerize Aspnet Framework](prompts/containerize-aspnet-framework.prompt.md): Containerize an ASP.NET .NET Framework project by creating Dockerfile and .dockerfile files customized for the project.
-- [Containerize Aspnetcore](prompts/containerize-aspnetcore.prompt.md): Containerize an ASP.NET Core project by creating Dockerfile and .dockerfile files customized for the project.
-- [Conventional Commit](prompts/conventional-commit.prompt.md): Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and validation.
-- [Convert Plaintext To Md](prompts/convert-plaintext-to-md.prompt.md): Convert a text-based document to markdown following instructions from prompt, or if a documented option is passed, follow the instructions for that option.
-- [Copilot Instructions Blueprint Generator](prompts/copilot-instructions-blueprint-generator.prompt.md): Technology-agnostic blueprint generator for creating comprehensive copilot-instructions.md files that guide GitHub Copilot to produce code consistent with project standards, architecture patterns, and exact technology versions by analyzing existing codebase patterns and avoiding assumptions.
-- [Cosmosdb Datamodeling](prompts/cosmosdb-datamodeling.prompt.md): Step-by-step guide for capturing key application requirements for NoSQL use-case and produce Azure Cosmos DB Data NoSQL Model design using best practices and common patterns, artifacts_produced: "cosmosdb_requirements.md" file and "cosmosdb_data_model.md" file
-- [Create Agentsmd](prompts/create-agentsmd.prompt.md): Prompt for generating an AGENTS.md file for a repository
-- [Create Architectural Decision Record](prompts/create-architectural-decision-record.prompt.md): Create an Architectural Decision Record (ADR) document for AI-optimized decision documentation.
-- [Create Github Action Workflow Specification](prompts/create-github-action-workflow-specification.prompt.md): Create a formal specification for an existing GitHub Actions CI/CD workflow, optimized for AI consumption and workflow maintenance.
-- [Create Github Issue Feature From Specification](prompts/create-github-issue-feature-from-specification.prompt.md): Create GitHub Issue for feature request from specification file using feature_request.yml template.
-- [Create Github Issues Feature From Implementation Plan](prompts/create-github-issues-feature-from-implementation-plan.prompt.md): Create GitHub Issues from implementation plan phases using feature_request.yml or chore_request.yml templates.
-- [Create Github Issues For Unmet Specification Requirements](prompts/create-github-issues-for-unmet-specification-requirements.prompt.md): Create GitHub Issues for unimplemented requirements from specification files using feature_request.yml template.
-- [Create Github Pull Request From Specification](prompts/create-github-pull-request-from-specification.prompt.md): Create GitHub Pull Request for feature request from specification file using pull_request_template.md template.
-- [Create Implementation Plan](prompts/create-implementation-plan.prompt.md): Create a new implementation plan file for new features, refactoring existing code or upgrading packages, design, architecture or infrastructure.
-- [Create Llms](prompts/create-llms.prompt.md): Create an llms.txt file from scratch based on repository structure following the llms.txt specification at https://llmstxt.org/
-- [Create Oo Component Documentation](prompts/create-oo-component-documentation.prompt.md): Create comprehensive, standardized documentation for object-oriented components following industry best practices and architectural documentation standards.
-- [Create Readme](prompts/create-readme.prompt.md): Create a README.md file for the project
-- [Create Specification](prompts/create-specification.prompt.md): Create a new specification file for the solution, optimized for Generative AI consumption.
-- [Create Spring Boot Java Project](prompts/create-spring-boot-java-project.prompt.md): Create Spring Boot Java Project Skeleton
-- [Create Spring Boot Kotlin Project](prompts/create-spring-boot-kotlin-project.prompt.md): Create Spring Boot Kotlin Project Skeleton
-- [Create Technical Spike](prompts/create-technical-spike.prompt.md): Create time-boxed technical spike documents for researching and resolving critical development decisions before implementation.
-- [Create Tldr Page](prompts/create-tldr-page.prompt.md): Create a tldr page from documentation URLs and command examples, requiring both URL and command name.
-- [Csharp Async](prompts/csharp-async.prompt.md): Get best practices for C# async programming
-- [Csharp Docs](prompts/csharp-docs.prompt.md): Ensure that C# types are documented with XML comments and follow best practices for documentation.
-- [Csharp Mcp Server Generator](prompts/csharp-mcp-server-generator.prompt.md): Generate a complete MCP server project in C# with tools, prompts, and proper configuration
-- [Csharp Mstest](prompts/csharp-mstest.prompt.md): Get best practices for MSTest unit testing, including data-driven tests
-- [Csharp Nunit](prompts/csharp-nunit.prompt.md): Get best practices for NUnit unit testing, including data-driven tests
-- [Csharp Tunit](prompts/csharp-tunit.prompt.md): Get best practices for TUnit unit testing, including data-driven tests
-- [Csharp Xunit](prompts/csharp-xunit.prompt.md): Get best practices for XUnit unit testing, including data-driven tests
-- [Dataverse Python Advanced Patterns](prompts/dataverse-python-advanced-patterns.prompt.md): Generate production code for Dataverse SDK using advanced patterns, error handling, and optimization techniques.
-- [Dataverse Python - Production Code Generator](prompts/dataverse-python-production-code.prompt.md): Generate production-ready Python code using Dataverse SDK with error handling, optimization, and best practices
-- [Dataverse Python Quickstart Generator](prompts/dataverse-python-quickstart.prompt.md): Generate Python SDK setup + CRUD + bulk + paging snippets using official patterns.
-- [Dataverse Python - Use Case Solution Builder](prompts/dataverse-python-usecase-builder.prompt.md): Generate complete solutions for specific Dataverse SDK use cases with architecture recommendations
-- [Debian Linux Triage](prompts/debian-linux-triage.prompt.md): Triage and resolve Debian Linux issues with apt, systemd, and AppArmor-aware guidance.
-- [Declarative Agents](prompts/declarative-agents.prompt.md): Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration
-- [Devops Rollout Plan](prompts/devops-rollout-plan.prompt.md): Generate comprehensive rollout plans with preflight checks, step-by-step deployment, verification signals, rollback procedures, and communication plans for infrastructure and application changes
-- [Documentation Writer](prompts/documentation-writer.prompt.md): Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.
-- [Dotnet Best Practices](prompts/dotnet-best-practices.prompt.md): Ensure .NET/C# code meets best practices for the solution/project.
-- [Dotnet Design Pattern Review](prompts/dotnet-design-pattern-review.prompt.md): Review the C#/.NET code for design pattern implementation and suggest improvements.
-- [.NET Upgrade Analysis Prompts](prompts/dotnet-upgrade.prompt.md): Ready-to-use prompts for comprehensive .NET framework upgrade analysis and execution
-- [Editorconfig](prompts/editorconfig.prompt.md): Generates a comprehensive and best-practice-oriented .editorconfig file based on project analysis and user preferences.
-- [Ef Core](prompts/ef-core.prompt.md): Get best practices for Entity Framework Core
-- [Fedora Linux Triage](prompts/fedora-linux-triage.prompt.md): Triage and resolve Fedora issues with dnf, systemd, and SELinux-aware guidance.
-- [Finalize Agent Prompt](prompts/finalize-agent-prompt.prompt.md): Finalize prompt file using the role of an AI agent to polish the prompt for the end user.
-- [First Ask](prompts/first-ask.prompt.md): Interactive, input-tool powered, task refinement workflow: interrogates scope, deliverables, constraints before carrying out the task; Requires the Joyride extension.
-- [Folder Structure Blueprint Generator](prompts/folder-structure-blueprint-generator.prompt.md): Comprehensive technology-agnostic prompt for analyzing and documenting project folder structures. Auto-detects project types (.NET, Java, React, Angular, Python, Node.js, Flutter), generates detailed blueprints with visualization options, naming conventions, file placement patterns, and extension templates for maintaining consistent code organization across diverse technology stacks.
-- [Gen Specs As Issues](prompts/gen-specs-as-issues.prompt.md): This workflow guides you through a systematic approach to identify missing features, prioritize them, and create detailed specifications for implementation.
-- [Generate Custom Instructions From Codebase](prompts/generate-custom-instructions-from-codebase.prompt.md): Migration and code evolution instructions generator for GitHub Copilot. Analyzes differences between two project versions (branches, commits, or releases) to create precise instructions allowing Copilot to maintain consistency during technology migrations, major refactoring, or framework version upgrades.
-- [Git Flow Branch Creator](prompts/git-flow-branch-creator.prompt.md): Intelligent Git Flow branch creator that analyzes git status/diff and creates appropriate branches following the nvie Git Flow branching model.
-- [Github Copilot Starter](prompts/github-copilot-starter.prompt.md): Set up complete GitHub Copilot configuration for a new project based on technology stack
-- [Go Mcp Server Generator](prompts/go-mcp-server-generator.prompt.md): Generate a complete Go MCP server project with proper structure, dependencies, and implementation using the official github.com/modelcontextprotocol/go-sdk.
-- [Java Add Graalvm Native Image Support](prompts/java-add-graalvm-native-image-support.prompt.md): GraalVM Native Image expert that adds native image support to Java applications, builds the project, analyzes build errors, applies fixes, and iterates until successful compilation using Oracle best practices.
-- [Java Docs](prompts/java-docs.prompt.md): Ensure that Java types are documented with Javadoc comments and follow best practices for documentation.
-- [Java Junit](prompts/java-junit.prompt.md): Get best practices for JUnit 5 unit testing, including data-driven tests
-- [Java Mcp Server Generator](prompts/java-mcp-server-generator.prompt.md): Generate a complete Model Context Protocol server project in Java using the official MCP Java SDK with reactive streams and optional Spring Boot integration.
-- [Java Refactoring Extract Method](prompts/java-refactoring-extract-method.prompt.md): Refactoring using Extract Methods in Java Language
-- [Java Refactoring Remove Parameter](prompts/java-refactoring-remove-parameter.prompt.md): Refactoring using Remove Parameter in Java Language
-- [Java Springboot](prompts/java-springboot.prompt.md): Get best practices for developing applications with Spring Boot.
-- [Javascript Typescript Jest](prompts/javascript-typescript-jest.prompt.md): Best practices for writing JavaScript/TypeScript tests using Jest, including mocking strategies, test structure, and common patterns.
-- [Kotlin Mcp Server Generator](prompts/kotlin-mcp-server-generator.prompt.md): Generate a complete Kotlin MCP server project with proper structure, dependencies, and implementation using the official io.modelcontextprotocol:kotlin-sdk library.
-- [Kotlin Springboot](prompts/kotlin-springboot.prompt.md): Get best practices for developing applications with Spring Boot and Kotlin.
-- [Mcp Copilot Studio Server Generator](prompts/mcp-copilot-studio-server-generator.prompt.md): Generate a complete MCP server implementation optimized for Copilot Studio integration with proper schema constraints and streamable HTTP support
-- [Mcp Create Adaptive Cards](prompts/mcp-create-adaptive-cards.prompt.md): No description available
-- [Mcp Create Declarative Agent](prompts/mcp-create-declarative-agent.prompt.md): No description available
-- [Mcp Deploy Manage Agents](prompts/mcp-deploy-manage-agents.prompt.md): No description available
-- [Memory Merger](prompts/memory-merger.prompt.md): Merges mature lessons from a domain memory file into its instruction file. Syntax: `/memory-merger >domain [scope]` where scope is `global` (default), `user`, `workspace`, or `ws`.
-- [Mkdocs Translations](prompts/mkdocs-translations.prompt.md): Generate a language translation for a mkdocs documentation stack.
-- [Model Recommendation](prompts/model-recommendation.prompt.md): Analyze chatmode or prompt files and recommend optimal AI models based on task complexity, required capabilities, and cost-efficiency
-- [Multi Stage Dockerfile](prompts/multi-stage-dockerfile.prompt.md): Create optimized multi-stage Dockerfiles for any language or framework
-- [My Issues](prompts/my-issues.prompt.md): List my issues in the current repository
-- [My Pull Requests](prompts/my-pull-requests.prompt.md): List my pull requests in the current repository
-- [Next Intl Add Language](prompts/next-intl-add-language.prompt.md): Add new language to a Next.js + next-intl application
-- [Openapi To Application Code](prompts/openapi-to-application-code.prompt.md): Generate a complete, production-ready application from an OpenAPI specification
-- [Php Mcp Server Generator](prompts/php-mcp-server-generator.prompt.md): Generate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK
-- [Playwright Automation Fill In Form](prompts/playwright-automation-fill-in-form.prompt.md): Automate filling in a form using Playwright MCP
-- [Playwright Explore Website](prompts/playwright-explore-website.prompt.md): Website exploration for testing using Playwright MCP
-- [Playwright Generate Test](prompts/playwright-generate-test.prompt.md): Generate a Playwright test based on a scenario using Playwright MCP
-- [Postgresql Code Review](prompts/postgresql-code-review.prompt.md): PostgreSQL-specific code review assistant focusing on PostgreSQL best practices, anti-patterns, and unique quality standards. Covers JSONB operations, array usage, custom types, schema design, function optimization, and PostgreSQL-exclusive security features like Row Level Security (RLS).
-- [Postgresql Optimization](prompts/postgresql-optimization.prompt.md): PostgreSQL-specific development assistant focusing on unique PostgreSQL features, advanced data types, and PostgreSQL-exclusive capabilities. Covers JSONB operations, array types, custom types, range/geometric types, full-text search, window functions, and PostgreSQL extensions ecosystem.
-- [Power Apps Code App Scaffold](prompts/power-apps-code-app-scaffold.prompt.md): Scaffold a complete Power Apps Code App project with PAC CLI setup, SDK integration, and connector configuration
-- [Power Bi Dax Optimization](prompts/power-bi-dax-optimization.prompt.md): Comprehensive Power BI DAX formula optimization prompt for improving performance, readability, and maintainability of DAX calculations.
-- [Power Bi Model Design Review](prompts/power-bi-model-design-review.prompt.md): Comprehensive Power BI data model design review prompt for evaluating model architecture, relationships, and optimization opportunities.
-- [Power Bi Performance Troubleshooting](prompts/power-bi-performance-troubleshooting.prompt.md): Systematic Power BI performance troubleshooting prompt for identifying, diagnosing, and resolving performance issues in Power BI models, reports, and queries.
-- [Power Bi Report Design Consultation](prompts/power-bi-report-design-consultation.prompt.md): Power BI report visualization design prompt for creating effective, user-friendly, and accessible reports with optimal chart selection and layout design.
-- [Power Platform Mcp Connector Suite](prompts/power-platform-mcp-connector-suite.prompt.md): Generate complete Power Platform custom connector with MCP integration for Copilot Studio - includes schema generation, troubleshooting, and validation
-- [Project Workflow Analysis Blueprint Generator](prompts/project-workflow-analysis-blueprint-generator.prompt.md): Comprehensive technology-agnostic prompt generator for documenting end-to-end application workflows. Automatically detects project architecture patterns, technology stacks, and data flow patterns to generate detailed implementation blueprints covering entry points, service layers, data access, error handling, and testing approaches across multiple technologies including .NET, Java/Spring, React, and microservices architectures.
-- [Prompt Builder](prompts/prompt-builder.prompt.md): Guide users through creating high-quality GitHub Copilot prompts with proper structure, tools, and best practices.
-- [Pytest Coverage](prompts/pytest-coverage.prompt.md): Run pytest tests with coverage, discover lines missing coverage, and increase coverage to 100%.
-- [Python Mcp Server Generator](prompts/python-mcp-server-generator.prompt.md): Generate a complete MCP server project in Python with tools, resources, and proper configuration
-- [Readme Blueprint Generator](prompts/readme-blueprint-generator.prompt.md): Intelligent README.md generation prompt that analyzes project documentation structure and creates comprehensive repository documentation. Scans .github/copilot directory files and copilot-instructions.md to extract project information, technology stack, architecture, development workflow, coding standards, and testing approaches while generating well-structured markdown documentation with proper formatting, cross-references, and developer-focused content.
-- [Remember Interactive Programming](prompts/remember-interactive-programming.prompt.md): A micro-prompt that reminds the agent that it is an interactive programmer. Works great in Clojure when Copilot has access to the REPL (probably via Backseat Driver). Will work with any system that has a live REPL that the agent can use. Adapt the prompt with any specific reminders in your workflow and/or workspace.
-- [Remember](prompts/remember.prompt.md): Transforms lessons learned into domain-organized memory instructions (global or workspace). Syntax: `/remember [>domain [scope]] lesson clue` where scope is `global` (default), `user`, `workspace`, or `ws`.
-- [Repo Story Time](prompts/repo-story-time.prompt.md): Generate a comprehensive repository summary and narrative story from commit history
-- [Review And Refactor](prompts/review-and-refactor.prompt.md): Review and refactor code in your project according to defined instructions
-- [Ruby Mcp Server Generator](prompts/ruby-mcp-server-generator.prompt.md): Generate a complete Model Context Protocol server project in Ruby using the official MCP Ruby SDK gem.
-- [rust-mcp-server-generator](prompts/rust-mcp-server-generator.prompt.md): Generate a complete Rust Model Context Protocol server project with tools, prompts, resources, and tests using the official rmcp SDK
-- [Shuffle Json Data](prompts/shuffle-json-data.prompt.md): Shuffle repetitive JSON objects safely by validating schema consistency before randomising entries.
-- [Sql Code Review](prompts/sql-code-review.prompt.md): Universal SQL code review assistant that performs comprehensive security, maintainability, and code quality analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Focuses on SQL injection prevention, access control, code standards, and anti-pattern detection. Complements SQL optimization prompt for complete development coverage.
-- [Sql Optimization](prompts/sql-optimization.prompt.md): Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guidance.
-- [sa-generate](prompts/structured-autonomy-generate.prompt.md): Structured Autonomy Implementation Generator Prompt
-- [sa-implement](prompts/structured-autonomy-implement.prompt.md): Structured Autonomy Implementation Prompt
-- [sa-plan](prompts/structured-autonomy-plan.prompt.md): Structured Autonomy Planning Prompt
-- [Suggest Awesome Github Copilot Agents](prompts/suggest-awesome-github-copilot-agents.prompt.md): Suggest relevant GitHub Copilot Custom Agents files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom agents in this repository, and identifying outdated agents that need updates.
-- [Suggest Awesome Github Copilot Collections](prompts/suggest-awesome-github-copilot-collections.prompt.md): Suggest relevant GitHub Copilot collections from the awesome-copilot repository based on current repository context and chat history, providing automatic download and installation of collection assets, and identifying outdated collection assets that need updates.
-- [Suggest Awesome Github Copilot Instructions](prompts/suggest-awesome-github-copilot-instructions.prompt.md): Suggest relevant GitHub Copilot instruction files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing instructions in this repository, and identifying outdated instructions that need updates.
-- [Suggest Awesome Github Copilot Prompts](prompts/suggest-awesome-github-copilot-prompts.prompt.md): Suggest relevant GitHub Copilot prompt files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing prompts in this repository, and identifying outdated prompts that need updates.
-- [Swift Mcp Server Generator](prompts/swift-mcp-server-generator.prompt.md): Generate a complete Model Context Protocol server project in Swift using the official MCP Swift SDK package.
-- [Technology Stack Blueprint Generator](prompts/technology-stack-blueprint-generator.prompt.md): Comprehensive technology stack blueprint generator that analyzes codebases to create detailed architectural documentation. Automatically detects technology stacks, programming languages, and implementation patterns across multiple platforms (.NET, Java, JavaScript, React, Python). Generates configurable blueprints with version information, licensing details, usage patterns, coding conventions, and visual diagrams. Provides implementation-ready templates and maintains architectural consistency for guided development.
-- [Tldr Prompt](prompts/tldr-prompt.prompt.md): Create tldr summaries for GitHub Copilot files (prompts, agents, instructions, collections), MCP servers, or documentation from URLs and queries.
-- [Typescript Mcp Server Generator](prompts/typescript-mcp-server-generator.prompt.md): Generate a complete MCP server project in TypeScript with tools, resources, and proper configuration
-- [Typespec Api Operations](prompts/typespec-api-operations.prompt.md): Add GET, POST, PATCH, and DELETE operations to a TypeSpec API plugin with proper routing, parameters, and adaptive cards
-- [Typespec Create Agent](prompts/typespec-create-agent.prompt.md): Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot
-- [Typespec Create Api Plugin](prompts/typespec-create-api-plugin.prompt.md): Generate a TypeSpec API plugin with REST operations, authentication, and Adaptive Cards for Microsoft 365 Copilot
-- [Update Avm Modules In Bicep](prompts/update-avm-modules-in-bicep.prompt.md): Update Azure Verified Modules (AVM) to latest versions in Bicep files.
-- [Update Implementation Plan](prompts/update-implementation-plan.prompt.md): Update an existing implementation plan file with new or update requirements to provide new features, refactoring existing code or upgrading packages, design, architecture or infrastructure.
-- [Update Llms](prompts/update-llms.prompt.md): Update the llms.txt file in the root folder to reflect changes in documentation or specifications following the llms.txt specification at https://llmstxt.org/
-- [Update Markdown File Index](prompts/update-markdown-file-index.prompt.md): Update a markdown file section with an index/table of files from a specified folder.
-- [Update Oo Component Documentation](prompts/update-oo-component-documentation.prompt.md): Update existing object-oriented component documentation following industry best practices and architectural documentation standards.
-- [Update Specification](prompts/update-specification.prompt.md): Update an existing specification file for the solution, optimized for Generative AI consumption based on new requirements or updates to any existing code.
-- [Write Coding Standards From File](prompts/write-coding-standards-from-file.prompt.md): Write a coding standards document for a project using the coding styles from the file(s) and/or folder(s) passed as arguments in the prompt.
-
-## Instructions
-
-- [A11y](instructions/a11y.instructions.md): Guidance for creating more accessible code
-- [Agent Skills](instructions/agent-skills.instructions.md): Guidelines for creating high-quality Agent Skills for GitHub Copilot
-- [Agents](instructions/agents.instructions.md): Guidelines for creating custom agent files for GitHub Copilot
-- [Ai Prompt Engineering Safety Best Practices](instructions/ai-prompt-engineering-safety-best-practices.instructions.md): Comprehensive best practices for AI prompt engineering, safety frameworks, bias mitigation, and responsible AI usage for Copilot and LLMs.
-- [Angular](instructions/angular.instructions.md): Angular-specific coding standards and best practices
-- [Ansible](instructions/ansible.instructions.md): Ansible conventions and best practices
-- [Apex](instructions/apex.instructions.md): Guidelines and best practices for Apex development on the Salesforce Platform
-- [Arch Linux](instructions/arch-linux.instructions.md): Guidance for Arch Linux administration, pacman workflows, and rolling-release best practices.
-- [Aspnet Rest Apis](instructions/aspnet-rest-apis.instructions.md): Guidelines for building REST APIs with ASP.NET
-- [Astro](instructions/astro.instructions.md): Astro development standards and best practices for content-driven websites
-- [Azure Devops Pipelines](instructions/azure-devops-pipelines.instructions.md): Best practices for Azure DevOps Pipeline YAML files
-- [Azure Functions Typescript](instructions/azure-functions-typescript.instructions.md): TypeScript patterns for Azure Functions
-- [Azure Logic Apps Power Automate](instructions/azure-logic-apps-power-automate.instructions.md): Guidelines for developing Azure Logic Apps and Power Automate workflows with best practices for Workflow Definition Language (WDL), integration patterns, and enterprise automation
-- [Azure Verified Modules Bicep](instructions/azure-verified-modules-bicep.instructions.md): Azure Verified Modules (AVM) and Bicep
-- [Azure Verified Modules Terraform](instructions/azure-verified-modules-terraform.instructions.md): Azure Verified Modules (AVM) and Terraform
-- [Bicep Code Best Practices](instructions/bicep-code-best-practices.instructions.md): Infrastructure as Code with Bicep
-- [Blazor](instructions/blazor.instructions.md): Blazor component and application patterns
-- [Centos Linux](instructions/centos-linux.instructions.md): Guidance for CentOS administration, RHEL-compatible tooling, and SELinux-aware operations.
-- [Clojure](instructions/clojure.instructions.md): Clojure-specific coding patterns, inline def usage, code block templates, and namespace handling for Clojure development.
-- [Cmake Vcpkg](instructions/cmake-vcpkg.instructions.md): C++ project configuration and package management
-- [Code Review Generic](instructions/code-review-generic.instructions.md): Generic code review instructions that can be customized for any project using GitHub Copilot
-- [Codexer](instructions/codexer.instructions.md): Advanced Python research assistant with Context 7 MCP integration, focusing on speed, reliability, and 10+ years of software development expertise
-- [Coldfusion Cfc](instructions/coldfusion-cfc.instructions.md): ColdFusion Coding Standards for CFC component and application patterns
-- [Coldfusion Cfm](instructions/coldfusion-cfm.instructions.md): ColdFusion cfm files and application patterns
-- [Collections](instructions/collections.instructions.md): Guidelines for creating and managing awesome-copilot collections
-- [Containerization Docker Best Practices](instructions/containerization-docker-best-practices.instructions.md): Comprehensive best practices for creating optimized, secure, and efficient Docker images and managing containers. Covers multi-stage builds, image layer optimization, security scanning, and runtime best practices.
-- [Convert Cassandra To Spring Data Cosmos](instructions/convert-cassandra-to-spring-data-cosmos.instructions.md): Step-by-step guide for converting Spring Boot Cassandra applications to use Azure Cosmos DB with Spring Data Cosmos
-- [Convert Jpa To Spring Data Cosmos](instructions/convert-jpa-to-spring-data-cosmos.instructions.md): Step-by-step guide for converting Spring Boot JPA applications to use Azure Cosmos DB with Spring Data Cosmos
-- [GitHub Copilot SDK C# Instructions](instructions/copilot-sdk-csharp.instructions.md): This file provides guidance on building C# applications using GitHub Copilot SDK.
-- [GitHub Copilot SDK Go Instructions](instructions/copilot-sdk-go.instructions.md): This file provides guidance on building Go applications using GitHub Copilot SDK.
-- [GitHub Copilot SDK Node.js Instructions](instructions/copilot-sdk-nodejs.instructions.md): This file provides guidance on building Node.js/TypeScript applications using GitHub Copilot SDK.
-- [GitHub Copilot SDK Python Instructions](instructions/copilot-sdk-python.instructions.md): This file provides guidance on building Python applications using GitHub Copilot SDK.
-- [Copilot Thought Logging](instructions/copilot-thought-logging.instructions.md): See process Copilot is following where you can edit this to reshape the interaction or save when follow up may be needed
-- [Csharp Ja](instructions/csharp-ja.instructions.md): C# アプリケーション構築指針 by @tsubakimoto
-- [Csharp Ko](instructions/csharp-ko.instructions.md): C# 애플리케이션 개발을 위한 코드 작성 규칙 by @jgkim999
-- [Csharp Mcp Server](instructions/csharp-mcp-server.instructions.md): Instructions for building Model Context Protocol (MCP) servers using the C# SDK
-- [Csharp](instructions/csharp.instructions.md): Guidelines for building C# applications
-- [Dart N Flutter](instructions/dart-n-flutter.instructions.md): Instructions for writing Dart and Flutter code following the official recommendations.
-- [Dataverse Python Advanced Features](instructions/dataverse-python-advanced-features.instructions.md): No description available
-- [Dataverse Python Agentic Workflows](instructions/dataverse-python-agentic-workflows.instructions.md): No description available
-- [Dataverse Python Api Reference](instructions/dataverse-python-api-reference.instructions.md): No description available
-- [Dataverse Python Authentication Security](instructions/dataverse-python-authentication-security.instructions.md): No description available
-- [Dataverse Python Best Practices](instructions/dataverse-python-best-practices.instructions.md): No description available
-- [Dataverse Python Error Handling](instructions/dataverse-python-error-handling.instructions.md): No description available
-- [Dataverse Python File Operations](instructions/dataverse-python-file-operations.instructions.md): No description available
-- [Dataverse Python Modules](instructions/dataverse-python-modules.instructions.md): No description available
-- [Dataverse Python Pandas Integration](instructions/dataverse-python-pandas-integration.instructions.md): No description available
-- [Dataverse Python Performance Optimization](instructions/dataverse-python-performance-optimization.instructions.md): No description available
-- [Dataverse Python Real World Usecases](instructions/dataverse-python-real-world-usecases.instructions.md): No description available
-- [Dataverse Python Sdk](instructions/dataverse-python-sdk.instructions.md): No description available
-- [Dataverse Python Testing Debugging](instructions/dataverse-python-testing-debugging.instructions.md): No description available
-- [Dataverse Python](instructions/dataverse-python.instructions.md): No description available
-- [Debian Linux](instructions/debian-linux.instructions.md): Guidance for Debian-based Linux administration, apt workflows, and Debian policy conventions.
-- [Declarative Agents Microsoft365](instructions/declarative-agents-microsoft365.instructions.md): Comprehensive development guidelines for Microsoft 365 Copilot declarative agents with schema v1.5, TypeSpec integration, and Microsoft 365 Agents Toolkit workflows
-- [Devbox Image Definition](instructions/devbox-image-definition.instructions.md): Authoring recommendations for creating YAML based image definition files for use with Microsoft Dev Box Team Customizations
-- [Devops Core Principles](instructions/devops-core-principles.instructions.md): Foundational instructions covering core DevOps principles, culture (CALMS), and key metrics (DORA) to guide GitHub Copilot in understanding and promoting effective software delivery.
-- [Dotnet Architecture Good Practices](instructions/dotnet-architecture-good-practices.instructions.md): DDD and .NET architecture guidelines
-- [Dotnet Framework](instructions/dotnet-framework.instructions.md): Guidance for working with .NET Framework projects. Includes project structure, C# language version, NuGet management, and best practices.
-- [Dotnet Maui 9 To Dotnet Maui 10 Upgrade](instructions/dotnet-maui-9-to-dotnet-maui-10-upgrade.instructions.md): Instructions for upgrading .NET MAUI applications from version 9 to version 10, including breaking changes, deprecated APIs, and migration strategies for ListView to CollectionView.
-- [Dotnet Maui](instructions/dotnet-maui.instructions.md): .NET MAUI component and application patterns
-- [.NET Framework Upgrade Specialist](instructions/dotnet-upgrade.instructions.md): Specialized agent for comprehensive .NET framework upgrades with progressive tracking and validation
-- [Dotnet Wpf](instructions/dotnet-wpf.instructions.md): .NET WPF component and application patterns
-- [Fedora Linux](instructions/fedora-linux.instructions.md): Guidance for Fedora (Red Hat family) systems, dnf workflows, SELinux, and modern systemd practices.
-- [Genaiscript](instructions/genaiscript.instructions.md): AI-powered script generation guidelines
-- [Generate Modern Terraform Code For Azure](instructions/generate-modern-terraform-code-for-azure.instructions.md): Guidelines for generating modern Terraform code for Azure
-- [Gilfoyle Code Review](instructions/gilfoyle-code-review.instructions.md): Gilfoyle-style code review instructions that channel the sardonic technical supremacy of Silicon Valley's most arrogant systems architect.
-- [Github Actions Ci Cd Best Practices](instructions/github-actions-ci-cd-best-practices.instructions.md): Comprehensive guide for building robust, secure, and efficient CI/CD pipelines using GitHub Actions. Covers workflow structure, jobs, steps, environment variables, secret management, caching, matrix strategies, testing, and deployment strategies.
-- [Go Mcp Server](instructions/go-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk package.
-- [Go](instructions/go.instructions.md): Instructions for writing Go code following idiomatic Go practices and community standards
-- [Html Css Style Color Guide](instructions/html-css-style-color-guide.instructions.md): Color usage guidelines and styling rules for HTML elements to ensure accessible, professional designs.
-- [Instructions](instructions/instructions.instructions.md): Guidelines for creating high-quality custom instruction files for GitHub Copilot
-- [Java 11 To Java 17 Upgrade](instructions/java-11-to-java-17-upgrade.instructions.md): Comprehensive best practices for adopting new Java 17 features since the release of Java 11.
-- [Java 17 To Java 21 Upgrade](instructions/java-17-to-java-21-upgrade.instructions.md): Comprehensive best practices for adopting new Java 21 features since the release of Java 17.
-- [Java 21 To Java 25 Upgrade](instructions/java-21-to-java-25-upgrade.instructions.md): Comprehensive best practices for adopting new Java 25 features since the release of Java 21.
-- [Java Mcp Server](instructions/java-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Java using the official MCP Java SDK with reactive streams and Spring integration.
-- [Java](instructions/java.instructions.md): Guidelines for building Java base applications
-- [Joyride User Project](instructions/joyride-user-project.instructions.md): Expert assistance for Joyride User Script projects - REPL-driven ClojureScript and user space automation of VS Code
-- [Joyride Workspace Automation](instructions/joyride-workspace-automation.instructions.md): Expert assistance for Joyride Workspace automation - REPL-driven and user space ClojureScript automation within specific VS Code workspaces
-- [Kotlin Mcp Server](instructions/kotlin-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Kotlin using the official io.modelcontextprotocol:kotlin-sdk library.
-- [Kubernetes Deployment Best Practices](instructions/kubernetes-deployment-best-practices.instructions.md): Comprehensive best practices for deploying and managing applications on Kubernetes. Covers Pods, Deployments, Services, Ingress, ConfigMaps, Secrets, health checks, resource limits, scaling, and security contexts.
-- [Kubernetes Manifests](instructions/kubernetes-manifests.instructions.md): Best practices for Kubernetes YAML manifests including labeling conventions, security contexts, pod security, resource management, probes, and validation commands
-- [Langchain Python](instructions/langchain-python.instructions.md): Instructions for using LangChain with Python
-- [Localization](instructions/localization.instructions.md): Guidelines for localizing markdown documents
-- [Lwc](instructions/lwc.instructions.md): Guidelines and best practices for developing Lightning Web Components (LWC) on Salesforce Platform.
-- [Makefile](instructions/makefile.instructions.md): Best practices for authoring GNU Make Makefiles
-- [Markdown](instructions/markdown.instructions.md): Documentation and content creation standards
-- [Mcp M365 Copilot](instructions/mcp-m365-copilot.instructions.md): Best practices for building MCP-based declarative agents and API plugins for Microsoft 365 Copilot with Model Context Protocol integration
-- [Memory Bank](instructions/memory-bank.instructions.md): No description available
-- [Mongo Dba](instructions/mongo-dba.instructions.md): Instructions for customizing GitHub Copilot behavior for MONGODB DBA chat mode.
-- [Ms Sql Dba](instructions/ms-sql-dba.instructions.md): Instructions for customizing GitHub Copilot behavior for MS-SQL DBA chat mode.
-- [Nestjs](instructions/nestjs.instructions.md): NestJS development standards and best practices for building scalable Node.js server-side applications
-- [Nextjs Tailwind](instructions/nextjs-tailwind.instructions.md): Next.js + Tailwind development standards and instructions
-- [Nextjs](instructions/nextjs.instructions.md): Best practices for building Next.js (App Router) apps with modern caching, tooling, and server/client boundaries (aligned with Next.js 16.1.1).
-- [Nodejs Javascript Vitest](instructions/nodejs-javascript-vitest.instructions.md): Guidelines for writing Node.js and JavaScript code with Vitest testing
-- [Object Calisthenics](instructions/object-calisthenics.instructions.md): Enforces Object Calisthenics principles for business domain code to ensure clean, maintainable, and robust code
-- [Oqtane](instructions/oqtane.instructions.md): Oqtane Module patterns
-- [Pcf Alm](instructions/pcf-alm.instructions.md): Application lifecycle management (ALM) for PCF code components
-- [Pcf Api Reference](instructions/pcf-api-reference.instructions.md): Complete PCF API reference with all interfaces and their availability in model-driven and canvas apps
-- [Pcf Best Practices](instructions/pcf-best-practices.instructions.md): Best practices and guidance for developing PCF code components
-- [Pcf Canvas Apps](instructions/pcf-canvas-apps.instructions.md): Code components for canvas apps implementation, security, and configuration
-- [Pcf Code Components](instructions/pcf-code-components.instructions.md): Understanding code components structure and implementation
-- [Pcf Community Resources](instructions/pcf-community-resources.instructions.md): PCF community resources including gallery, videos, blogs, and development tools
-- [Pcf Dependent Libraries](instructions/pcf-dependent-libraries.instructions.md): Using dependent libraries in PCF components
-- [Pcf Events](instructions/pcf-events.instructions.md): Define and handle custom events in PCF components
-- [Pcf Fluent Modern Theming](instructions/pcf-fluent-modern-theming.instructions.md): Style components with modern theming using Fluent UI
-- [Pcf Limitations](instructions/pcf-limitations.instructions.md): Limitations and restrictions of Power Apps Component Framework
-- [Pcf Manifest Schema](instructions/pcf-manifest-schema.instructions.md): Complete manifest schema reference for PCF components with all available XML elements
-- [Pcf Model Driven Apps](instructions/pcf-model-driven-apps.instructions.md): Code components for model-driven apps implementation and configuration
-- [Pcf Overview](instructions/pcf-overview.instructions.md): Power Apps Component Framework overview and fundamentals
-- [Pcf Power Pages](instructions/pcf-power-pages.instructions.md): Using code components in Power Pages sites
-- [Pcf React Platform Libraries](instructions/pcf-react-platform-libraries.instructions.md): React controls and platform libraries for PCF components
-- [Pcf Sample Components](instructions/pcf-sample-components.instructions.md): How to use and run PCF sample components from the PowerApps-Samples repository
-- [Pcf Tooling](instructions/pcf-tooling.instructions.md): Get Microsoft Power Platform CLI tooling for Power Apps Component Framework
-- [Performance Optimization](instructions/performance-optimization.instructions.md): The most comprehensive, practical, and engineer-authored performance optimization instructions for all languages, frameworks, and stacks. Covers frontend, backend, and database best practices with actionable guidance, scenario-based checklists, troubleshooting, and pro tips.
-- [Php Mcp Server](instructions/php-mcp-server.instructions.md): Best practices for building Model Context Protocol servers in PHP using the official PHP SDK with attribute-based discovery and multiple transport options
-- [Php Symfony](instructions/php-symfony.instructions.md): Symfony development standards aligned with official Symfony Best Practices
-- [Playwright Dotnet](instructions/playwright-dotnet.instructions.md): Playwright .NET test generation instructions
-- [Playwright Python](instructions/playwright-python.instructions.md): Playwright Python AI test generation instructions based on official documentation.
-- [Playwright Typescript](instructions/playwright-typescript.instructions.md): Playwright test generation instructions
-- [Power Apps Canvas Yaml](instructions/power-apps-canvas-yaml.instructions.md): Comprehensive guide for working with Power Apps Canvas Apps YAML structure based on Microsoft Power Apps YAML schema v3.0. Covers Power Fx formulas, control structures, data types, and source control best practices.
-- [Power Apps Code Apps](instructions/power-apps-code-apps.instructions.md): Power Apps Code Apps development standards and best practices for TypeScript, React, and Power Platform integration
-- [Power Bi Custom Visuals Development](instructions/power-bi-custom-visuals-development.instructions.md): Comprehensive Power BI custom visuals development guide covering React, D3.js integration, TypeScript patterns, testing frameworks, and advanced visualization techniques.
-- [Power Bi Data Modeling Best Practices](instructions/power-bi-data-modeling-best-practices.instructions.md): Comprehensive Power BI data modeling best practices based on Microsoft guidance for creating efficient, scalable, and maintainable semantic models using star schema principles.
-- [Power Bi Dax Best Practices](instructions/power-bi-dax-best-practices.instructions.md): Comprehensive Power BI DAX best practices and patterns based on Microsoft guidance for creating efficient, maintainable, and performant DAX formulas.
-- [Power Bi Devops Alm Best Practices](instructions/power-bi-devops-alm-best-practices.instructions.md): Comprehensive guide for Power BI DevOps, Application Lifecycle Management (ALM), CI/CD pipelines, deployment automation, and version control best practices.
-- [Power Bi Report Design Best Practices](instructions/power-bi-report-design-best-practices.instructions.md): Comprehensive Power BI report design and visualization best practices based on Microsoft guidance for creating effective, accessible, and performant reports and dashboards.
-- [Power Bi Security Rls Best Practices](instructions/power-bi-security-rls-best-practices.instructions.md): Comprehensive Power BI Row-Level Security (RLS) and advanced security patterns implementation guide with dynamic security, best practices, and governance strategies.
-- [Power Platform Connector](instructions/power-platform-connector.instructions.md): Comprehensive development guidelines for Power Platform Custom Connectors using JSON Schema definitions. Covers API definitions (Swagger 2.0), API properties, and settings configuration with Microsoft extensions.
-- [Power Platform Mcp Development](instructions/power-platform-mcp-development.instructions.md): Instructions for developing Power Platform custom connectors with Model Context Protocol (MCP) integration for Microsoft Copilot Studio
-- [Powershell Pester 5](instructions/powershell-pester-5.instructions.md): PowerShell Pester testing best practices based on Pester v5 conventions
-- [Powershell](instructions/powershell.instructions.md): PowerShell cmdlet and scripting best practices based on Microsoft guidelines
-- [Prompt](instructions/prompt.instructions.md): Guidelines for creating high-quality prompt files for GitHub Copilot
-- [Python Mcp Server](instructions/python-mcp-server.instructions.md): Instructions for building Model Context Protocol (MCP) servers using the Python SDK
-- [Python](instructions/python.instructions.md): Python coding conventions and guidelines
-- [Quarkus Mcp Server Sse](instructions/quarkus-mcp-server-sse.instructions.md): Quarkus and MCP Server with HTTP SSE transport development standards and instructions
-- [Quarkus](instructions/quarkus.instructions.md): Quarkus development standards and instructions
-- [R](instructions/r.instructions.md): R language and document formats (R, Rmd, Quarto): coding standards and Copilot guidance for idiomatic, safe, and consistent code generation.
-- [Reactjs](instructions/reactjs.instructions.md): ReactJS development standards and best practices
-- [Ruby Mcp Server](instructions/ruby-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Ruby using the official MCP Ruby SDK gem.
-- [Ruby On Rails](instructions/ruby-on-rails.instructions.md): Ruby on Rails coding conventions and guidelines
-- [Rust Mcp Server](instructions/rust-mcp-server.instructions.md): Best practices for building Model Context Protocol servers in Rust using the official rmcp SDK with async/await patterns
-- [Rust](instructions/rust.instructions.md): Rust programming language coding conventions and best practices
-- [Scala2](instructions/scala2.instructions.md): Scala 2.12/2.13 programming language coding conventions and best practices following Databricks style guide for functional programming, type safety, and production code quality.
-- [Security And Owasp](instructions/security-and-owasp.instructions.md): Comprehensive secure coding instructions for all languages and frameworks, based on OWASP Top 10 and industry best practices.
-- [Self Explanatory Code Commenting](instructions/self-explanatory-code-commenting.instructions.md): Guidelines for GitHub Copilot to write comments to achieve self-explanatory code with less comments. Examples are in JavaScript but it should work on any language that has comments.
-- [Shell](instructions/shell.instructions.md): Shell scripting best practices and conventions for bash, sh, zsh, and other shells
-- [Spec Driven Workflow V1](instructions/spec-driven-workflow-v1.instructions.md): Specification-Driven Workflow v1 provides a structured approach to software development, ensuring that requirements are clearly defined, designs are meticulously planned, and implementations are thoroughly documented and validated.
-- [Springboot 4 Migration](instructions/springboot-4-migration.instructions.md): Comprehensive guide for migrating Spring Boot applications from 3.x to 4.0, focusing on Gradle Kotlin DSL and version catalogs
-- [Springboot](instructions/springboot.instructions.md): Guidelines for building Spring Boot base applications
-- [Sql Sp Generation](instructions/sql-sp-generation.instructions.md): Guidelines for generating SQL statements and stored procedures
-- [Svelte](instructions/svelte.instructions.md): Svelte 5 and SvelteKit development standards and best practices for component-based user interfaces and full-stack applications
-- [Swift Mcp Server](instructions/swift-mcp-server.instructions.md): Best practices and patterns for building Model Context Protocol (MCP) servers in Swift using the official MCP Swift SDK package.
-- [Tailwind V4 Vite](instructions/tailwind-v4-vite.instructions.md): Tailwind CSS v4+ installation and configuration for Vite projects using the official @tailwindcss/vite plugin
-- [Taming Copilot](instructions/taming-copilot.instructions.md): Prevent Copilot from wreaking havoc across your codebase, keeping it under control.
-- [Tanstack Start Shadcn Tailwind](instructions/tanstack-start-shadcn-tailwind.instructions.md): Guidelines for building TanStack Start applications
-- [Task Implementation](instructions/task-implementation.instructions.md): Instructions for implementing task plans with progressive tracking and change record - Brought to you by microsoft/edge-ai
-- [Tasksync](instructions/tasksync.instructions.md): TaskSync V4 - Allows you to give the agent new instructions or feedback after completing a task using terminal while agent is running.
-- [Terraform Azure](instructions/terraform-azure.instructions.md): Create or modify solutions built using Terraform on Azure.
-- [Terraform Sap Btp](instructions/terraform-sap-btp.instructions.md): Terraform conventions and guidelines for SAP Business Technology Platform (SAP BTP).
-- [Terraform](instructions/terraform.instructions.md): Terraform Conventions and Guidelines
-- [Typescript 5 Es2022](instructions/typescript-5-es2022.instructions.md): Guidelines for TypeScript Development targeting TypeScript 5.x and ES2022 output
-- [Typescript Mcp Server](instructions/typescript-mcp-server.instructions.md): Instructions for building Model Context Protocol (MCP) servers using the TypeScript SDK
-- [Typespec M365 Copilot](instructions/typespec-m365-copilot.instructions.md): Guidelines and best practices for building TypeSpec-based declarative agents and API plugins for Microsoft 365 Copilot
-- [Update Code From Shorthand](instructions/update-code-from-shorthand.instructions.md): Shorthand code will be in the file provided from the prompt or raw data in the prompt, and will be used to update the code file when the prompt has the text `UPDATE CODE FROM SHORTHAND`.
-- [Update Docs On Code Change](instructions/update-docs-on-code-change.instructions.md): Automatically update README.md and documentation files when application code changes require documentation updates
-- [Vsixtoolkit](instructions/vsixtoolkit.instructions.md): Guidelines for Visual Studio extension (VSIX) development using Community.VisualStudio.Toolkit
-- [Vuejs3](instructions/vuejs3.instructions.md): VueJS 3 development standards and best practices with Composition API and TypeScript
-- [Wordpress](instructions/wordpress.instructions.md): Coding, security, and testing rules for WordPress plugins and themes
-
-## Skills
-
-- [agentic-eval](skills/agentic-eval): Patterns and techniques for evaluating and improving AI agent outputs. Use this skill when: - Implementing self-critique and reflection loops - Building evaluator-optimizer pipelines for quality-critical generation - Creating test-driven code refinement workflows - Designing rubric-based or LLM-as-judge evaluation systems - Adding iterative improvement to agent outputs (code, reports, analysis) - Measuring and improving agent response quality
-- [appinsights-instrumentation](skills/appinsights-instrumentation): Instrument a webapp to send useful telemetry data to Azure App Insights
-- [azure-deployment-preflight](skills/azure-deployment-preflight): Performs comprehensive preflight validation of Bicep deployments to Azure, including template syntax validation, what-if analysis, and permission checks. Use this skill before any deployment to Azure to preview changes, identify potential issues, and ensure the deployment will succeed. Activate when users mention deploying to Azure, validating Bicep files, checking deployment permissions, previewing infrastructure changes, running what-if, or preparing for azd provision.
-- [azure-devops-cli](skills/azure-devops-cli): Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.
-- [azure-resource-visualizer](skills/azure-resource-visualizer): Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources. Use this skill when the user asks for a diagram of their Azure resources or help in understanding how the resources relate to each other.
-- [azure-role-selector](skills/azure-role-selector): When user is asking for guidance for which role to assign to an identity given desired permissions, this agent helps them understand the role that will meet the requirements with least privilege access and how to apply that role.
-- [azure-static-web-apps](skills/azure-static-web-apps): Helps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configuring staticwebapp.config.json, adding Azure Functions APIs to SWA, or setting up GitHub Actions CI/CD for Static Web Apps.
-- [chrome-devtools](skills/chrome-devtools): Expert-level browser automation, debugging, and performance analysis using Chrome DevTools MCP. Use for interacting with web pages, capturing screenshots, analyzing network traffic, and profiling performance.
-- [copilot-sdk](skills/copilot-sdk): Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent.
-- [gh-cli](skills/gh-cli): GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line.
-- [git-commit](skills/git-commit): Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping
-- [github-issues](skills/github-issues): Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, or manage issue workflows. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", or any GitHub issue management task.
-- [image-manipulation-image-magick](skills/image-manipulation-image-magick): Process and manipulate images using ImageMagick. Supports resizing, format conversion, batch processing, and retrieving image metadata. Use when working with images, creating thumbnails, resizing wallpapers, or performing batch image operations.
-- [legacy-circuit-mockups](skills/legacy-circuit-mockups): Generate breadboard circuit mockups and visual diagrams using HTML5 Canvas drawing techniques. Use when asked to create circuit layouts, visualize electronic component placements, draw breadboard diagrams, mockup 6502 builds, generate retro computer schematics, or design vintage electronics projects. Supports 555 timers, W65C02S microprocessors, 28C256 EEPROMs, W65C22 VIA chips, 7400-series logic gates, LEDs, resistors, capacitors, switches, buttons, crystals, and wires.
-- [make-skill-template](skills/make-skill-template): Create new Agent Skills for GitHub Copilot from prompts or by duplicating this template. Use when asked to "create a skill", "make a new skill", "scaffold a skill", or when building specialized AI capabilities with bundled resources. Generates SKILL.md files with proper frontmatter, directory structure, and optional scripts/references/assets folders.
-- [markdown-to-html](skills/markdown-to-html): Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.
-- [mcp-cli](skills/mcp-cli): Interface for MCP (Model Context Protocol) servers via CLI. Use when you need to interact with external tools, APIs, or data sources through MCP servers, list available MCP servers/tools, or call MCP tools from command line.
-- [microsoft-code-reference](skills/microsoft-code-reference): Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs.
-- [microsoft-docs](skills/microsoft-docs): Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices.
-- [nuget-manager](skills/nuget-manager): Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions.
-- [plantuml-ascii](skills/plantuml-ascii): Generate ASCII art diagrams using PlantUML text mode. Use when user asks to create ASCII diagrams, text-based diagrams, terminal-friendly diagrams, or mentions plantuml ascii, text diagram, ascii art diagram. Supports: Converting PlantUML diagrams to ASCII art, Creating sequence diagrams, class diagrams, flowcharts in ASCII format, Generating Unicode-enhanced ASCII art with -utxt flag
-- [prd](skills/prd): Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis.
-- [refactor](skills/refactor): Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.
-- [scoutqa-test](skills/scoutqa-test): This skill should be used when the user asks to "test this website", "run exploratory testing", "check for accessibility issues", "verify the login flow works", "find bugs on this page", or requests automated QA testing. Triggers on web application testing scenarios including smoke tests, accessibility audits, e-commerce flows, and user flow validation using ScoutQA CLI. IMPORTANT: Use this skill proactively after implementing web application features to verify they work correctly - don't wait for the user to ask for testing.
-- [snowflake-semanticview](skills/snowflake-semanticview): Create, alter, and validate Snowflake semantic views using Snowflake CLI (snow). Use when asked to build or troubleshoot semantic views/semantic layer definitions with CREATE/ALTER SEMANTIC VIEW, to validate semantic-view DDL against Snowflake via CLI, or to guide Snowflake CLI installation and connection setup.
-- [terraform-azurerm-set-diff-analyzer](skills/terraform-azurerm-set-diff-analyzer): Analyze Terraform plan JSON output for AzureRM Provider to distinguish between false-positive diffs (order-only changes in Set-type attributes) and actual resource changes. Use when reviewing terraform plan output for Azure resources like Application Gateway, Load Balancer, Firewall, Front Door, NSG, and other resources with Set-type attributes that cause spurious diffs due to internal ordering changes.
-- [vscode-ext-commands](skills/vscode-ext-commands): Guidelines for contributing commands in VS Code extensions. Indicates naming convention, visibility, localization and other relevant attributes, following VS Code extension development guidelines, libraries and good practices
-- [vscode-ext-localization](skills/vscode-ext-localization): Guidelines for proper localization of VS Code extensions, following VS Code extension development guidelines, libraries and good practices
-- [web-design-reviewer](skills/web-design-reviewer): This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers on requests like "review website design", "check the UI", "fix the layout", "find design problems". Detects issues with responsive design, accessibility, visual consistency, and layout breakage, then performs fixes at the source code level.
-- [webapp-testing](skills/webapp-testing): Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
-- [winapp-cli](skills/winapp-cli): Windows App Development CLI (winapp) for building, packaging, and deploying Windows applications. Use when asked to initialize Windows app projects, create MSIX packages, generate AppxManifest.xml, manage development certificates, add package identity for debugging, sign packages, or access Windows SDK build tools. Supports .NET, C++, Electron, Rust, Tauri, and cross-platform frameworks targeting Windows.
-- [workiq-copilot](skills/workiq-copilot): Guides the Copilot CLI on how to use the WorkIQ CLI/MCP server to query Microsoft 365 Copilot data (emails, meetings, docs, Teams, people) for live context, summaries, and recommendations.
-
-## Documentation
-
-- [README.md](README.md): Main documentation and getting started guide
-- [CONTRIBUTING.md](CONTRIBUTING.md): Guidelines for contributing to this repository
-- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): Community standards and expectations
-- [SECURITY.md](SECURITY.md): Security policies and reporting
-- [AGENTS.md](AGENTS.md): Project overview and setup commands
-
-## Repository
-
-- **GitHub**: https://github.com/github/awesome-copilot
-- **License**: MIT
-- **Website**: https://github.github.io/awesome-copilot
diff --git a/package.json b/package.json
index 3e7ba97a..e6150822 100644
--- a/package.json
+++ b/package.json
@@ -6,7 +6,7 @@
   "private": true,
   "scripts": {
     "start": "npm run build",
-    "build": "node ./eng/update-readme.mjs && node ./eng/generate-llms-txt.mjs",
+    "build": "node ./eng/update-readme.mjs",
     "llms:generate": "node ./eng/generate-llms-txt.mjs",
     "contributors:add": "all-contributors add",
     "contributors:report": "node ./eng/contributor-report.mjs",
@@ -18,7 +18,7 @@
     "skill:create": "node ./eng/create-skill.mjs",
     "website:data": "node ./eng/generate-website-data.mjs",
     "website:dev": "npm run website:data && npm run --prefix website dev",
-    "website:build": "npm run build && npm run website:data && npm run --prefix website build",
+    "website:build": "npm run build && npm run website:data && node ./eng/generate-llms-txt.mjs website/public && npm run --prefix website build",
     "website:preview": "npm run --prefix website preview"
   },
   "repository": {

From a2bd4fda47e736496014225c790bf3406e7bf6f4 Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 12:48:47 +1100
Subject: [PATCH 27/49] Update eng/generate-llms-txt.mjs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 eng/generate-llms-txt.mjs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/eng/generate-llms-txt.mjs b/eng/generate-llms-txt.mjs
index bdffdfd3..7b95fdc7 100644
--- a/eng/generate-llms-txt.mjs
+++ b/eng/generate-llms-txt.mjs
@@ -78,7 +78,8 @@ function extractDescription(filePath, fileType) {
  * @returns {string} - Relative URL path
  */
 function getRelativeUrl(filePath, baseDir) {
-  const relativePath = path.relative(ROOT_FOLDER, filePath);
+  const basePath = baseDir || ROOT_FOLDER;
+  const relativePath = path.relative(basePath, filePath);
   return relativePath.replace(/\\/g, "/");
 }
 

From fd509d2f0d90d4c816580883dc68977d57ed1d87 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 3 Feb 2026 02:50:08 +0000
Subject: [PATCH 28/49] Link skills to SKILL.md files instead of directories

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
---
 eng/generate-llms-txt.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/eng/generate-llms-txt.mjs b/eng/generate-llms-txt.mjs
index 7b95fdc7..cdf88ec6 100644
--- a/eng/generate-llms-txt.mjs
+++ b/eng/generate-llms-txt.mjs
@@ -181,7 +181,7 @@ function generateLlmsTxt() {
     if (fs.existsSync(skillPath)) {
       const name = extractName(skillDirPath, "skill");
       const description = extractDescription(skillDirPath, "skill");
-      const url = getRelativeUrl(skillDirPath, ROOT_FOLDER);
+      const url = getRelativeUrl(skillPath, ROOT_FOLDER);
 
       content += `- [${name}](${url}): ${description}\n`;
     } else {

From 9afab17e01358f26f967be3dcb6090048cbf4a30 Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 14:11:03 +1100
Subject: [PATCH 29/49] Cleaning up the name of a lot of agents

---
 AGENTS.md                                     |  1 +
 agents/accessibility.agent.md                 |  1 +
 agents/address-comments.agent.md              |  1 +
 agents/aem-frontend-specialist.agent.md       |  1 +
 agents/api-architect.agent.md                 |  5 +-
 .../atlassian-requirements-to-jira.agent.md   | 33 ++++++------
 agents/bicep-implement.agent.md               |  1 +
 agents/bicep-plan.agent.md                    |  1 +
 agents/blueprint-mode-codex.agent.md          |  1 +
 agents/blueprint-mode.agent.md                |  1 +
 agents/critical-thinking.agent.md             |  1 +
 agents/csharp-dotnet-janitor.agent.md         |  1 +
 agents/debug.agent.md                         |  1 +
 agents/declarative-agents-architect.agent.md  |  1 +
 agents/demonstrate-understanding.agent.md     |  1 +
 agents/devils-advocate.agent.md               |  1 +
 agents/dotnet-upgrade.agent.md                |  3 +-
 agents/drupal-expert.agent.md                 |  1 +
 agents/expert-cpp-software-engineer.agent.md  |  1 +
 agents/expert-nextjs-developer.agent.md       |  1 +
 agents/gilfoyle.agent.md                      |  1 +
 agents/hlbpa.agent.md                         |  1 +
 agents/janitor.agent.md                       |  1 +
 agents/kusto-assistant.agent.md               |  1 +
 agents/laravel-expert-agent.agent.md          |  1 +
 agents/mentor.agent.md                        |  1 +
 .../microsoft-agent-framework-dotnet.agent.md |  1 +
 .../microsoft-agent-framework-python.agent.md |  1 +
 agents/microsoft-study-mode.agent.md          |  1 +
 agents/microsoft_learn_contributor.agent.md   |  1 +
 agents/modernization.agent.md                 |  1 +
 agents/pimcore-expert.agent.md                |  1 +
 agents/principal-software-engineer.agent.md   |  1 +
 agents/prompt-builder.agent.md                |  1 +
 agents/prompt-engineer.agent.md               |  1 +
 agents/refine-issue.agent.md                  |  3 +-
 agents/repo-architect.agent.md                |  1 +
 agents/search-ai-optimization-expert.agent.md |  1 +
 agents/semantic-kernel-dotnet.agent.md        |  1 +
 agents/semantic-kernel-python.agent.md        |  1 +
 agents/shopify-expert.agent.md                |  1 +
 agents/simple-app-idea-generator.agent.md     |  1 +
 agents/software-engineer-agent-v1.agent.md    |  1 +
 agents/specification.agent.md                 |  1 +
 agents/tech-debt-remediation-plan.agent.md    |  1 +
 agents/voidbeast-gpt41enhanced.agent.md       |  1 +
 agents/wg-code-alchemist.agent.md             |  1 +
 agents/wg-code-sentinel.agent.md              |  1 +
 docs/README.agents.md                         | 54 +++++++++----------
 eng/generate-website-data.mjs                 |  1 -
 eng/update-readme.mjs                         |  7 +--
 prompts/editorconfig.prompt.md                |  2 +-
 .../java-refactoring-extract-method.prompt.md |  2 +-
 ...ava-refactoring-remove-parameter.prompt.md |  2 +-
 ...remember-interactive-programming.prompt.md |  2 +-
 55 files changed, 100 insertions(+), 58 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 352ba737..1a1c4c95 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -172,6 +172,7 @@ For instruction files (*.instructions.md):
 For agent files (*.agent.md):
 - [ ] Has markdown front matter
 - [ ] Has non-empty `description` field wrapped in single quotes
+- [ ] Has `name` field with human-readable name (e.g., "Address Comments" not "address-comments")
 - [ ] File name is lower case with hyphens
 - [ ] Includes `model` field (strongly recommended)
 - [ ] Considers using `tools` field
diff --git a/agents/accessibility.agent.md b/agents/accessibility.agent.md
index 69cd49fd..10ec5d0e 100644
--- a/agents/accessibility.agent.md
+++ b/agents/accessibility.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert assistant for web accessibility (WCAG 2.1/2.2), inclusive UX, and a11y testing'
+name: 'Accessibility Expert'
 model: GPT-4.1
 tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI']
 ---
diff --git a/agents/address-comments.agent.md b/agents/address-comments.agent.md
index 5a728f81..191c533c 100644
--- a/agents/address-comments.agent.md
+++ b/agents/address-comments.agent.md
@@ -1,5 +1,6 @@
 ---
 description: "Address PR comments"
+name: 'Universal PR Comment Addresser'
 tools:
   [
     "changes",
diff --git a/agents/aem-frontend-specialist.agent.md b/agents/aem-frontend-specialist.agent.md
index 7f172aeb..1019cb93 100644
--- a/agents/aem-frontend-specialist.agent.md
+++ b/agents/aem-frontend-specialist.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration'
+name: 'AEM Front-End Specialist'
 model: 'GPT-4.1'
 tools: ['codebase', 'edit/editFiles', 'web/fetch', 'githubRepo', 'figma-dev-mode-mcp-server']
 ---
diff --git a/agents/api-architect.agent.md b/agents/api-architect.agent.md
index 1739e98f..9d59a1af 100644
--- a/agents/api-architect.agent.md
+++ b/agents/api-architect.agent.md
@@ -1,12 +1,13 @@
 ---
 description: 'Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code.'
+name: 'API Architect'
 ---
 # API Architect mode instructions
 
-Your primary goal is to act on the mandatory and optional API aspects outlined below and generate a design and working code for connectivity from a client service to an external service. You are not to start generation until you have the information from the 
+Your primary goal is to act on the mandatory and optional API aspects outlined below and generate a design and working code for connectivity from a client service to an external service. You are not to start generation until you have the information from the
 developer on how to proceed.  The developer will say, "generate" to begin the code generation process.  Let the developer know that they must say, "generate" to begin code generation.
 
-Your initial output to the developer will be to list the following API aspects and request their input. 
+Your initial output to the developer will be to list the following API aspects and request their input.
 
 ## The following API aspects will be the consumables for producing a working solution in code:
 
diff --git a/agents/atlassian-requirements-to-jira.agent.md b/agents/atlassian-requirements-to-jira.agent.md
index 41f643ca..5597341b 100644
--- a/agents/atlassian-requirements-to-jira.agent.md
+++ b/agents/atlassian-requirements-to-jira.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow.'
+name: 'Atlassian Requirements to Jira'
 tools: ['atlassian']
 ---
 
@@ -13,7 +14,7 @@ tools: ['atlassian']
 
 ### Jira Operation Safeguards:
 - **MAXIMUM** 20 epics per batch operation
-- **MAXIMUM** 50 user stories per batch operation  
+- **MAXIMUM** 50 user stories per batch operation
 - **ALWAYS** require explicit user approval before creating/updating any Jira items
 - **NEVER** perform operations without showing preview and getting confirmation
 - **VALIDATE** project permissions before attempting any create/update operations
@@ -119,17 +120,17 @@ For each epic, create detailed user stories with smart features:
   As a [user type/persona]
   I want [specific functionality]
   So that [business benefit/value]
-  
+
   ## Background Context
   [Additional context about why this story is needed]
   ```
 
 #### Story Details:
-- **Acceptance Criteria**: 
+- **Acceptance Criteria**:
   - Minimum 3-5 specific, testable criteria
   - Use Given/When/Then format when appropriate
   - Include edge cases and error scenarios
-  
+
 - **Definition of Done**:
   - Code complete and reviewed
   - Unit tests written and passing
@@ -178,7 +179,7 @@ I will start by asking:
 ### Step 2: Requirements Input
 Provide your requirements document in any of these ways:
 - Upload a markdown file
-- Paste text directly  
+- Paste text directly
 - Reference a file path to read
 - Provide a URL to requirements
 
@@ -192,12 +193,12 @@ I will automatically:
 ### Step 4: Smart Analysis & Planning
 I will:
 - Analyze requirements and identify new epics needed
-- Compare against existing content to avoid duplication  
+- Compare against existing content to avoid duplication
 - Present proposed epic/story structure with conflict resolution:
   ```
   📋 ANALYSIS SUMMARY
   ✅ New Epics to Create: 5
-  ⚠️  Potential Duplicates Found: 2  
+  ⚠️  Potential Duplicates Found: 2
   🔄 Existing Items to Update: 3
   ❓ Clarification Needed: 1
   ```
@@ -210,7 +211,7 @@ For any existing items that need updates, I will show:
 CURRENT DESCRIPTION:
 Basic user login system
 
-PROPOSED DESCRIPTION:  
+PROPOSED DESCRIPTION:
 Comprehensive user authentication system including:
 - Multi-factor authentication
 - Social login integration
@@ -260,8 +261,8 @@ Before creating anything, I will search for existing content using **SANITIZED J
 # SECURITY: All search terms are sanitized to prevent JQL injection
 # Example with properly escaped terms:
 project = YOUR_PROJECT AND (
-  summary ~ "authentication" OR 
-  summary ~ "user management" OR 
+  summary ~ "authentication" OR
+  summary ~ "user management" OR
   description ~ "employee database"
 ) ORDER BY created DESC
 ```
@@ -279,7 +280,7 @@ For existing items, I will:
 
 ### Required Information (Asked Interactively):
 - **Jira Project Key**: Will be selected from available projects list
-- **Update Preferences**: 
+- **Update Preferences**:
   - "Should I update existing items if they're similar but incomplete?"
   - "What's your preference for handling duplicates?"
   - "Should I merge similar stories or keep them separate?"
@@ -343,7 +344,7 @@ Step 1: Let me get your available Jira projects...
 
 📋 Available Projects:
 1. HRDB - HR Database Project
-2. DEV - Development Tasks  
+2. DEV - Development Tasks
 3. PROJ - Main Project Backlog
 
 ❓ Which project should I use? (Enter number or project key)
@@ -361,7 +362,7 @@ Found potential duplicates:
 
 ❓ How should I handle this?
 1. Skip creating new epic (use existing HRDB-15)
-2. Create new epic with different focus  
+2. Create new epic with different focus
 3. Update existing epic with new requirements
 4. Show me detailed comparison first
 ```
@@ -374,13 +375,13 @@ DESCRIPTION CHANGES:
 Current: "Basic employee data management"
 Proposed: "Comprehensive employee profile management including:
 - Personal information and contact details
-- Employment history and job assignments  
+- Employment history and job assignments
 - Document storage and management
 - Integration with payroll systems"
 
 ACCEPTANCE CRITERIA:
 + NEW: "System stores emergency contact information"
-+ NEW: "Employees can upload profile photos"  
++ NEW: "Employees can upload profile photos"
 + NEW: "Integration with payroll system for salary data"
 ~ MODIFIED: "Data validation" → "Comprehensive data validation with error handling"
 
@@ -415,7 +416,7 @@ LABELS: +hr-system, +database, +integration
 ❌ **FORBIDDEN**: File system access beyond provided requirements documents
 ❌ **FORBIDDEN**: Mass deletion or destructive operations without multiple confirmations
 
-Ready to intelligently transform your requirements into actionable Jira backlog items with smart duplicate detection and change management! 
+Ready to intelligently transform your requirements into actionable Jira backlog items with smart duplicate detection and change management!
 
 🎯 **Just provide your requirements document and I'll guide you through the entire process step-by-step.**
 
diff --git a/agents/bicep-implement.agent.md b/agents/bicep-implement.agent.md
index 62c7659f..c52383e7 100644
--- a/agents/bicep-implement.agent.md
+++ b/agents/bicep-implement.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Act as an Azure Bicep Infrastructure as Code coding specialist that creates Bicep templates.'
+name: 'Bicep Specialist'
 tools:
   [ 'edit/editFiles', 'web/fetch', 'runCommands', 'terminalLastCommand', 'get_bicep_best_practices', 'azure_get_azure_verified_module', 'todos' ]
 ---
diff --git a/agents/bicep-plan.agent.md b/agents/bicep-plan.agent.md
index 23c83a05..2bc5fa1e 100644
--- a/agents/bicep-plan.agent.md
+++ b/agents/bicep-plan.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Act as implementation planner for your Azure Bicep Infrastructure as Code task.'
+name: 'Bicep Planning'
 tools:
   [ 'edit/editFiles', 'web/fetch', 'microsoft-docs', 'azure_design_architecture', 'get_bicep_best_practices', 'bestpractices', 'bicepschema', 'azure_get_azure_verified_module', 'todos' ]
 ---
diff --git a/agents/blueprint-mode-codex.agent.md b/agents/blueprint-mode-codex.agent.md
index 9c3fbcf0..1b9edcd1 100644
--- a/agents/blueprint-mode-codex.agent.md
+++ b/agents/blueprint-mode-codex.agent.md
@@ -1,6 +1,7 @@
 ---
 model: GPT-5-Codex (Preview) (copilot)
 description: 'Executes structured workflows with strict correctness and maintainability. Enforces a minimal tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling.'
+name: 'Blueprint Mode Codex'
 ---
 
 # Blueprint Mode Codex v1
diff --git a/agents/blueprint-mode.agent.md b/agents/blueprint-mode.agent.md
index ca696c6a..79a596a6 100644
--- a/agents/blueprint-mode.agent.md
+++ b/agents/blueprint-mode.agent.md
@@ -1,6 +1,7 @@
 ---
 model: GPT-5 (copilot)
 description: 'Executes structured workflows (Debug, Express, Main, Loop) with strict correctness and maintainability. Enforces an improved tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling.'
+name: 'Blueprint Mode'
 ---
 
 # Blueprint Mode v39
diff --git a/agents/critical-thinking.agent.md b/agents/critical-thinking.agent.md
index 0d056889..566de87d 100644
--- a/agents/critical-thinking.agent.md
+++ b/agents/critical-thinking.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Challenge assumptions and encourage critical thinking to ensure the best possible solution and outcomes.'
+name: 'Critical thinking mode instructions'
 tools: ['codebase', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'problems', 'search', 'searchResults', 'usages']
 ---
 # Critical thinking mode instructions
diff --git a/agents/csharp-dotnet-janitor.agent.md b/agents/csharp-dotnet-janitor.agent.md
index 3273fc35..4ab83815 100644
--- a/agents/csharp-dotnet-janitor.agent.md
+++ b/agents/csharp-dotnet-janitor.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.'
+name: 'C#/.NET Janitor'
 tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github']
 ---
 # C#/.NET Janitor
diff --git a/agents/debug.agent.md b/agents/debug.agent.md
index 343535bd..75de3b99 100644
--- a/agents/debug.agent.md
+++ b/agents/debug.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Debug your application to find and fix a bug'
+name: 'Debug Mode Instructions'
 tools: ['edit/editFiles', 'search', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'search/usages', 'read/problems', 'execute/testFailure', 'web/fetch', 'web/githubRepo', 'execute/runTests']
 ---
 
diff --git a/agents/declarative-agents-architect.agent.md b/agents/declarative-agents-architect.agent.md
index 498c6c45..0c59140e 100644
--- a/agents/declarative-agents-architect.agent.md
+++ b/agents/declarative-agents-architect.agent.md
@@ -1,4 +1,5 @@
 ---
+name: 'Declarative Agents Architect'
 model: GPT-4.1
 tools: ['codebase']
 ---
diff --git a/agents/demonstrate-understanding.agent.md b/agents/demonstrate-understanding.agent.md
index 49731de4..cc103c6c 100644
--- a/agents/demonstrate-understanding.agent.md
+++ b/agents/demonstrate-understanding.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Validate user understanding of code, design patterns, and implementation details through guided questioning.'
+name: 'Demonstrate Understanding mode instructions'
 tools: ['codebase', 'web/fetch', 'findTestFiles', 'githubRepo', 'search', 'usages']
 ---
 # Demonstrate Understanding mode instructions
diff --git a/agents/devils-advocate.agent.md b/agents/devils-advocate.agent.md
index c38683e5..840ccaa3 100644
--- a/agents/devils-advocate.agent.md
+++ b/agents/devils-advocate.agent.md
@@ -1,5 +1,6 @@
 ---
 description: "I play the devil's advocate to challenge and stress-test your ideas by finding flaws, risks, and edge cases"
+name: 'Devils Advocate'
 tools: ['read', 'search', 'web']
 ---
 You challenge user ideas by finding flaws, edge cases, and potential issues.
diff --git a/agents/dotnet-upgrade.agent.md b/agents/dotnet-upgrade.agent.md
index effc8c75..7e7bd5e6 100644
--- a/agents/dotnet-upgrade.agent.md
+++ b/agents/dotnet-upgrade.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation.'
+name: '.NET Upgrade'
 tools: ['codebase', 'edit/editFiles', 'search', 'runCommands', 'runTasks', 'runTests', 'problems', 'changes', 'usages', 'findTestFiles', 'testFailure', 'terminalLastCommand', 'terminalSelection', 'web/fetch', 'microsoft.docs.mcp']
 ---
 
@@ -20,7 +21,7 @@ Discover and plan your .NET upgrade journey!
 mode: dotnet-upgrade
 title: Analyze current .NET framework versions and create upgrade plan
 ---
-Analyze the repository and list each project's current TargetFramework 
+Analyze the repository and list each project's current TargetFramework
 along with the latest available LTS version from Microsoft's release schedule.
 Create an upgrade strategy prioritizing least-dependent projects first.
 ```
diff --git a/agents/drupal-expert.agent.md b/agents/drupal-expert.agent.md
index 1db3015d..40e2bd0a 100644
--- a/agents/drupal-expert.agent.md
+++ b/agents/drupal-expert.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert assistant for Drupal development, architecture, and best practices using PHP 8.3+ and modern Drupal patterns'
+name: 'Drupal Expert'
 model: GPT-4.1
 tools: ['codebase', 'terminalCommand', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runTests', 'problems']
 ---
diff --git a/agents/expert-cpp-software-engineer.agent.md b/agents/expert-cpp-software-engineer.agent.md
index 7050cde3..1679dfc3 100644
--- a/agents/expert-cpp-software-engineer.agent.md
+++ b/agents/expert-cpp-software-engineer.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Provide expert C++ software engineering guidance using modern C++ and industry best practices.'
+name: 'C++ Expert'
 tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp']
 ---
 # Expert C++ software engineer mode instructions
diff --git a/agents/expert-nextjs-developer.agent.md b/agents/expert-nextjs-developer.agent.md
index a6f18e8e..181ef65b 100644
--- a/agents/expert-nextjs-developer.agent.md
+++ b/agents/expert-nextjs-developer.agent.md
@@ -1,5 +1,6 @@
 ---
 description: "Expert Next.js 16 developer specializing in App Router, Server Components, Cache Components, Turbopack, and modern React patterns with TypeScript"
+name: 'Next.js Expert'
 model: "GPT-4.1"
 tools: ["changes", "codebase", "edit/editFiles", "extensions", "fetch", "findTestFiles", "githubRepo", "new", "openSimpleBrowser", "problems", "runCommands", "runNotebooks", "runTasks", "runTests", "search", "searchResults", "terminalLastCommand", "terminalSelection", "testFailure", "usages", "vscodeAPI", "figma-dev-mode-mcp-server"]
 ---
diff --git a/agents/gilfoyle.agent.md b/agents/gilfoyle.agent.md
index 269614c0..3f2c0250 100644
--- a/agents/gilfoyle.agent.md
+++ b/agents/gilfoyle.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code.'
+name: 'Gilfoyle Code Review Mode'
 tools: ['changes', 'codebase', 'web/fetch', 'findTestFiles', 'githubRepo', 'openSimpleBrowser', 'problems', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'usages', 'vscodeAPI']
 ---
 # Gilfoyle Code Review Mode
diff --git a/agents/hlbpa.agent.md b/agents/hlbpa.agent.md
index cdedf3c9..8f21b75a 100644
--- a/agents/hlbpa.agent.md
+++ b/agents/hlbpa.agent.md
@@ -1,5 +1,6 @@
 ---
 description: Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing.
+name: 'High-Level Big Picture Architect (HLBPA)'
 model: 'claude-sonnet-4'
 tools:
   - 'search/codebase'
diff --git a/agents/janitor.agent.md b/agents/janitor.agent.md
index c580d872..5a2f6400 100644
--- a/agents/janitor.agent.md
+++ b/agents/janitor.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation.'
+name: 'Universal Janitor'
 tools: ['search/changes', 'search/codebase', 'edit/editFiles', 'vscode/extensions', 'web/fetch', 'findTestFiles', 'web/githubRepo', 'vscode/getProjectSetupInfo', 'vscode/installExtension', 'vscode/newWorkspace', 'vscode/runCommand', 'vscode/openSimpleBrowser', 'read/problems', 'execute/getTerminalOutput', 'execute/runInTerminal', 'read/terminalLastCommand', 'read/terminalSelection', 'execute/createAndRunTask', 'execute/getTaskOutput', 'execute/runTask', 'execute/runTests', 'search', 'search/searchResults', 'execute/testFailure', 'search/usages', 'vscode/vscodeAPI', 'microsoft.docs.mcp', 'github']
 ---
 # Universal Janitor
diff --git a/agents/kusto-assistant.agent.md b/agents/kusto-assistant.agent.md
index 84fe4c33..a23aecea 100644
--- a/agents/kusto-assistant.agent.md
+++ b/agents/kusto-assistant.agent.md
@@ -1,5 +1,6 @@
 ---
 description: "Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server"
+name: 'Kusto Assistant'
 tools:
   [
     "changes",
diff --git a/agents/laravel-expert-agent.agent.md b/agents/laravel-expert-agent.agent.md
index 8badba2e..19120016 100644
--- a/agents/laravel-expert-agent.agent.md
+++ b/agents/laravel-expert-agent.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert Laravel development assistant specializing in modern Laravel 12+ applications with Eloquent, Artisan, testing, and best practices'
+name: 'Laravel Expert Agent'
 model: GPT-4.1 | 'gpt-5' | 'Claude Sonnet 4.5'
 tools: ['codebase', 'terminalCommand', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runTests', 'problems', 'search']
 ---
diff --git a/agents/mentor.agent.md b/agents/mentor.agent.md
index c6531ad6..d9cea539 100644
--- a/agents/mentor.agent.md
+++ b/agents/mentor.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Help mentor the engineer by providing guidance and support.'
+name: 'Mentor mode'
 tools: ['codebase', 'web/fetch', 'findTestFiles', 'githubRepo', 'search', 'usages']
 ---
 # Mentor mode instructions
diff --git a/agents/microsoft-agent-framework-dotnet.agent.md b/agents/microsoft-agent-framework-dotnet.agent.md
index f9148713..5689c876 100644
--- a/agents/microsoft-agent-framework-dotnet.agent.md
+++ b/agents/microsoft-agent-framework-dotnet.agent.md
@@ -1,5 +1,6 @@
 ---
 description: "Create, update, refactor, explain or work with code using the .NET version of Microsoft Agent Framework."
+name: 'Microsoft Agent Framework .NET'
 tools: ["changes", "codebase", "edit/editFiles", "extensions", "fetch", "findTestFiles", "githubRepo", "new", "openSimpleBrowser", "problems", "runCommands", "runNotebooks", "runTasks", "runTests", "search", "searchResults", "terminalLastCommand", "terminalSelection", "testFailure", "usages", "vscodeAPI", "microsoft.docs.mcp", "github"]
 model: 'claude-sonnet-4'
 ---
diff --git a/agents/microsoft-agent-framework-python.agent.md b/agents/microsoft-agent-framework-python.agent.md
index cb7eab0d..1247abb2 100644
--- a/agents/microsoft-agent-framework-python.agent.md
+++ b/agents/microsoft-agent-framework-python.agent.md
@@ -1,5 +1,6 @@
 ---
 description: "Create, update, refactor, explain or work with code using the Python version of Microsoft Agent Framework."
+name: 'Microsoft Agent Framework Python'
 tools: ["changes", "search/codebase", "edit/editFiles", "extensions", "fetch", "findTestFiles", "githubRepo", "new", "openSimpleBrowser", "problems", "runCommands", "runNotebooks", "runTasks", "runTests", "search", "search/searchResults", "runCommands/terminalLastCommand", "runCommands/terminalSelection", "testFailure", "usages", "vscodeAPI", "microsoft.docs.mcp", "github", "configurePythonEnvironment", "getPythonEnvironmentInfo", "getPythonExecutableCommand", "installPythonPackage"]
 model: 'claude-sonnet-4'
 ---
diff --git a/agents/microsoft-study-mode.agent.md b/agents/microsoft-study-mode.agent.md
index db08fb52..414e4d21 100644
--- a/agents/microsoft-study-mode.agent.md
+++ b/agents/microsoft-study-mode.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers.'
+name: 'Microsoft Study and Learn'
 tools: ['microsoft_docs_search', 'microsoft_docs_fetch']
 ---
 
diff --git a/agents/microsoft_learn_contributor.agent.md b/agents/microsoft_learn_contributor.agent.md
index 0138feaf..cf79bf5c 100644
--- a/agents/microsoft_learn_contributor.agent.md
+++ b/agents/microsoft_learn_contributor.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Microsoft Learn Contributor chatmode for editing and writing Microsoft Learn documentation following Microsoft Writing Style Guide and authoring best practices.'
+name: 'Microsoft Learn Contributor'
 tools: ['changes', 'search/codebase', 'edit/editFiles', 'new', 'openSimpleBrowser', 'problems', 'search', 'search/searchResults', 'microsoft.docs.mcp']
 ---
 
diff --git a/agents/modernization.agent.md b/agents/modernization.agent.md
index 0c583b44..2058d3da 100644
--- a/agents/modernization.agent.md
+++ b/agents/modernization.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Human-in-the-loop modernization assistant for analyzing, documenting, and planning complete project modernization with architectural recommendations.'
+name: 'Modernization Agent'
 model: 'GPT-5'
 tools:
    - search
diff --git a/agents/pimcore-expert.agent.md b/agents/pimcore-expert.agent.md
index d841a44e..3f6a66d5 100644
--- a/agents/pimcore-expert.agent.md
+++ b/agents/pimcore-expert.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert Pimcore development assistant specializing in CMS, DAM, PIM, and E-Commerce solutions with Symfony integration'
+name: 'Pimcore Expert'
 model: GPT-4.1 | 'gpt-5' | 'Claude Sonnet 4.5'
 tools: ['codebase', 'terminalCommand', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runTests', 'problems']
 ---
diff --git a/agents/principal-software-engineer.agent.md b/agents/principal-software-engineer.agent.md
index 68875d4c..26802359 100644
--- a/agents/principal-software-engineer.agent.md
+++ b/agents/principal-software-engineer.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation.'
+name: 'Principal software engineer'
 tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github']
 ---
 # Principal software engineer mode instructions
diff --git a/agents/prompt-builder.agent.md b/agents/prompt-builder.agent.md
index 5e1a76ef..e9e905fb 100644
--- a/agents/prompt-builder.agent.md
+++ b/agents/prompt-builder.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai'
+name: 'Prompt Builder'
 tools: ['codebase', 'edit/editFiles', 'web/fetch', 'githubRepo', 'problems', 'runCommands', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'usages', 'terraform', 'Microsoft Docs', 'context7']
 ---
 
diff --git a/agents/prompt-engineer.agent.md b/agents/prompt-engineer.agent.md
index f72d5691..42a16b37 100644
--- a/agents/prompt-engineer.agent.md
+++ b/agents/prompt-engineer.agent.md
@@ -1,5 +1,6 @@
 ---
 description: "A specialized chat mode for analyzing and improving prompts. Every user input is treated as a prompt to be improved. It first provides a detailed analysis of the original prompt within a <reasoning> tag, evaluating it against a systematic framework based on OpenAI's prompt engineering best practices. Following the analysis, it generates a new, improved prompt."
+name: 'Prompt Engineer'
 ---
 
 # Prompt Engineer
diff --git a/agents/refine-issue.agent.md b/agents/refine-issue.agent.md
index 71f51245..c3c6d1a1 100644
--- a/agents/refine-issue.agent.md
+++ b/agents/refine-issue.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs'
+name: 'Refine Requirement or Issue'
 tools: [ 'list_issues','githubRepo', 'search', 'add_issue_comment','create_issue','create_issue_comment','update_issue','delete_issue','get_issue', 'search_issues']
 ---
 
@@ -31,4 +32,4 @@ To activate Requirement Refinement mode:
 
 ## Output
 
-Copilot will modify the issue description and add structured details to it. 
+Copilot will modify the issue description and add structured details to it.
diff --git a/agents/repo-architect.agent.md b/agents/repo-architect.agent.md
index 211ca553..11e5ffc7 100644
--- a/agents/repo-architect.agent.md
+++ b/agents/repo-architect.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Bootstraps and validates agentic project structures for GitHub Copilot (VS Code) and OpenCode CLI workflows. Run after `opencode /init` or VS Code Copilot initialization to scaffold proper folder hierarchies, instructions, agents, skills, and prompts.'
+name: 'Repo Architect Agent'
 model: GPT-4.1
 tools: ["changes", "codebase", "editFiles", "fetch", "new", "problems", "runCommands", "search", "terminalLastCommand"]
 ---
diff --git a/agents/search-ai-optimization-expert.agent.md b/agents/search-ai-optimization-expert.agent.md
index 123fb7a8..966014b7 100644
--- a/agents/search-ai-optimization-expert.agent.md
+++ b/agents/search-ai-optimization-expert.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert guidance for modern search optimization: SEO, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO) with AI-ready content strategies'
+name: 'Search & AI Optimization Expert'
 tools: ['codebase', 'web/fetch', 'githubRepo', 'terminalCommand', 'edit/editFiles', 'problems']
 ---
 
diff --git a/agents/semantic-kernel-dotnet.agent.md b/agents/semantic-kernel-dotnet.agent.md
index a93dfc71..9eda1eb5 100644
--- a/agents/semantic-kernel-dotnet.agent.md
+++ b/agents/semantic-kernel-dotnet.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Create, update, refactor, explain or work with code using the .NET version of Semantic Kernel.'
+name: 'Semantic Kernel .NET'
 tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github']
 ---
 # Semantic Kernel .NET mode instructions
diff --git a/agents/semantic-kernel-python.agent.md b/agents/semantic-kernel-python.agent.md
index eb680ddc..8a3136bc 100644
--- a/agents/semantic-kernel-python.agent.md
+++ b/agents/semantic-kernel-python.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Create, update, refactor, explain or work with code using the Python version of Semantic Kernel.'
+name: 'Semantic Kernel Python'
 tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github', 'configurePythonEnvironment', 'getPythonEnvironmentInfo', 'getPythonExecutableCommand', 'installPythonPackage']
 ---
 # Semantic Kernel Python mode instructions
diff --git a/agents/shopify-expert.agent.md b/agents/shopify-expert.agent.md
index 66d89060..9b4c9c6f 100644
--- a/agents/shopify-expert.agent.md
+++ b/agents/shopify-expert.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert Shopify development assistant specializing in theme development, Liquid templating, app development, and Shopify APIs'
+name: 'Shopify Expert'
 model: GPT-4.1
 tools: ['codebase', 'terminalCommand', 'edit/editFiles', 'web/fetch', 'githubRepo', 'runTests', 'problems']
 ---
diff --git a/agents/simple-app-idea-generator.agent.md b/agents/simple-app-idea-generator.agent.md
index 91332d41..09d5f322 100644
--- a/agents/simple-app-idea-generator.agent.md
+++ b/agents/simple-app-idea-generator.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation.'
+name: 'Idea Generator'
 tools: ['changes', 'codebase', 'web/fetch', 'githubRepo', 'openSimpleBrowser', 'problems', 'search', 'searchResults', 'usages', 'microsoft.docs.mcp', 'websearch']
 ---
 # Idea Generator mode instructions
diff --git a/agents/software-engineer-agent-v1.agent.md b/agents/software-engineer-agent-v1.agent.md
index b4b7bafc..c4f6d8c1 100644
--- a/agents/software-engineer-agent-v1.agent.md
+++ b/agents/software-engineer-agent-v1.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.'
+name: 'Software Engineer Agent'
 tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github']
 ---
 # Software Engineer Agent v1
diff --git a/agents/specification.agent.md b/agents/specification.agent.md
index b120dfe5..15e4ea6d 100644
--- a/agents/specification.agent.md
+++ b/agents/specification.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Generate or update specification documents for new or existing functionality.'
+name: 'Specification'
 tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github']
 ---
 # Specification mode instructions
diff --git a/agents/tech-debt-remediation-plan.agent.md b/agents/tech-debt-remediation-plan.agent.md
index 6941896c..235f9431 100644
--- a/agents/tech-debt-remediation-plan.agent.md
+++ b/agents/tech-debt-remediation-plan.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Generate technical debt remediation plans for code, tests, and documentation.'
+name: 'Technical Debt Remediation Plan'
 tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'github']
 ---
 # Technical Debt Remediation Plan
diff --git a/agents/voidbeast-gpt41enhanced.agent.md b/agents/voidbeast-gpt41enhanced.agent.md
index e7782f65..9e18bdaf 100644
--- a/agents/voidbeast-gpt41enhanced.agent.md
+++ b/agents/voidbeast-gpt41enhanced.agent.md
@@ -1,5 +1,6 @@
 ---
 description: '4.1 voidBeast_GPT41Enhanced 1.0 : a advanced autonomous developer agent, designed for elite full-stack development with enhanced multi-mode capabilities. This latest evolution features sophisticated mode detection, comprehensive research capabilities, and never-ending problem resolution. Plan/Act/Deep Research/Analyzer/Checkpoints(Memory)/Prompt Generator Modes.'
+name: 'voidBeast_GPT41Enhanced 1.0 - Elite Developer AI Assistant'
 tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'readCellOutput', 'runCommands', 'runNotebooks', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'updateUserPreferences', 'usages', 'vscodeAPI']
 ---
 
diff --git a/agents/wg-code-alchemist.agent.md b/agents/wg-code-alchemist.agent.md
index 000cd749..b515ac0c 100644
--- a/agents/wg-code-alchemist.agent.md
+++ b/agents/wg-code-alchemist.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design'
+name: 'WG Code Alchemist'
 tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI']
 ---
 
diff --git a/agents/wg-code-sentinel.agent.md b/agents/wg-code-sentinel.agent.md
index bd59a600..f1201839 100644
--- a/agents/wg-code-sentinel.agent.md
+++ b/agents/wg-code-sentinel.agent.md
@@ -1,5 +1,6 @@
 ---
 description: 'Ask WG Code Sentinel to review your code for security issues.'
+name: 'WG Code Sentinel'
 tools: ['changes', 'codebase', 'edit/editFiles', 'extensions', 'web/fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runNotebooks', 'runTasks', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'usages', 'vscodeAPI']
 ---
 
diff --git a/docs/README.agents.md b/docs/README.agents.md
index 1980a6d5..829eaa06 100644
--- a/docs/README.agents.md
+++ b/docs/README.agents.md
@@ -19,20 +19,19 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
 
 | Title | Description | MCP Servers |
 | ----- | ----------- | ----------- |
-| [.NET Upgrade Collection](../agents/dotnet-upgrade.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-upgrade.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-upgrade.agent.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. |  |
+| [.NET Upgrade](../agents/dotnet-upgrade.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-upgrade.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-upgrade.agent.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. |  |
 | [4.1 Beast Mode v3.1](../agents/4.1-Beast.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2F4.1-Beast.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2F4.1-Beast.agent.md) | GPT 4.1 as a top-notch coding agent. |  |
 | [Accessibility Expert](../agents/accessibility.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faccessibility.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faccessibility.agent.md) | Expert assistant for web accessibility (WCAG 2.1/2.2), inclusive UX, and a11y testing |  |
 | [ADR Generator](../agents/adr-generator.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fadr-generator.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fadr-generator.agent.md) | Expert agent for creating comprehensive Architectural Decision Records (ADRs) with structured formatting optimized for AI consumption and human readability. |  |
-| [AEM Front-End Specialist](../agents/aem-frontend-specialist.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faem-frontend-specialist.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faem-frontend-specialist.agent.md) | Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration |  |
+| [AEM Front End Specialist](../agents/aem-frontend-specialist.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faem-frontend-specialist.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faem-frontend-specialist.agent.md) | Expert assistant for developing AEM components using HTL, Tailwind CSS, and Figma-to-code workflows with design system integration |  |
 | [Amplitude Experiment Implementation](../agents/amplitude-experiment-implementation.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Famplitude-experiment-implementation.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Famplitude-experiment-implementation.agent.md) | This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features. |  |
-| [API Architect mode instructions](../agents/api-architect.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapi-architect.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapi-architect.agent.md) | Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code. |  |
+| [API Architect](../agents/api-architect.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapi-architect.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapi-architect.agent.md) | Your role is that of an API architect. Help mentor the engineer by providing guidance, support, and working code. |  |
 | [Apify Integration Expert](../agents/apify-integration-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapify-integration-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fapify-integration-expert.agent.md) | Expert agent for integrating Apify Actors into codebases. Handles Actor selection, workflow design, implementation across JavaScript/TypeScript and Python, testing, and production-ready deployment. | [apify](https://github.com/mcp/com.apify/apify-mcp-server)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=apify&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.apify.com%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24APIFY_TOKEN%22%2C%22Content-Type%22%3A%22application%2Fjson%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=apify&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.apify.com%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24APIFY_TOKEN%22%2C%22Content-Type%22%3A%22application%2Fjson%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.apify.com%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24APIFY_TOKEN%22%2C%22Content-Type%22%3A%22application%2Fjson%22%7D%7D) |
 | [Arch Linux Expert](../agents/arch-linux-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farch-linux-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farch-linux-expert.agent.md) | Arch Linux specialist focused on pacman, rolling-release maintenance, and Arch-centric system administration workflows. |  |
 | [Arm Migration Agent](../agents/arm-migration.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farm-migration.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farm-migration.agent.md) | Arm Cloud Migration Assistant accelerates moving x86 workloads to Arm infrastructure. It scans the repository for architecture assumptions, portability issues, container base image and dependency incompatibilities, and recommends Arm-optimized changes. It can drive multi-arch container builds, validate performance, and guide optimization, enabling smooth cross-platform deployment directly inside GitHub. | custom-mcp<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=custom-mcp&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2524%257B%257B%2520github.workspace%2520%257D%257D%253A%252Fworkspace%22%2C%22--name%22%2C%22arm-mcp%22%2C%22armlimited%252Farm-mcp%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=custom-mcp&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2524%257B%257B%2520github.workspace%2520%257D%257D%253A%252Fworkspace%22%2C%22--name%22%2C%22arm-mcp%22%2C%22armlimited%252Farm-mcp%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2524%257B%257B%2520github.workspace%2520%257D%257D%253A%252Fworkspace%22%2C%22--name%22%2C%22arm-mcp%22%2C%22armlimited%252Farm-mcp%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D) |
+| [Atlassian Requirements to Jira](../agents/atlassian-requirements-to-jira.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fatlassian-requirements-to-jira.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fatlassian-requirements-to-jira.agent.md) | Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow. |  |
 | [Azure AVM Bicep mode](../agents/azure-verified-modules-bicep.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-verified-modules-bicep.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-verified-modules-bicep.agent.md) | Create, update, or review Azure IaC in Bicep using Azure Verified Modules (AVM). |  |
 | [Azure AVM Terraform mode](../agents/azure-verified-modules-terraform.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-verified-modules-terraform.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-verified-modules-terraform.agent.md) | Create, update, or review Azure IaC in Terraform using Azure Verified Modules (AVM). |  |
-| [Azure Bicep Infrastructure as Code coding Specialist](../agents/bicep-implement.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-implement.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-implement.agent.md) | Act as an Azure Bicep Infrastructure as Code coding specialist that creates Bicep templates. |  |
-| [Azure Bicep Infrastructure Planning](../agents/bicep-plan.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-plan.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-plan.agent.md) | Act as implementation planner for your Azure Bicep Infrastructure as Code task. |  |
 | [Azure Iac Exporter](../agents/azure-iac-exporter.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-iac-exporter.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-iac-exporter.agent.md) | Export existing Azure resources to Infrastructure as Code templates via Azure Resource Graph analysis, Azure Resource Manager API calls, and azure-iac-generator integration. Use this skill when the user asks to export, convert, migrate, or extract existing Azure resources to IaC templates (Bicep, ARM Templates, Terraform, Pulumi). |  |
 | [Azure Iac Generator](../agents/azure-iac-generator.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-iac-generator.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-iac-generator.agent.md) | Central hub for generating Infrastructure as Code (Bicep, ARM, Terraform, Pulumi) with format-specific validation and best practices. Use this skill when the user asks to generate, create, write, or build infrastructure code, deployment code, or IaC templates in any format (Bicep, ARM Templates, Terraform, Pulumi). |  |
 | [Azure Logic Apps Expert Mode](../agents/azure-logic-apps-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-logic-apps-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-logic-apps-expert.agent.md) | Expert guidance for Azure Logic Apps development focusing on workflow design, integration patterns, and JSON-based Workflow Definition Language. |  |
@@ -40,11 +39,14 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
 | [Azure SaaS Architect mode instructions](../agents/azure-saas-architect.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-saas-architect.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fazure-saas-architect.agent.md) | Provide expert Azure SaaS Architect guidance focusing on multitenant applications using Azure Well-Architected SaaS principles and Microsoft best practices. |  |
 | [Azure Terraform IaC Implementation Specialist](../agents/terraform-azure-implement.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-azure-implement.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-azure-implement.agent.md) | Act as an Azure Terraform Infrastructure as Code coding specialist that creates and reviews Terraform for Azure resources. |  |
 | [Azure Terraform Infrastructure Planning](../agents/terraform-azure-planning.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-azure-planning.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform-azure-planning.agent.md) | Act as implementation planner for your Azure Terraform Infrastructure as Code task. |  |
-| [Blueprint Mode Codex v1](../agents/blueprint-mode-codex.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode-codex.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode-codex.agent.md) | Executes structured workflows with strict correctness and maintainability. Enforces a minimal tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling. |  |
-| [Blueprint Mode v39](../agents/blueprint-mode.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode.agent.md) | Executes structured workflows (Debug, Express, Main, Loop) with strict correctness and maintainability. Enforces an improved tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling. |  |
+| [Bicep Planning](../agents/bicep-plan.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-plan.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-plan.agent.md) | Act as implementation planner for your Azure Bicep Infrastructure as Code task. |  |
+| [Bicep Specialist](../agents/bicep-implement.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-implement.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fbicep-implement.agent.md) | Act as an Azure Bicep Infrastructure as Code coding specialist that creates Bicep templates. |  |
+| [Blueprint Mode](../agents/blueprint-mode.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode.agent.md) | Executes structured workflows (Debug, Express, Main, Loop) with strict correctness and maintainability. Enforces an improved tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling. |  |
+| [Blueprint Mode Codex](../agents/blueprint-mode-codex.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode-codex.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fblueprint-mode-codex.agent.md) | Executes structured workflows with strict correctness and maintainability. Enforces a minimal tool usage policy, never assumes facts, prioritizes reproducible solutions, self-correction, and edge-case handling. |  |
 | [C# Expert](../agents/CSharpExpert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FCSharpExpert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FCSharpExpert.agent.md) | An agent designed to assist with software development tasks for .NET projects. |  |
 | [C# MCP Server Expert](../agents/csharp-mcp-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-mcp-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-mcp-expert.agent.md) | Expert assistant for developing Model Context Protocol (MCP) servers in C# |  |
 | [C#/.NET Janitor](../agents/csharp-dotnet-janitor.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-dotnet-janitor.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-dotnet-janitor.agent.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. |  |
+| [C++ Expert](../agents/expert-cpp-software-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md) | Provide expert C++ software engineering guidance using modern C++ and industry best practices. |  |
 | [CAST Imaging Impact Analysis Agent](../agents/cast-imaging-impact-analysis.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-impact-analysis.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-impact-analysis.agent.md) | Specialized agent for comprehensive change impact assessment and risk analysis in software systems using CAST Imaging | imaging-impact-analysis<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-impact-analysis&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-impact-analysis&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) |
 | [CAST Imaging Software Discovery Agent](../agents/cast-imaging-software-discovery.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-software-discovery.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-software-discovery.agent.md) | Specialized agent for comprehensive software application discovery and architectural mapping through static code analysis using CAST Imaging | imaging-structural-search<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-structural-search&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-structural-search&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) |
 | [CAST Imaging Structural Quality Advisor Agent](../agents/cast-imaging-structural-quality-advisor.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-structural-quality-advisor.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-structural-quality-advisor.agent.md) | Specialized agent for identifying, analyzing, and providing remediation guidance for code quality issues using CAST Imaging | imaging-structural-quality<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-structural-quality&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-structural-quality&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) |
@@ -68,32 +70,30 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
 | [Elasticsearch Agent](../agents/elasticsearch-observability.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Felasticsearch-observability.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Felasticsearch-observability.agent.md) | Our expert AI assistant for debugging code (O11y), optimizing vector search (RAG), and remediating security threats using live Elastic data. | elastic-mcp<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=elastic-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22mcp-remote%22%2C%22https%253A%252F%252F%257BKIBANA_URL%257D%252Fapi%252Fagent_builder%252Fmcp%22%2C%22--header%22%2C%22Authorization%253A%2524%257BAUTH_HEADER%257D%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=elastic-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22mcp-remote%22%2C%22https%253A%252F%252F%257BKIBANA_URL%257D%252Fapi%252Fagent_builder%252Fmcp%22%2C%22--header%22%2C%22Authorization%253A%2524%257BAUTH_HEADER%257D%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22mcp-remote%22%2C%22https%253A%252F%252F%257BKIBANA_URL%257D%252Fapi%252Fagent_builder%252Fmcp%22%2C%22--header%22%2C%22Authorization%253A%2524%257BAUTH_HEADER%257D%22%5D%2C%22env%22%3A%7B%7D%7D) |
 | [Electron Code Review Mode Instructions](../agents/electron-angular-native.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Felectron-angular-native.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Felectron-angular-native.agent.md) | Code Review Mode tailored for Electron app with Node.js backend (main), Angular frontend (render), and native integration layer (e.g., AppleScript, shell, or native tooling). Services in other repos are not reviewed here. |  |
 | [Expert .NET software engineer mode instructions](../agents/expert-dotnet-software-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-dotnet-software-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-dotnet-software-engineer.agent.md) | Provide expert .NET software engineering guidance using modern software design patterns. |  |
-| [Expert C++ software engineer mode instructions](../agents/expert-cpp-software-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md) | Provide expert C++ software engineering guidance using modern C++ and industry best practices. |  |
-| [Expert Next.js Developer](../agents/expert-nextjs-developer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-nextjs-developer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-nextjs-developer.agent.md) | Expert Next.js 16 developer specializing in App Router, Server Components, Cache Components, Turbopack, and modern React patterns with TypeScript |  |
 | [Expert React Frontend Engineer](../agents/expert-react-frontend-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-react-frontend-engineer.agent.md) | Expert React 19.2 frontend engineer specializing in modern hooks, Server Components, Actions, TypeScript, and performance optimization |  |
 | [Fedora Linux Expert](../agents/fedora-linux-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ffedora-linux-expert.agent.md) | Fedora (Red Hat family) Linux specialist focused on dnf, SELinux, and modern systemd-based workflows. |  |
 | [Gilfoyle Code Review Mode](../agents/gilfoyle.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgilfoyle.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgilfoyle.agent.md) | Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code. |  |
 | [GitHub Actions Expert](../agents/github-actions-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgithub-actions-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgithub-actions-expert.agent.md) | GitHub Actions specialist focused on secure CI/CD workflows, action pinning, OIDC authentication, permissions least privilege, and supply-chain security |  |
 | [Go MCP Server Development Expert](../agents/go-mcp-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgo-mcp-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgo-mcp-expert.agent.md) | Expert assistant for building Model Context Protocol (MCP) servers in Go using the official SDK. |  |
 | [GPT 5 Beast Mode](../agents/gpt-5-beast-mode.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgpt-5-beast-mode.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fgpt-5-beast-mode.agent.md) | Beast Mode 2.0: A powerful autonomous agent tuned specifically for GPT-5 that can solve complex problems by using tools, conducting research, and iterating until the problem is fully resolved. |  |
-| [High-Level Big Picture Architect (HLBPA)](../agents/hlbpa.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md) | Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. |  |
-| [Idea Generator mode instructions](../agents/simple-app-idea-generator.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md) | Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation. |  |
+| [High Level Big Picture Architect (HLBPA)](../agents/hlbpa.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md) | Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. |  |
+| [Idea Generator](../agents/simple-app-idea-generator.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md) | Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation. |  |
 | [Implementation Plan Generation Mode](../agents/implementation-plan.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fimplementation-plan.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fimplementation-plan.agent.md) | Generate an implementation plan for new features or refactoring existing code. |  |
 | [Java MCP Expert](../agents/java-mcp-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjava-mcp-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjava-mcp-expert.agent.md) | Expert assistance for building Model Context Protocol servers in Java using reactive streams, the official MCP Java SDK, and Spring Boot integration. |  |
 | [JFrog Security Agent](../agents/jfrog-sec.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjfrog-sec.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjfrog-sec.agent.md) | The dedicated Application Security agent for automated security remediation. Verifies package and version compliance, and suggests vulnerability fixes using JFrog security intelligence. |  |
 | [Kotlin MCP Server Development Expert](../agents/kotlin-mcp-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkotlin-mcp-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkotlin-mcp-expert.agent.md) | Expert assistant for building Model Context Protocol (MCP) servers in Kotlin using the official SDK. |  |
-| [Kusto Assistant: Azure Data Explorer (Kusto) Engineering Assistant](../agents/kusto-assistant.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkusto-assistant.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkusto-assistant.agent.md) | Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server |  |
+| [Kusto Assistant](../agents/kusto-assistant.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkusto-assistant.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkusto-assistant.agent.md) | Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server |  |
 | [Laravel Expert Agent](../agents/laravel-expert-agent.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flaravel-expert-agent.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flaravel-expert-agent.agent.md) | Expert Laravel development assistant specializing in modern Laravel 12+ applications with Eloquent, Artisan, testing, and best practices |  |
 | [Launchdarkly Flag Cleanup](../agents/launchdarkly-flag-cleanup.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flaunchdarkly-flag-cleanup.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flaunchdarkly-flag-cleanup.agent.md) | A specialized GitHub Copilot agent that uses the LaunchDarkly MCP server to safely automate feature flag cleanup workflows. This agent determines removal readiness, identifies the correct forward value, and creates PRs that preserve production behavior while removing obsolete flags and updating stale defaults. | [launchdarkly](https://github.com/mcp/launchdarkly/mcp-server)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=launchdarkly&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540launchdarkly%252Fmcp-server%22%2C%22--%22%2C%22mcp%22%2C%22start%22%2C%22--api-key%22%2C%22%2524LD_ACCESS_TOKEN%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=launchdarkly&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540launchdarkly%252Fmcp-server%22%2C%22--%22%2C%22mcp%22%2C%22start%22%2C%22--api-key%22%2C%22%2524LD_ACCESS_TOKEN%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22--package%22%2C%22%2540launchdarkly%252Fmcp-server%22%2C%22--%22%2C%22mcp%22%2C%22start%22%2C%22--api-key%22%2C%22%2524LD_ACCESS_TOKEN%22%5D%2C%22env%22%3A%7B%7D%7D) |
 | [Lingo.dev Localization (i18n) Agent](../agents/lingodotdev-i18n.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flingodotdev-i18n.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Flingodotdev-i18n.agent.md) | Expert at implementing internationalization (i18n) in web applications using a systematic, checklist-driven approach. | lingo<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=lingo&config=%7B%22command%22%3A%22%22%2C%22args%22%3A%5B%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=lingo&config=%7B%22command%22%3A%22%22%2C%22args%22%3A%5B%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22%22%2C%22args%22%3A%5B%5D%2C%22env%22%3A%7B%7D%7D) |
 | [MAUI Expert](../agents/dotnet-maui.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-maui.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fdotnet-maui.agent.md) | Support development of .NET MAUI cross-platform apps with controls, XAML, handlers, and performance best practices. |  |
 | [MCP M365 Agent Expert](../agents/mcp-m365-agent-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmcp-m365-agent-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmcp-m365-agent-expert.agent.md) | Expert assistant for building MCP-based declarative agents for Microsoft 365 Copilot with Model Context Protocol integration |  |
-| [Mentor mode instructions](../agents/mentor.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmentor.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmentor.agent.md) | Help mentor the engineer by providing guidance and support. |  |
+| [Mentor mode](../agents/mentor.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmentor.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmentor.agent.md) | Help mentor the engineer by providing guidance and support. |  |
 | [Meta Agentic Project Scaffold](../agents/meta-agentic-project-scaffold.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmeta-agentic-project-scaffold.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmeta-agentic-project-scaffold.agent.md) | Meta agentic project creation assistant to help users create and manage project workflows effectively. |  |
-| [Microsoft Agent Framework .NET mode instructions](../agents/microsoft-agent-framework-dotnet.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-dotnet.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-dotnet.agent.md) | Create, update, refactor, explain or work with code using the .NET version of Microsoft Agent Framework. |  |
-| [Microsoft Agent Framework Python mode instructions](../agents/microsoft-agent-framework-python.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-python.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-python.agent.md) | Create, update, refactor, explain or work with code using the Python version of Microsoft Agent Framework. |  |
+| [Microsoft Agent Framework .NET](../agents/microsoft-agent-framework-dotnet.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-dotnet.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-dotnet.agent.md) | Create, update, refactor, explain or work with code using the .NET version of Microsoft Agent Framework. |  |
+| [Microsoft Agent Framework Python](../agents/microsoft-agent-framework-python.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-python.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-agent-framework-python.agent.md) | Create, update, refactor, explain or work with code using the Python version of Microsoft Agent Framework. |  |
 | [Microsoft Learn Contributor](../agents/microsoft_learn_contributor.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft_learn_contributor.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft_learn_contributor.agent.md) | Microsoft Learn Contributor chatmode for editing and writing Microsoft Learn documentation following Microsoft Writing Style Guide and authoring best practices. |  |
-| [Microsoft Study and Learn Chat Mode](../agents/microsoft-study-mode.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-study-mode.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-study-mode.agent.md) | Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers. |  |
+| [Microsoft Study and Learn](../agents/microsoft-study-mode.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-study-mode.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmicrosoft-study-mode.agent.md) | Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers. |  |
 | [Modernization Agent](../agents/modernization.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmodernization.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmodernization.agent.md) | Human-in-the-loop modernization assistant for analyzing, documenting, and planning complete project modernization with architectural recommendations. |  |
 | [Monday Bug Context Fixer](../agents/monday-bug-fixer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmonday-bug-fixer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmonday-bug-fixer.agent.md) | Elite bug-fixing agent that enriches task context from Monday.com platform data. Gathers related items, docs, comments, epics, and requirements to deliver production-quality fixes with comprehensive PRs. | monday-api-mcp<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=monday-api-mcp&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.monday.com%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24MONDAY_TOKEN%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=monday-api-mcp&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.monday.com%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24MONDAY_TOKEN%22%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.monday.com%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24MONDAY_TOKEN%22%7D%7D) |
 | [Mongodb Performance Advisor](../agents/mongodb-performance-advisor.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmongodb-performance-advisor.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmongodb-performance-advisor.agent.md) | Analyze MongoDB database performance, offer query and index optimization insights and provide actionable recommendations to improve overall usage of the database. |  |
@@ -101,6 +101,7 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
 | [Neo4j Docker Client Generator](../agents/neo4j-docker-client-generator.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneo4j-docker-client-generator.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneo4j-docker-client-generator.agent.md) | AI agent that generates simple, high-quality Python Neo4j client libraries from GitHub issues with proper best practices | neo4j-local<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=neo4j-local&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22NEO4J_URI%22%2C%22-e%22%2C%22NEO4J_USERNAME%22%2C%22-e%22%2C%22NEO4J_PASSWORD%22%2C%22-e%22%2C%22NEO4J_DATABASE%22%2C%22-e%22%2C%22NEO4J_NAMESPACE%253Dneo4j-local%22%2C%22-e%22%2C%22NEO4J_TRANSPORT%253Dstdio%22%2C%22mcp%252Fneo4j-cypher%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=neo4j-local&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22NEO4J_URI%22%2C%22-e%22%2C%22NEO4J_USERNAME%22%2C%22-e%22%2C%22NEO4J_PASSWORD%22%2C%22-e%22%2C%22NEO4J_DATABASE%22%2C%22-e%22%2C%22NEO4J_NAMESPACE%253Dneo4j-local%22%2C%22-e%22%2C%22NEO4J_TRANSPORT%253Dstdio%22%2C%22mcp%252Fneo4j-cypher%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22NEO4J_URI%22%2C%22-e%22%2C%22NEO4J_USERNAME%22%2C%22-e%22%2C%22NEO4J_PASSWORD%22%2C%22-e%22%2C%22NEO4J_DATABASE%22%2C%22-e%22%2C%22NEO4J_NAMESPACE%253Dneo4j-local%22%2C%22-e%22%2C%22NEO4J_TRANSPORT%253Dstdio%22%2C%22mcp%252Fneo4j-cypher%253Alatest%22%5D%2C%22env%22%3A%7B%7D%7D) |
 | [Neon Migration Specialist](../agents/neon-migration-specialist.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-migration-specialist.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-migration-specialist.agent.md) | Safe Postgres migrations with zero-downtime using Neon's branching workflow. Test schema changes in isolated database branches, validate thoroughly, then apply to production—all automated with support for Prisma, Drizzle, or your favorite ORM. |  |
 | [Neon Performance Analyzer](../agents/neon-optimization-analyzer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-optimization-analyzer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-optimization-analyzer.agent.md) | Identify and fix slow Postgres queries automatically using Neon's branching workflow. Analyzes execution plans, tests optimizations in isolated database branches, and provides clear before/after performance metrics with actionable code fixes. |  |
+| [Next.js Expert](../agents/expert-nextjs-developer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-nextjs-developer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-nextjs-developer.agent.md) | Expert Next.js 16 developer specializing in App Router, Server Components, Cache Components, Turbopack, and modern React patterns with TypeScript |  |
 | [Octopus Release Notes With Mcp](../agents/octopus-deploy-release-notes-mcp.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md) | Generate release notes for a release in Octopus Deploy. The tools for this MCP server provide access to the Octopus Deploy APIs. | octopus<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D) |
 | [OpenAPI to Application Generator](../agents/openapi-to-application.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md) | Expert assistant for generating working applications from OpenAPI specifications |  |
 | [PagerDuty Incident Responder](../agents/pagerduty-incident-responder.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md) | Responds to PagerDuty incidents by analyzing incident context, identifying recent code changes, and suggesting fixes via GitHub PRs. | [pagerduty](https://github.com/mcp/io.github.PagerDuty/pagerduty-mcp)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D) |
@@ -117,13 +118,12 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
 | [Power BI Visualization Expert Mode](../agents/power-bi-visualization-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-bi-visualization-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-bi-visualization-expert.agent.md) | Expert Power BI report design and visualization guidance using Microsoft best practices for creating effective, performant, and user-friendly reports and dashboards. |  |
 | [Power Platform Expert](../agents/power-platform-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-platform-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-platform-expert.agent.md) | Power Platform expert providing guidance on Code Apps, canvas apps, Dataverse, connectors, and Power Platform best practices |  |
 | [Power Platform MCP Integration Expert](../agents/power-platform-mcp-integration-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-platform-mcp-integration-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpower-platform-mcp-integration-expert.agent.md) | Expert in Power Platform custom connector development with MCP integration for Copilot Studio - comprehensive knowledge of schemas, protocols, and integration patterns |  |
-| [Principal software engineer mode instructions](../agents/principal-software-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprincipal-software-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprincipal-software-engineer.agent.md) | Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation. |  |
-| [Prompt Builder Instructions](../agents/prompt-builder.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-builder.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-builder.agent.md) | Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai |  |
+| [Principal software engineer](../agents/principal-software-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprincipal-software-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprincipal-software-engineer.agent.md) | Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation. |  |
+| [Prompt Builder](../agents/prompt-builder.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-builder.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-builder.agent.md) | Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai |  |
 | [Prompt Engineer](../agents/prompt-engineer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-engineer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fprompt-engineer.agent.md) | A specialized chat mode for analyzing and improving prompts. Every user input is treated as a prompt to be improved. It first provides a detailed analysis of the original prompt within a <reasoning> tag, evaluating it against a systematic framework based on OpenAI's prompt engineering best practices. Following the analysis, it generates a new, improved prompt. |  |
 | [Python MCP Server Expert](../agents/python-mcp-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpython-mcp-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpython-mcp-expert.agent.md) | Expert assistant for developing Model Context Protocol (MCP) servers in Python |  |
-| [Refine Requirement or Issue Chat Mode](../agents/refine-issue.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frefine-issue.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frefine-issue.agent.md) | Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs |  |
+| [Refine Requirement or Issue](../agents/refine-issue.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frefine-issue.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frefine-issue.agent.md) | Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs |  |
 | [Repo Architect Agent](../agents/repo-architect.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frepo-architect.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frepo-architect.agent.md) | Bootstraps and validates agentic project structures for GitHub Copilot (VS Code) and OpenCode CLI workflows. Run after `opencode /init` or VS Code Copilot initialization to scaffold proper folder hierarchies, instructions, agents, skills, and prompts. |  |
-| [Requirements to Jira Epic & User Story Creator](../agents/atlassian-requirements-to-jira.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fatlassian-requirements-to-jira.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fatlassian-requirements-to-jira.agent.md) | Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow. |  |
 | [Ruby MCP Expert](../agents/ruby-mcp-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fruby-mcp-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fruby-mcp-expert.agent.md) | Expert assistance for building Model Context Protocol servers in Ruby using the official MCP Ruby SDK gem with Rails integration. |  |
 | [Rust Beast Mode](../agents/rust-gpt-4.1-beast-mode.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frust-gpt-4.1-beast-mode.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frust-gpt-4.1-beast-mode.agent.md) | Rust GPT-4.1 Coding Beast Mode for VS Code |  |
 | [Rust MCP Expert](../agents/rust-mcp-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frust-mcp-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frust-mcp-expert.agent.md) | Expert assistant for Rust MCP server development using the rmcp SDK with tokio async runtime |  |
@@ -136,12 +136,12 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
 | [SE: Tech Writer](../agents/se-technical-writer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fse-technical-writer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fse-technical-writer.agent.md) | Technical writing specialist for creating developer documentation, technical blogs, tutorials, and educational content |  |
 | [SE: UX Designer](../agents/se-ux-ui-designer.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fse-ux-ui-designer.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fse-ux-ui-designer.agent.md) | Jobs-to-be-Done analysis, user journey mapping, and UX research artifacts for Figma and design workflows |  |
 | [Search & AI Optimization Expert](../agents/search-ai-optimization-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsearch-ai-optimization-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsearch-ai-optimization-expert.agent.md) | Expert guidance for modern search optimization: SEO, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO) with AI-ready content strategies |  |
-| [Semantic Kernel .NET mode instructions](../agents/semantic-kernel-dotnet.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-dotnet.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-dotnet.agent.md) | Create, update, refactor, explain or work with code using the .NET version of Semantic Kernel. |  |
-| [Semantic Kernel Python mode instructions](../agents/semantic-kernel-python.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-python.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-python.agent.md) | Create, update, refactor, explain or work with code using the Python version of Semantic Kernel. |  |
+| [Semantic Kernel .NET](../agents/semantic-kernel-dotnet.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-dotnet.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-dotnet.agent.md) | Create, update, refactor, explain or work with code using the .NET version of Semantic Kernel. |  |
+| [Semantic Kernel Python](../agents/semantic-kernel-python.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-python.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsemantic-kernel-python.agent.md) | Create, update, refactor, explain or work with code using the Python version of Semantic Kernel. |  |
 | [Senior Cloud Architect](../agents/arch.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farch.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Farch.agent.md) | Expert in modern architecture design patterns, NFR requirements, and creating comprehensive architectural diagrams and documentation |  |
 | [Shopify Expert](../agents/shopify-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fshopify-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fshopify-expert.agent.md) | Expert Shopify development assistant specializing in theme development, Liquid templating, app development, and Shopify APIs |  |
-| [Software Engineer Agent v1](../agents/software-engineer-agent-v1.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsoftware-engineer-agent-v1.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsoftware-engineer-agent-v1.agent.md) | Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively. |  |
-| [Specification mode instructions](../agents/specification.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fspecification.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fspecification.agent.md) | Generate or update specification documents for new or existing functionality. |  |
+| [Software Engineer Agent](../agents/software-engineer-agent-v1.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsoftware-engineer-agent-v1.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsoftware-engineer-agent-v1.agent.md) | Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively. |  |
+| [Specification](../agents/specification.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fspecification.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fspecification.agent.md) | Generate or update specification documents for new or existing functionality. |  |
 | [Stackhawk Security Onboarding](../agents/stackhawk-security-onboarding.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fstackhawk-security-onboarding.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fstackhawk-security-onboarding.agent.md) | Automatically set up StackHawk security testing for your repository with generated configuration and GitHub Actions workflow | stackhawk-mcp<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code-0098FF?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscode?name=stackhawk-mcp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-VS_Code_Insiders-24bfa5?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=stackhawk-mcp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[![Install MCP](https://img.shields.io/badge/Install-Visual_Studio-C16FDE?style=flat-square)](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D) |
 | [Swift MCP Expert](../agents/swift-mcp-expert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fswift-mcp-expert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fswift-mcp-expert.agent.md) | Expert assistance for building Model Context Protocol servers in Swift using modern concurrency features and the official MCP Swift SDK. |  |
 | [Task Planner Instructions](../agents/task-planner.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftask-planner.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Ftask-planner.agent.md) | Task planner for creating actionable implementation plans - Brought to you by microsoft/edge-ai |  |
@@ -159,8 +159,8 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
 | [Ultimate Transparent Thinking Beast Mode](../agents/Ultimate-Transparent-Thinking-Beast-Mode.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FUltimate-Transparent-Thinking-Beast-Mode.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FUltimate-Transparent-Thinking-Beast-Mode.agent.md) | Ultimate Transparent Thinking Beast Mode |  |
 | [Universal Janitor](../agents/janitor.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjanitor.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjanitor.agent.md) | Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation. |  |
 | [Universal PR Comment Addresser](../agents/address-comments.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faddress-comments.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Faddress-comments.agent.md) | Address PR comments |  |
-| [voidBeast_GPT41Enhanced 1.0 - Elite Developer AI Assistant](../agents/voidbeast-gpt41enhanced.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvoidbeast-gpt41enhanced.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvoidbeast-gpt41enhanced.agent.md) | 4.1 voidBeast_GPT41Enhanced 1.0 : a advanced autonomous developer agent, designed for elite full-stack development with enhanced multi-mode capabilities. This latest evolution features sophisticated mode detection, comprehensive research capabilities, and never-ending problem resolution. Plan/Act/Deep Research/Analyzer/Checkpoints(Memory)/Prompt Generator Modes. |  |
+| [VoidBeast_GPT41Enhanced 1.0   Elite Developer AI Assistant](../agents/voidbeast-gpt41enhanced.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvoidbeast-gpt41enhanced.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fvoidbeast-gpt41enhanced.agent.md) | 4.1 voidBeast_GPT41Enhanced 1.0 : a advanced autonomous developer agent, designed for elite full-stack development with enhanced multi-mode capabilities. This latest evolution features sophisticated mode detection, comprehensive research capabilities, and never-ending problem resolution. Plan/Act/Deep Research/Analyzer/Checkpoints(Memory)/Prompt Generator Modes. |  |
 | [VSCode Tour Expert](../agents/code-tour.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcode-tour.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcode-tour.agent.md) | Expert agent for creating and maintaining VSCode CodeTour files with comprehensive schema support and best practices |  |
-| [Wg Code Alchemist](../agents/wg-code-alchemist.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md) | Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design |  |
-| [Wg Code Sentinel](../agents/wg-code-sentinel.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md) | Ask WG Code Sentinel to review your code for security issues. |  |
+| [WG Code Alchemist](../agents/wg-code-alchemist.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-alchemist.agent.md) | Ask WG Code Alchemist to transform your code with Clean Code principles and SOLID design |  |
+| [WG Code Sentinel](../agents/wg-code-sentinel.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fwg-code-sentinel.agent.md) | Ask WG Code Sentinel to review your code for security issues. |  |
 | [WinForms Expert](../agents/WinFormsExpert.agent.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FWinFormsExpert.agent.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FWinFormsExpert.agent.md) | Support development of .NET (OOP) WinForms Designer compatible Apps. |  |
diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs
index 05a23eec..ae63d4c8 100644
--- a/eng/generate-website-data.mjs
+++ b/eng/generate-website-data.mjs
@@ -44,7 +44,6 @@ function ensureDataDir() {
  * Extract title from filename or frontmatter
  */
 function extractTitle(filePath, frontmatter) {
-  if (frontmatter?.title) return frontmatter.title;
   if (frontmatter?.name) {
     return frontmatter.name
       .split("-")
diff --git a/eng/update-readme.mjs b/eng/update-readme.mjs
index b36d1351..99d4268b 100644
--- a/eng/update-readme.mjs
+++ b/eng/update-readme.mjs
@@ -128,12 +128,7 @@ function extractTitle(filePath) {
       const frontmatter = parseFrontmatter(filePath);
 
       if (frontmatter) {
-        // Check for title field
-        if (frontmatter.title && typeof frontmatter.title === "string") {
-          return frontmatter.title;
-        }
-
-        // Check for name field and convert to title case
+        // Check for name field
         if (frontmatter.name && typeof frontmatter.name === "string") {
           return frontmatter.name
             .split("-")
diff --git a/prompts/editorconfig.prompt.md b/prompts/editorconfig.prompt.md
index d563fbfb..23d6348e 100644
--- a/prompts/editorconfig.prompt.md
+++ b/prompts/editorconfig.prompt.md
@@ -1,5 +1,5 @@
 ---
-title: 'EditorConfig Expert'
+name: 'EditorConfig Expert'
 description: 'Generates a comprehensive and best-practice-oriented .editorconfig file based on project analysis and user preferences.'
 agent: 'agent'
 ---
diff --git a/prompts/java-refactoring-extract-method.prompt.md b/prompts/java-refactoring-extract-method.prompt.md
index 9659d1e7..0d65a6f3 100644
--- a/prompts/java-refactoring-extract-method.prompt.md
+++ b/prompts/java-refactoring-extract-method.prompt.md
@@ -1,5 +1,5 @@
 ---
-title: 'Refactoring Java Methods with Extract Method'
+name: 'Refactoring Java Methods with Extract Method'
 agent: 'agent'
 description: 'Refactoring using Extract Methods in Java Language'
 ---
diff --git a/prompts/java-refactoring-remove-parameter.prompt.md b/prompts/java-refactoring-remove-parameter.prompt.md
index 7b312f19..1f9a3cb8 100644
--- a/prompts/java-refactoring-remove-parameter.prompt.md
+++ b/prompts/java-refactoring-remove-parameter.prompt.md
@@ -1,5 +1,5 @@
 ---
-title: 'Refactoring Java Methods with Remove Parameter'
+name: 'Refactoring Java Methods with Remove Parameter'
 agent: 'agent'
 description: 'Refactoring using Remove Parameter in Java Language'
 ---
diff --git a/prompts/remember-interactive-programming.prompt.md b/prompts/remember-interactive-programming.prompt.md
index 36ebb45a..fb04c295 100644
--- a/prompts/remember-interactive-programming.prompt.md
+++ b/prompts/remember-interactive-programming.prompt.md
@@ -1,6 +1,6 @@
 ---
 description: 'A micro-prompt that reminds the agent that it is an interactive programmer. Works great in Clojure when Copilot has access to the REPL (probably via Backseat Driver). Will work with any system that has a live REPL that the agent can use. Adapt the prompt with any specific reminders in your workflow and/or workspace.'
-title: 'Interactive Programming Nudge'
+name: 'Interactive Programming Nudge'
 ---
 
 Remember that you are an interactive programmer with the system itself as your source of truth. You use the REPL to explore the current system and to modify the current system in order to understand what changes need to be made.

From dc1b93354ca565b14d7fe3a78b5099e81be7724d Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 14:30:19 +1100
Subject: [PATCH 30/49] Combine llms.txt generation with website data
 generation

- Move llms.txt generation into generate-website-data.mjs
- Remove standalone generate-llms-txt.mjs script
- Remove llms:generate npm script
- llms.txt now outputs to website/public/data/ alongside other generated files
---
 eng/generate-llms-txt.mjs     | 254 ----------------------------------
 eng/generate-website-data.mjs |  83 +++++++++++
 package.json                  |   3 +-
 3 files changed, 84 insertions(+), 256 deletions(-)
 delete mode 100644 eng/generate-llms-txt.mjs

diff --git a/eng/generate-llms-txt.mjs b/eng/generate-llms-txt.mjs
deleted file mode 100644
index cdf88ec6..00000000
--- a/eng/generate-llms-txt.mjs
+++ /dev/null
@@ -1,254 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "fs";
-import path from "path";
-import {
-  AGENTS_DIR,
-  INSTRUCTIONS_DIR,
-  PROMPTS_DIR,
-  SKILLS_DIR,
-  ROOT_FOLDER,
-} from "./constants.mjs";
-import { parseFrontmatter, parseSkillMetadata } from "./yaml-parser.mjs";
-
-/**
- * Extracts the name from a file based on its frontmatter or filename
- * @param {string} filePath - Path to the file (or directory for skills)
- * @param {string} fileType - Type of file (agent, prompt, instruction, skill)
- * @returns {string} - The name of the resource
- */
-function extractName(filePath, fileType) {
-  try {
-    if (fileType === "skill") {
-      // For skills, filePath is the skill directory
-      const skillMetadata = parseSkillMetadata(filePath);
-      return skillMetadata?.name || path.basename(filePath);
-    }
-
-    const frontmatter = parseFrontmatter(filePath);
-    if (frontmatter?.name) {
-      return frontmatter.name;
-    }
-
-    // Fallback to filename
-    const basename = path.basename(filePath, path.extname(filePath));
-    return basename
-      .replace(/\.(agent|prompt|instructions)$/, "")
-      .replace(/[-_]/g, " ")
-      .replace(/\b\w/g, (l) => l.toUpperCase());
-  } catch (error) {
-    console.error(`Error extracting name from ${filePath}: ${error.message}`);
-    const basename = path.basename(filePath, path.extname(filePath));
-    return basename.replace(/[-_]/g, " ");
-  }
-}
-
-/**
- * Extracts the description from a file's frontmatter
- * @param {string} filePath - Path to the file (or directory for skills)
- * @param {string} fileType - Type of file (agent, prompt, instruction, skill)
- * @returns {string} - The description of the resource (single line)
- */
-function extractDescription(filePath, fileType) {
-  try {
-    if (fileType === "skill") {
-      // For skills, filePath is the skill directory
-      const skillMetadata = parseSkillMetadata(filePath);
-      const description = skillMetadata?.description || "No description available";
-      // Convert multiline descriptions to single line
-      return description.replace(/\s+/g, " ").trim();
-    }
-
-    const frontmatter = parseFrontmatter(filePath);
-    const description = frontmatter?.description || "No description available";
-    // Convert multiline descriptions to single line
-    return description.replace(/\s+/g, " ").trim();
-  } catch (error) {
-    console.error(
-      `Error extracting description from ${filePath}: ${error.message}`
-    );
-    return "No description available";
-  }
-}
-
-/**
- * Gets the relative URL path for a resource
- * @param {string} filePath - Full path to the file
- * @param {string} baseDir - Base directory to calculate relative path from
- * @returns {string} - Relative URL path
- */
-function getRelativeUrl(filePath, baseDir) {
-  const basePath = baseDir || ROOT_FOLDER;
-  const relativePath = path.relative(basePath, filePath);
-  return relativePath.replace(/\\/g, "/");
-}
-
-/**
- * Generates llms.txt content according to the llmstxt.org specification
- * @returns {string} - The llms.txt file content
- */
-function generateLlmsTxt() {
-  let content = "";
-
-  // H1 header (required)
-  content += "# Awesome GitHub Copilot\n\n";
-
-  // Summary blockquote (optional but recommended)
-  content +=
-    "> A community-driven collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot experiences across various domains, languages, and use cases.\n\n";
-
-  // Add overview section
-  content += "## Overview\n\n";
-  content +=
-    "This repository provides resources to customize and enhance GitHub Copilot:\n\n";
-  content +=
-    "- **Agents**: Specialized GitHub Copilot agents that integrate with MCP servers\n";
-  content +=
-    "- **Prompts**: Task-specific prompts for code generation and problem-solving\n";
-  content +=
-    "- **Instructions**: Coding standards and best practices applied to specific file patterns\n";
-  content +=
-    "- **Skills**: Self-contained folders with instructions and bundled resources for specialized tasks\n\n";
-
-  // Process Agents
-  content += "## Agents\n\n";
-  const agentFiles = fs
-    .readdirSync(AGENTS_DIR)
-    .filter((file) => file.endsWith(".agent.md"))
-    .sort();
-
-  agentFiles.forEach((file) => {
-    const filePath = path.join(AGENTS_DIR, file);
-    const name = extractName(filePath, "agent");
-    const description = extractDescription(filePath, "agent");
-    const url = getRelativeUrl(filePath, ROOT_FOLDER);
-
-    content += `- [${name}](${url}): ${description}\n`;
-  });
-
-  content += "\n";
-
-  // Process Prompts
-  content += "## Prompts\n\n";
-  const promptFiles = fs
-    .readdirSync(PROMPTS_DIR)
-    .filter((file) => file.endsWith(".prompt.md"))
-    .sort();
-
-  promptFiles.forEach((file) => {
-    const filePath = path.join(PROMPTS_DIR, file);
-    const name = extractName(filePath, "prompt");
-    const description = extractDescription(filePath, "prompt");
-    const url = getRelativeUrl(filePath, ROOT_FOLDER);
-
-    content += `- [${name}](${url}): ${description}\n`;
-  });
-
-  content += "\n";
-
-  // Process Instructions
-  content += "## Instructions\n\n";
-  const instructionFiles = fs
-    .readdirSync(INSTRUCTIONS_DIR)
-    .filter((file) => file.endsWith(".instructions.md"))
-    .sort();
-
-  instructionFiles.forEach((file) => {
-    const filePath = path.join(INSTRUCTIONS_DIR, file);
-    const name = extractName(filePath, "instruction");
-    const description = extractDescription(filePath, "instruction");
-    const url = getRelativeUrl(filePath, ROOT_FOLDER);
-
-    content += `- [${name}](${url}): ${description}\n`;
-  });
-
-  content += "\n";
-
-  // Process Skills
-  content += "## Skills\n\n";
-  const skillDirs = fs
-    .readdirSync(SKILLS_DIR)
-    .filter((item) => {
-      const itemPath = path.join(SKILLS_DIR, item);
-      return fs.statSync(itemPath).isDirectory();
-    })
-    .sort();
-
-  skillDirs.forEach((dir) => {
-    const skillDirPath = path.join(SKILLS_DIR, dir);
-    const skillPath = path.join(skillDirPath, "SKILL.md");
-    
-    if (fs.existsSync(skillPath)) {
-      const name = extractName(skillDirPath, "skill");
-      const description = extractDescription(skillDirPath, "skill");
-      const url = getRelativeUrl(skillPath, ROOT_FOLDER);
-
-      content += `- [${name}](${url}): ${description}\n`;
-    } else {
-      console.warn(`Warning: Skill directory '${dir}' found without SKILL.md file`);
-    }
-  });
-
-  content += "\n";
-
-  // Add documentation links
-  content += "## Documentation\n\n";
-  content +=
-    "- [README.md](README.md): Main documentation and getting started guide\n";
-  content +=
-    "- [CONTRIBUTING.md](CONTRIBUTING.md): Guidelines for contributing to this repository\n";
-  content +=
-    "- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): Community standards and expectations\n";
-  content += "- [SECURITY.md](SECURITY.md): Security policies and reporting\n";
-  content += "- [AGENTS.md](AGENTS.md): Project overview and setup commands\n\n";
-
-  // Add repository information
-  content += "## Repository\n\n";
-  content +=
-    "- **GitHub**: https://github.com/github/awesome-copilot\n";
-  content += "- **License**: MIT\n";
-  content +=
-    "- **Website**: https://github.github.io/awesome-copilot\n";
-
-  return content;
-}
-
-/**
- * Main function to generate and write the llms.txt file
- * @param {string} [outputDir] - Optional output directory. Defaults to repository root.
- */
-function main(outputDir = ROOT_FOLDER) {
-  console.log("Generating llms.txt file...");
-
-  try {
-    const content = generateLlmsTxt();
-    const outputPath = path.join(outputDir, "llms.txt");
-
-    // Ensure output directory exists
-    if (!fs.existsSync(outputDir)) {
-      fs.mkdirSync(outputDir, { recursive: true });
-    }
-
-    fs.writeFileSync(outputPath, content, "utf8");
-
-    console.log(`✓ llms.txt generated successfully at ${outputPath}`);
-
-    // Count resources using a helper function
-    const countResources = (dirName) => {
-      const lines = content.split("\n");
-      return lines.filter((l) => l.startsWith("- [") && l.includes(`${dirName}/`)).length;
-    };
-
-    console.log(`  - ${countResources("agents")} agents`);
-    console.log(`  - ${countResources("prompts")} prompts`);
-    console.log(`  - ${countResources("instructions")} instructions`);
-    console.log(`  - ${countResources("skills")} skills`);
-  } catch (error) {
-    console.error(`Error generating llms.txt: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-// Support command-line argument for output directory
-const outputDir = process.argv[2];
-main(outputDir);
diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs
index 05a23eec..d4296e36 100644
--- a/eng/generate-website-data.mjs
+++ b/eng/generate-website-data.mjs
@@ -696,6 +696,84 @@ function generateSamplesData() {
   };
 }
 
+/**
+ * Generate llms.txt content according to the llmstxt.org specification
+ */
+function generateLlmsTxt(agents, prompts, instructions, skills) {
+  let content = "";
+
+  // H1 header (required)
+  content += "# Awesome GitHub Copilot\n\n";
+
+  // Summary blockquote (optional but recommended)
+  content +=
+    "> A community-driven collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot experiences across various domains, languages, and use cases.\n\n";
+
+  // Add overview section
+  content += "## Overview\n\n";
+  content +=
+    "This repository provides resources to customize and enhance GitHub Copilot:\n\n";
+  content +=
+    "- **Agents**: Specialized GitHub Copilot agents that integrate with MCP servers\n";
+  content +=
+    "- **Prompts**: Task-specific prompts for code generation and problem-solving\n";
+  content +=
+    "- **Instructions**: Coding standards and best practices applied to specific file patterns\n";
+  content +=
+    "- **Skills**: Self-contained folders with instructions and bundled resources for specialized tasks\n\n";
+
+  // Process Agents
+  content += "## Agents\n\n";
+  for (const agent of agents) {
+    const description = (agent.description || "No description available").replace(/\s+/g, " ").trim();
+    content += `- [${agent.title}](${agent.path}): ${description}\n`;
+  }
+  content += "\n";
+
+  // Process Prompts
+  content += "## Prompts\n\n";
+  for (const prompt of prompts) {
+    const description = (prompt.description || "No description available").replace(/\s+/g, " ").trim();
+    content += `- [${prompt.title}](${prompt.path}): ${description}\n`;
+  }
+  content += "\n";
+
+  // Process Instructions
+  content += "## Instructions\n\n";
+  for (const instruction of instructions) {
+    const description = (instruction.description || "No description available").replace(/\s+/g, " ").trim();
+    content += `- [${instruction.title}](${instruction.path}): ${description}\n`;
+  }
+  content += "\n";
+
+  // Process Skills
+  content += "## Skills\n\n";
+  for (const skill of skills) {
+    const description = (skill.description || "No description available").replace(/\s+/g, " ").trim();
+    content += `- [${skill.title}](${skill.skillFile}): ${description}\n`;
+  }
+  content += "\n";
+
+  // Add documentation links
+  content += "## Documentation\n\n";
+  content +=
+    "- [README.md](README.md): Main documentation and getting started guide\n";
+  content +=
+    "- [CONTRIBUTING.md](CONTRIBUTING.md): Guidelines for contributing to this repository\n";
+  content +=
+    "- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): Community standards and expectations\n";
+  content += "- [SECURITY.md](SECURITY.md): Security policies and reporting\n";
+  content += "- [AGENTS.md](AGENTS.md): Project overview and setup commands\n\n";
+
+  // Add repository information
+  content += "## Repository\n\n";
+  content += "- **GitHub**: https://github.com/github/awesome-copilot\n";
+  content += "- **License**: MIT\n";
+  content += "- **Website**: https://github.github.io/awesome-copilot\n";
+
+  return content;
+}
+
 /**
  * Main function
  */
@@ -817,6 +895,11 @@ async function main() {
   );
 
   console.log(`\n✓ All data written to website/public/data/`);
+
+  // Generate llms.txt
+  const llmsTxtContent = generateLlmsTxt(agents, prompts, instructions, skills);
+  fs.writeFileSync(path.join(WEBSITE_DATA_DIR, "llms.txt"), llmsTxtContent, "utf8");
+  console.log(`✓ llms.txt generated with ${agents.length} agents, ${prompts.length} prompts, ${instructions.length} instructions, ${skills.length} skills`);
 }
 
 main().catch((err) => {
diff --git a/package.json b/package.json
index e6150822..5a392bb4 100644
--- a/package.json
+++ b/package.json
@@ -7,7 +7,6 @@
   "scripts": {
     "start": "npm run build",
     "build": "node ./eng/update-readme.mjs",
-    "llms:generate": "node ./eng/generate-llms-txt.mjs",
     "contributors:add": "all-contributors add",
     "contributors:report": "node ./eng/contributor-report.mjs",
     "contributors:generate": "all-contributors generate",
@@ -18,7 +17,7 @@
     "skill:create": "node ./eng/create-skill.mjs",
     "website:data": "node ./eng/generate-website-data.mjs",
     "website:dev": "npm run website:data && npm run --prefix website dev",
-    "website:build": "npm run build && npm run website:data && node ./eng/generate-llms-txt.mjs website/public && npm run --prefix website build",
+    "website:build": "npm run build && npm run website:data && npm run --prefix website build",
     "website:preview": "npm run --prefix website preview"
   },
   "repository": {

From 07bc7659487173d22db3ac0f275b8c98894c312c Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 14:36:53 +1100
Subject: [PATCH 31/49] Update eng/generate-website-data.mjs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 eng/generate-website-data.mjs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs
index d4296e36..f3573ac6 100644
--- a/eng/generate-website-data.mjs
+++ b/eng/generate-website-data.mjs
@@ -898,7 +898,11 @@ async function main() {
 
   // Generate llms.txt
   const llmsTxtContent = generateLlmsTxt(agents, prompts, instructions, skills);
-  fs.writeFileSync(path.join(WEBSITE_DATA_DIR, "llms.txt"), llmsTxtContent, "utf8");
+  fs.writeFileSync(
+    path.join(ROOT_FOLDER, "website", "public", "llms.txt"),
+    llmsTxtContent,
+    "utf8"
+  );
   console.log(`✓ llms.txt generated with ${agents.length} agents, ${prompts.length} prompts, ${instructions.length} instructions, ${skills.length} skills`);
 }
 

From 9a2dbf276b2809139ff42120f6035f7ab2cd3499 Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 14:51:28 +1100
Subject: [PATCH 32/49] Move llms.txt generation to Astro endpoint

- Create website/src/pages/llms.txt.ts as an Astro static endpoint
- Remove generateLlmsTxt function from generate-website-data.mjs
- llms.txt is now generated at build time by Astro alongside other pages
---
 eng/generate-website-data.mjs | 93 ++-------------------------------
 website/src/pages/llms.txt.ts | 96 +++++++++++++++++++++++++++++++++++
 2 files changed, 99 insertions(+), 90 deletions(-)
 create mode 100644 website/src/pages/llms.txt.ts

diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs
index 79bdaefc..4a9b895c 100644
--- a/eng/generate-website-data.mjs
+++ b/eng/generate-website-data.mjs
@@ -26,10 +26,10 @@ import {
 } from "./yaml-parser.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
 
-const WEBSITE_DATA_DIR = path.join(ROOT_FOLDER, "website", "public", "data");
-const WEBSITE_SOURCE_DATA_DIR = path.join(ROOT_FOLDER, "website", "data");
+const WEBSITE_DIR = path.join(ROOT_FOLDER, "website");
+const WEBSITE_DATA_DIR = path.join(WEBSITE_DIR, "public", "data");
+const WEBSITE_SOURCE_DATA_DIR = path.join(WEBSITE_DIR, "data");
 
 /**
  * Ensure the output directory exists
@@ -695,84 +695,6 @@ function generateSamplesData() {
   };
 }
 
-/**
- * Generate llms.txt content according to the llmstxt.org specification
- */
-function generateLlmsTxt(agents, prompts, instructions, skills) {
-  let content = "";
-
-  // H1 header (required)
-  content += "# Awesome GitHub Copilot\n\n";
-
-  // Summary blockquote (optional but recommended)
-  content +=
-    "> A community-driven collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot experiences across various domains, languages, and use cases.\n\n";
-
-  // Add overview section
-  content += "## Overview\n\n";
-  content +=
-    "This repository provides resources to customize and enhance GitHub Copilot:\n\n";
-  content +=
-    "- **Agents**: Specialized GitHub Copilot agents that integrate with MCP servers\n";
-  content +=
-    "- **Prompts**: Task-specific prompts for code generation and problem-solving\n";
-  content +=
-    "- **Instructions**: Coding standards and best practices applied to specific file patterns\n";
-  content +=
-    "- **Skills**: Self-contained folders with instructions and bundled resources for specialized tasks\n\n";
-
-  // Process Agents
-  content += "## Agents\n\n";
-  for (const agent of agents) {
-    const description = (agent.description || "No description available").replace(/\s+/g, " ").trim();
-    content += `- [${agent.title}](${agent.path}): ${description}\n`;
-  }
-  content += "\n";
-
-  // Process Prompts
-  content += "## Prompts\n\n";
-  for (const prompt of prompts) {
-    const description = (prompt.description || "No description available").replace(/\s+/g, " ").trim();
-    content += `- [${prompt.title}](${prompt.path}): ${description}\n`;
-  }
-  content += "\n";
-
-  // Process Instructions
-  content += "## Instructions\n\n";
-  for (const instruction of instructions) {
-    const description = (instruction.description || "No description available").replace(/\s+/g, " ").trim();
-    content += `- [${instruction.title}](${instruction.path}): ${description}\n`;
-  }
-  content += "\n";
-
-  // Process Skills
-  content += "## Skills\n\n";
-  for (const skill of skills) {
-    const description = (skill.description || "No description available").replace(/\s+/g, " ").trim();
-    content += `- [${skill.title}](${skill.skillFile}): ${description}\n`;
-  }
-  content += "\n";
-
-  // Add documentation links
-  content += "## Documentation\n\n";
-  content +=
-    "- [README.md](README.md): Main documentation and getting started guide\n";
-  content +=
-    "- [CONTRIBUTING.md](CONTRIBUTING.md): Guidelines for contributing to this repository\n";
-  content +=
-    "- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): Community standards and expectations\n";
-  content += "- [SECURITY.md](SECURITY.md): Security policies and reporting\n";
-  content += "- [AGENTS.md](AGENTS.md): Project overview and setup commands\n\n";
-
-  // Add repository information
-  content += "## Repository\n\n";
-  content += "- **GitHub**: https://github.com/github/awesome-copilot\n";
-  content += "- **License**: MIT\n";
-  content += "- **Website**: https://github.github.io/awesome-copilot\n";
-
-  return content;
-}
-
 /**
  * Main function
  */
@@ -894,15 +816,6 @@ async function main() {
   );
 
   console.log(`\n✓ All data written to website/public/data/`);
-
-  // Generate llms.txt
-  const llmsTxtContent = generateLlmsTxt(agents, prompts, instructions, skills);
-  fs.writeFileSync(
-    path.join(ROOT_FOLDER, "website", "public", "llms.txt"),
-    llmsTxtContent,
-    "utf8"
-  );
-  console.log(`✓ llms.txt generated with ${agents.length} agents, ${prompts.length} prompts, ${instructions.length} instructions, ${skills.length} skills`);
 }
 
 main().catch((err) => {
diff --git a/website/src/pages/llms.txt.ts b/website/src/pages/llms.txt.ts
new file mode 100644
index 00000000..cf4ae811
--- /dev/null
+++ b/website/src/pages/llms.txt.ts
@@ -0,0 +1,96 @@
+import type { APIRoute } from "astro";
+import agentsData from "../../public/data/agents.json";
+import promptsData from "../../public/data/prompts.json";
+import instructionsData from "../../public/data/instructions.json";
+import skillsData from "../../public/data/skills.json";
+
+export const GET: APIRoute = () => {
+  const agents = agentsData.items;
+  const prompts = promptsData.items;
+  const instructions = instructionsData.items;
+  const skills = skillsData.items;
+
+  let content = "";
+
+  // H1 header (required)
+  content += "# Awesome GitHub Copilot\n\n";
+
+  // Summary blockquote (optional but recommended)
+  content +=
+    "> A community-driven collection of custom agents, prompts, instructions, and skills to enhance GitHub Copilot experiences across various domains, languages, and use cases.\n\n";
+
+  // Add overview section
+  content += "## Overview\n\n";
+  content +=
+    "This repository provides resources to customize and enhance GitHub Copilot:\n\n";
+  content +=
+    "- **Agents**: Specialized GitHub Copilot agents that integrate with MCP servers\n";
+  content +=
+    "- **Prompts**: Task-specific prompts for code generation and problem-solving\n";
+  content +=
+    "- **Instructions**: Coding standards and best practices applied to specific file patterns\n";
+  content +=
+    "- **Skills**: Self-contained folders with instructions and bundled resources for specialized tasks\n\n";
+
+  // Process Agents
+  content += "## Agents\n\n";
+  for (const agent of agents) {
+    const description = (agent.description || "No description available")
+      .replace(/\s+/g, " ")
+      .trim();
+    content += `- [${agent.title}](${agent.path}): ${description}\n`;
+  }
+  content += "\n";
+
+  // Process Prompts
+  content += "## Prompts\n\n";
+  for (const prompt of prompts) {
+    const description = (prompt.description || "No description available")
+      .replace(/\s+/g, " ")
+      .trim();
+    content += `- [${prompt.title}](${prompt.path}): ${description}\n`;
+  }
+  content += "\n";
+
+  // Process Instructions
+  content += "## Instructions\n\n";
+  for (const instruction of instructions) {
+    const description = (instruction.description || "No description available")
+      .replace(/\s+/g, " ")
+      .trim();
+    content += `- [${instruction.title}](${instruction.path}): ${description}\n`;
+  }
+  content += "\n";
+
+  // Process Skills
+  content += "## Skills\n\n";
+  for (const skill of skills) {
+    const description = (skill.description || "No description available")
+      .replace(/\s+/g, " ")
+      .trim();
+    content += `- [${skill.title}](${skill.skillFile}): ${description}\n`;
+  }
+  content += "\n";
+
+  // Add documentation links
+  content += "## Documentation\n\n";
+  content +=
+    "- [README.md](README.md): Main documentation and getting started guide\n";
+  content +=
+    "- [CONTRIBUTING.md](CONTRIBUTING.md): Guidelines for contributing to this repository\n";
+  content +=
+    "- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): Community standards and expectations\n";
+  content += "- [SECURITY.md](SECURITY.md): Security policies and reporting\n";
+  content +=
+    "- [AGENTS.md](AGENTS.md): Project overview and setup commands\n\n";
+
+  // Add repository information
+  content += "## Repository\n\n";
+  content += "- **GitHub**: https://github.com/github/awesome-copilot\n";
+  content += "- **License**: MIT\n";
+  content += "- **Website**: https://github.github.io/awesome-copilot\n";
+
+  return new Response(content, {
+    headers: { "Content-Type": "text/plain; charset=utf-8" },
+  });
+};

From 1a9b280c803fe9f669b608cd1f1c55bfce14b9a3 Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 14:54:42 +1100
Subject: [PATCH 33/49] Use absolute URLs in llms.txt

---
 website/src/pages/llms.txt.ts | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/website/src/pages/llms.txt.ts b/website/src/pages/llms.txt.ts
index cf4ae811..3cf5a9b8 100644
--- a/website/src/pages/llms.txt.ts
+++ b/website/src/pages/llms.txt.ts
@@ -4,11 +4,16 @@ import promptsData from "../../public/data/prompts.json";
 import instructionsData from "../../public/data/instructions.json";
 import skillsData from "../../public/data/skills.json";
 
+// Base URL for absolute links (to raw GitHub content)
+const GITHUB_RAW_BASE = "https://raw.githubusercontent.com/github/awesome-copilot/main";
+
 export const GET: APIRoute = () => {
   const agents = agentsData.items;
   const prompts = promptsData.items;
   const instructions = instructionsData.items;
   const skills = skillsData.items;
+  
+  const url = (path: string) => `${GITHUB_RAW_BASE}/${path}`;
 
   let content = "";
 
@@ -38,7 +43,7 @@ export const GET: APIRoute = () => {
     const description = (agent.description || "No description available")
       .replace(/\s+/g, " ")
       .trim();
-    content += `- [${agent.title}](${agent.path}): ${description}\n`;
+    content += `- [${agent.title}](${url(agent.path)}): ${description}\n`;
   }
   content += "\n";
 
@@ -48,7 +53,7 @@ export const GET: APIRoute = () => {
     const description = (prompt.description || "No description available")
       .replace(/\s+/g, " ")
       .trim();
-    content += `- [${prompt.title}](${prompt.path}): ${description}\n`;
+    content += `- [${prompt.title}](${url(prompt.path)}): ${description}\n`;
   }
   content += "\n";
 
@@ -58,7 +63,7 @@ export const GET: APIRoute = () => {
     const description = (instruction.description || "No description available")
       .replace(/\s+/g, " ")
       .trim();
-    content += `- [${instruction.title}](${instruction.path}): ${description}\n`;
+    content += `- [${instruction.title}](${url(instruction.path)}): ${description}\n`;
   }
   content += "\n";
 
@@ -68,21 +73,21 @@ export const GET: APIRoute = () => {
     const description = (skill.description || "No description available")
       .replace(/\s+/g, " ")
       .trim();
-    content += `- [${skill.title}](${skill.skillFile}): ${description}\n`;
+    content += `- [${skill.title}](${url(skill.skillFile)}): ${description}\n`;
   }
   content += "\n";
 
   // Add documentation links
   content += "## Documentation\n\n";
   content +=
-    "- [README.md](README.md): Main documentation and getting started guide\n";
+    `- [README.md](${url("README.md")}): Main documentation and getting started guide\n`;
   content +=
-    "- [CONTRIBUTING.md](CONTRIBUTING.md): Guidelines for contributing to this repository\n";
+    `- [CONTRIBUTING.md](${url("CONTRIBUTING.md")}): Guidelines for contributing to this repository\n`;
   content +=
-    "- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): Community standards and expectations\n";
-  content += "- [SECURITY.md](SECURITY.md): Security policies and reporting\n";
+    `- [CODE_OF_CONDUCT.md](${url("CODE_OF_CONDUCT.md")}): Community standards and expectations\n`;
+  content += `- [SECURITY.md](${url("SECURITY.md")}): Security policies and reporting\n`;
   content +=
-    "- [AGENTS.md](AGENTS.md): Project overview and setup commands\n\n";
+    `- [AGENTS.md](${url("AGENTS.md")}): Project overview and setup commands\n\n`;
 
   // Add repository information
   content += "## Repository\n\n";

From e32291ee9fa096244b3846869e7dab9f7aec2e67 Mon Sep 17 00:00:00 2001
From: Aaron Powell <me@aaron-powell.com>
Date: Tue, 3 Feb 2026 15:29:00 +1100
Subject: [PATCH 34/49] claiming the context7 entry

---
 context7.json | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 context7.json

diff --git a/context7.json b/context7.json
new file mode 100644
index 00000000..ac308939
--- /dev/null
+++ b/context7.json
@@ -0,0 +1,4 @@
+{
+  "url": "https://context7.com/github/awesome-copilot",
+  "public_key": "pk_8TIHuRHROWl7h8lwRzKDS"
+}

From 14c41bf058e79d83b9b44726585df2f88887bdac Mon Sep 17 00:00:00 2001
From: jun-shiromizu <jun.shiromizu@jp.nttdata.com>
Date: Tue, 3 Feb 2026 15:51:39 +0900
Subject: [PATCH 35/49] chore: add gitignore for skill scripts

---
 docs/README.skills.md                         |  2 +-
 skills/excalidraw-diagram-generator/SKILL.md  |  1 +
 .../scripts/.gitignore                        | 34 +++++++++++++++++++
 3 files changed, 36 insertions(+), 1 deletion(-)
 create mode 100644 skills/excalidraw-diagram-generator/scripts/.gitignore

diff --git a/docs/README.skills.md b/docs/README.skills.md
index 30e17136..fb3d2780 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -31,7 +31,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [azure-static-web-apps](../skills/azure-static-web-apps/SKILL.md) | Helps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configuring staticwebapp.config.json, adding Azure Functions APIs to SWA, or setting up GitHub Actions CI/CD for Static Web Apps. | None |
 | [chrome-devtools](../skills/chrome-devtools/SKILL.md) | Expert-level browser automation, debugging, and performance analysis using Chrome DevTools MCP. Use for interacting with web pages, capturing screenshots, analyzing network traffic, and profiling performance. | None |
 | [copilot-sdk](../skills/copilot-sdk/SKILL.md) | Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent. | None |
-| [excalidraw-diagram-generator](../skills/excalidraw-diagram-generator/SKILL.md) | Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw. | `references/element-types.md`<br />`references/excalidraw-schema.md`<br />`scripts/README.md`<br />`scripts/add-arrow.py`<br />`scripts/add-icon-to-diagram.py`<br />`scripts/split-excalidraw-library.py`<br />`templates/business-flow-swimlane-template.excalidraw`<br />`templates/class-diagram-template.excalidraw`<br />`templates/data-flow-diagram-template.excalidraw`<br />`templates/er-diagram-template.excalidraw`<br />`templates/flowchart-template.excalidraw`<br />`templates/mindmap-template.excalidraw`<br />`templates/relationship-template.excalidraw`<br />`templates/sequence-diagram-template.excalidraw` |
+| [excalidraw-diagram-generator](../skills/excalidraw-diagram-generator/SKILL.md) | Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw. | `references/element-types.md`<br />`references/excalidraw-schema.md`<br />`scripts/.gitignore`<br />`scripts/README.md`<br />`scripts/add-arrow.py`<br />`scripts/add-icon-to-diagram.py`<br />`scripts/split-excalidraw-library.py`<br />`templates/business-flow-swimlane-template.excalidraw`<br />`templates/class-diagram-template.excalidraw`<br />`templates/data-flow-diagram-template.excalidraw`<br />`templates/er-diagram-template.excalidraw`<br />`templates/flowchart-template.excalidraw`<br />`templates/mindmap-template.excalidraw`<br />`templates/relationship-template.excalidraw`<br />`templates/sequence-diagram-template.excalidraw` |
 | [gh-cli](../skills/gh-cli/SKILL.md) | GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line. | None |
 | [git-commit](../skills/git-commit/SKILL.md) | Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping | None |
 | [github-issues](../skills/github-issues/SKILL.md) | Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, or manage issue workflows. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", or any GitHub issue management task. | `references/templates.md` |
diff --git a/skills/excalidraw-diagram-generator/SKILL.md b/skills/excalidraw-diagram-generator/SKILL.md
index 1f040b36..e33fd902 100644
--- a/skills/excalidraw-diagram-generator/SKILL.md
+++ b/skills/excalidraw-diagram-generator/SKILL.md
@@ -594,6 +594,7 @@ See bundled references for:
 - `templates/mindmap-template.json` - Mind map starter
 - `scripts/split-excalidraw-library.py` - Tool to split `.excalidrawlib` files
 - `scripts/README.md` - Documentation for library tools
+- `scripts/.gitignore` - Prevents local Python artifacts from being committed
 
 ## Limitations
 
diff --git a/skills/excalidraw-diagram-generator/scripts/.gitignore b/skills/excalidraw-diagram-generator/scripts/.gitignore
new file mode 100644
index 00000000..bcc50b67
--- /dev/null
+++ b/skills/excalidraw-diagram-generator/scripts/.gitignore
@@ -0,0 +1,34 @@
+# Avoid accidentally committing local Python artifacts produced when running these scripts.
+
+# Byte-compiled / cache files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments (people often create these next to scripts)
+.venv/
+venv/
+env/
+ENV/
+
+# Tool caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.tox/
+.nox/
+
+# Coverage outputs
+.coverage
+.coverage.*
+htmlcov/
+
+# Packaging/build outputs (rare here, but harmless)
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# OS cruft
+.DS_Store
+Thumbs.db

From a6ac90852513ebd69ce8ecba6b03dc42566cbcc3 Mon Sep 17 00:00:00 2001
From: Jacrdif <29174946+Jcardif@users.noreply.github.com>
Date: Tue, 3 Feb 2026 10:06:49 +0300
Subject: [PATCH 36/49] Add Penpot MCP server setup and troubleshooting guide

---
 docs/README.skills.md                         |   2 +-
 skills/penpot-uiux-design/SKILL.md            |  59 ++++
 .../references/setup-troubleshooting.md       | 328 ++++++++++++++++++
 3 files changed, 388 insertions(+), 1 deletion(-)
 create mode 100644 skills/penpot-uiux-design/references/setup-troubleshooting.md

diff --git a/docs/README.skills.md b/docs/README.skills.md
index cedf8ec7..4ee0f067 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -42,7 +42,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [microsoft-code-reference](../skills/microsoft-code-reference/SKILL.md) | Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs. | None |
 | [microsoft-docs](../skills/microsoft-docs/SKILL.md) | Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices. | None |
 | [nuget-manager](../skills/nuget-manager/SKILL.md) | Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions. | None |
-| [penpot-uiux-design](../skills/penpot-uiux-design/SKILL.md) | Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library". | `references/accessibility.md`<br />`references/component-patterns.md`<br />`references/platform-guidelines.md` |
+| [penpot-uiux-design](../skills/penpot-uiux-design/SKILL.md) | Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library". | `references/accessibility.md`<br />`references/component-patterns.md`<br />`references/platform-guidelines.md`<br />`references/setup-troubleshooting.md` |
 | [plantuml-ascii](../skills/plantuml-ascii/SKILL.md) | Generate ASCII art diagrams using PlantUML text mode. Use when user asks to create ASCII diagrams, text-based diagrams, terminal-friendly diagrams, or mentions plantuml ascii, text diagram, ascii art diagram. Supports: Converting PlantUML diagrams to ASCII art, Creating sequence diagrams, class diagrams, flowcharts in ASCII format, Generating Unicode-enhanced ASCII art with -utxt flag | None |
 | [prd](../skills/prd/SKILL.md) | Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis. | None |
 | [refactor](../skills/refactor/SKILL.md) | Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements. | None |
diff --git a/skills/penpot-uiux-design/SKILL.md b/skills/penpot-uiux-design/SKILL.md
index 798711d2..b8f589e4 100644
--- a/skills/penpot-uiux-design/SKILL.md
+++ b/skills/penpot-uiux-design/SKILL.md
@@ -16,10 +16,69 @@ Create professional, user-centered designs in Penpot using the `penpot/penpot-mc
 | `mcp__penpot__import_image` | Import images (icons, photos, logos) into designs |
 | `mcp__penpot__penpot_api_info` | Retrieve Penpot API documentation |
 
+## MCP Server Setup
+
+The Penpot MCP tools require the `penpot/penpot-mcp` server running locally. For detailed installation and troubleshooting, see [setup-troubleshooting.md](references/setup-troubleshooting.md).
+
+### Before Setup: Check If Already Running
+
+**Always check if the MCP server is already available before attempting setup:**
+
+1. **Try calling a tool first**: Attempt `mcp__penpot__penpot_api_info` - if it succeeds, the server is running and connected. No setup needed.
+
+2. **If the tool fails**, ask the user:
+   > "The Penpot MCP server doesn't appear to be connected. Is the server already installed and running? If so, I can help troubleshoot. If not, I can guide you through the setup."
+
+3. **Only proceed with setup instructions if the user confirms the server is not installed.**
+
+### Quick Start (Only If Not Installed)
+
+```bash
+# Clone and install
+git clone https://github.com/penpot/penpot-mcp.git
+cd penpot-mcp
+npm install
+
+# Build and start servers
+npm run bootstrap
+```
+
+Then in Penpot:
+1. Open a design file
+2. Go to **Plugins** → **Load plugin from URL**
+3. Enter: `http://localhost:4400/manifest.json`
+4. Click **"Connect to MCP server"** in the plugin UI
+
+### VS Code Configuration
+
+Add to `settings.json`:
+```json
+{
+  "mcp": {
+    "servers": {
+      "penpot": {
+        "url": "http://localhost:4401/sse"
+      }
+    }
+  }
+}
+```
+
+### Troubleshooting (If Server Is Installed But Not Working)
+
+| Issue | Solution |
+| ----- | -------- |
+| Plugin won't connect | Check servers are running (`npm run start:all` in penpot-mcp dir) |
+| Browser blocks localhost | Allow local network access prompt, or disable Brave Shield, or try Firefox |
+| Tools not appearing in client | Restart VS Code/Claude completely after config changes |
+| Tool execution fails/times out | Ensure Penpot plugin UI is open and shows "Connected" |
+| "WebSocket connection failed" | Check firewall allows ports 4400, 4401, 4402 |
+
 ## Quick Reference
 
 | Task | Reference File |
 | ---- | -------------- |
+| MCP server installation & troubleshooting | [setup-troubleshooting.md](references/setup-troubleshooting.md) |
 | Component specs (buttons, forms, nav) | [component-patterns.md](references/component-patterns.md) |
 | Accessibility (contrast, touch targets) | [accessibility.md](references/accessibility.md) |
 | Screen sizes & platform specs | [platform-guidelines.md](references/platform-guidelines.md) |
diff --git a/skills/penpot-uiux-design/references/setup-troubleshooting.md b/skills/penpot-uiux-design/references/setup-troubleshooting.md
new file mode 100644
index 00000000..68deff68
--- /dev/null
+++ b/skills/penpot-uiux-design/references/setup-troubleshooting.md
@@ -0,0 +1,328 @@
+# Penpot MCP Server Setup & Troubleshooting
+
+Complete guide for installing, configuring, and troubleshooting the Penpot MCP Server.
+
+## Architecture Overview
+
+The Penpot MCP integration requires **three components** working together:
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│   MCP Client    │────▶│   MCP Server    │◀───▶│  Penpot Plugin  │
+│ (VS Code/Claude)│     │  (port 4401)    │     │ (in browser)    │
+└─────────────────┘     └────────┬────────┘     └────────┬────────┘
+                                 │                       │
+                                 │    WebSocket          │
+                                 │    (port 4402)        │
+                                 └───────────────────────┘
+```
+
+1. **MCP Server** - Exposes tools to your AI client (HTTP on port 4401)
+2. **Plugin Server** - Serves the Penpot plugin files (HTTP on port 4400)
+3. **Penpot MCP Plugin** - Runs inside Penpot browser, executes design commands
+
+## Prerequisites
+
+- **Node.js v22+** - [Download](https://nodejs.org/)
+- **Git** - For cloning the repository
+- **Modern browser** - Chrome, Firefox, or Chromium-based browser
+
+Verify Node.js installation:
+```bash
+node --version  # Should be v22.x or higher
+npm --version
+npx --version
+```
+
+## Installation
+
+### Step 1: Clone and Install
+
+```bash
+# Clone the repository
+git clone https://github.com/penpot/penpot-mcp.git
+cd penpot-mcp
+
+# Install dependencies
+npm install
+```
+
+### Step 2: Build and Start Servers
+
+```bash
+# Build all components and start servers
+npm run bootstrap
+```
+
+This command:
+
+- Installs dependencies for all components
+- Builds the MCP server and plugin
+- Starts both servers (MCP on 4401, Plugin on 4400)
+
+**Expected output:**
+
+```txt
+MCP Server listening on http://localhost:4401
+Plugin server listening on http://localhost:4400
+WebSocket server listening on port 4402
+```
+
+### Step 3: Load Plugin in Penpot
+
+1. Open [Penpot](https://design.penpot.app/) in your browser
+2. Open or create a design file
+3. Go to **Plugins** menu (or press the plugins icon)
+4. Click **Load plugin from URL**
+5. Enter: `http://localhost:4400/manifest.json`
+6. The plugin UI will appear - click **"Connect to MCP server"**
+7. Status should change to **"Connected to MCP server"**
+
+> **Important**: Keep the plugin UI open while using MCP tools. Closing it disconnects the server.
+
+### Step 4: Configure Your MCP Client
+
+#### VS Code with GitHub Copilot
+
+Add to your VS Code `settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "penpot": {
+        "url": "http://localhost:4401/sse"
+      }
+    }
+  }
+}
+```
+
+Or use the HTTP endpoint:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "penpot": {
+        "url": "http://localhost:4401/mcp"
+      }
+    }
+  }
+}
+```
+
+#### Claude Desktop
+
+Claude Desktop requires the `mcp-remote` proxy (stdio-only transport):
+
+1. Install the proxy:
+
+   ```bash
+   npm install -g mcp-remote
+   ```
+
+2. Edit Claude Desktop config:
+   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
+   - **Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+3. Add the Penpot server:
+
+   ```json
+   {
+     "mcpServers": {
+       "penpot": {
+         "command": "npx",
+         "args": ["-y", "mcp-remote", "http://localhost:4401/sse", "--allow-http"]
+       }
+     }
+   }
+   ```
+
+4. **Fully quit** Claude Desktop (File → Quit, not just close window) and restart
+
+#### Claude Code (CLI)
+
+```bash
+claude mcp add penpot -t http http://localhost:4401/mcp
+```
+
+## Troubleshooting
+
+### Connection Issues
+
+#### "Plugin cannot connect to MCP server"
+
+**Symptoms**: Plugin shows "Not connected" even after clicking Connect
+
+**Solutions**:
+
+1. Verify servers are running:
+   ```bash
+   # Check if ports are in use
+   lsof -i :4401  # MCP server
+   lsof -i :4402  # WebSocket
+   lsof -i :4400  # Plugin server
+   ```
+
+2. Restart the servers:
+
+   ```bash
+   # In the penpot-mcp directory
+   npm run start:all
+   ```
+
+3. Check browser console (F12) for WebSocket errors
+
+#### Browser Blocks Local Connection
+
+**Symptoms**: Browser refuses to connect to localhost from Penpot
+
+**Cause**: Chromium 142+ enforces Private Network Access (PNA) restrictions
+
+**Solutions**:
+
+1. **Chrome/Chromium**: When prompted, allow access to local network
+2. **Brave**: Disable Shield for the Penpot website:
+   - Click the Brave Shield icon in address bar
+   - Toggle Shield off for this site
+3. **Try Firefox**: Firefox doesn't enforce these restrictions as strictly
+
+#### "WebSocket connection failed"
+
+**Solutions**:
+
+1. Check firewall settings - allow ports 4400, 4401, 4402
+2. Disable VPN if active
+3. Check for conflicting applications using the same ports
+
+### MCP Client Issues
+
+#### Tools Not Appearing in VS Code/Claude
+
+1. **Verify endpoint**:
+
+   ```bash
+   # Test the SSE endpoint
+   curl http://localhost:4401/sse
+   
+   # Test the MCP endpoint
+   curl http://localhost:4401/mcp
+   ```
+
+2. **Check configuration syntax** - JSON must be valid
+3. **Restart the MCP client** completely
+4. **Check MCP server logs**:
+
+   ```bash
+   # Logs are in mcp-server/logs/
+   tail -f mcp-server/logs/mcp-server.log
+   ```
+
+#### "Tool execution timed out"
+
+**Cause**: Plugin disconnected or operation took too long
+
+**Solutions**:
+
+1. Ensure plugin UI is still open in Penpot
+2. Verify plugin shows "Connected" status
+3. Try reconnecting: click Disconnect then Connect in plugin
+
+### Plugin Issues
+
+#### "Plugin failed to load"
+
+1. Verify plugin server is running on port 4400
+2. Try accessing `http://localhost:4400/manifest.json` directly in browser
+3. Clear browser cache and reload Penpot
+4. Remove and re-add the plugin
+
+#### "Cannot find penpot object"
+
+**Cause**: Plugin not properly initialized or design file not open
+
+**Solutions**:
+
+1. Make sure you have a design file open (not just the dashboard)
+2. Wait a few seconds after opening file before connecting
+3. Refresh Penpot and reload the plugin
+
+### Server Issues
+
+#### Port Already in Use
+
+```bash
+# Find process using the port
+lsof -i :4401
+
+# Kill the process if needed
+kill -9 <PID>
+```
+
+Or configure different ports via environment variables:
+```bash
+PENPOT_MCP_SERVER_PORT=4501 npm run start:all
+```
+
+#### Server Crashes on Startup
+
+1. Check Node.js version (must be v22+)
+2. Delete `node_modules` and reinstall:
+
+   ```bash
+   rm -rf node_modules
+   npm install
+   npm run bootstrap
+   ```
+
+## Configuration Reference
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PENPOT_MCP_SERVER_PORT` | 4401 | HTTP/SSE server port |
+| `PENPOT_MCP_WEBSOCKET_PORT` | 4402 | WebSocket server port |
+| `PENPOT_MCP_SERVER_LISTEN_ADDRESS` | localhost | Server bind address |
+| `PENPOT_MCP_LOG_LEVEL` | info | Log level (trace/debug/info/warn/error) |
+| `PENPOT_MCP_LOG_DIR` | logs | Log file directory |
+| `PENPOT_MCP_REMOTE_MODE` | false | Enable remote mode (disables file system access) |
+
+### Example: Custom Configuration
+
+```bash
+# Run on different ports with debug logging
+PENPOT_MCP_SERVER_PORT=5000 \
+PENPOT_MCP_WEBSOCKET_PORT=5001 \
+PENPOT_MCP_LOG_LEVEL=debug \
+npm run start:all
+```
+
+## Verifying the Setup
+
+Run this checklist to confirm everything works:
+
+1. **Servers Running**:
+   ```bash
+   curl -s http://localhost:4401/sse | head -1
+   # Should return SSE stream headers
+   ```
+
+2. **Plugin Connected**: Plugin UI shows "Connected to MCP server"
+
+3. **Tools Available**: In your MCP client, verify these tools appear:
+   - `mcp__penpot__execute_code`
+   - `mcp__penpot__export_shape`
+   - `mcp__penpot__import_image`
+   - `mcp__penpot__penpot_api_info`
+
+4. **Test Execution**: Ask your AI assistant to run a simple command:
+   > "Use Penpot to get the current page name"
+
+## Getting Help
+
+- **GitHub Issues**: [penpot/penpot-mcp/issues](https://github.com/penpot/penpot-mcp/issues)
+- **GitHub Discussions**: [penpot/penpot-mcp/discussions](https://github.com/penpot/penpot-mcp/discussions)
+- **Penpot Community**: [community.penpot.app](https://community.penpot.app/)

From 545af30adeef66f5d44467d33fdbc393ae54519a Mon Sep 17 00:00:00 2001
From: Mohammad <mmohammadq8@outlook.com>
Date: Tue, 3 Feb 2026 12:29:33 +0300
Subject: [PATCH 37/49] Add Power BI modeling skill

---
 docs/README.skills.md                         |   1 +
 skills/powerbi-modeling/SKILL.md              | 153 ++++++++++++
 .../references/MEASURES-DAX.md                | 195 +++++++++++++++
 .../references/PERFORMANCE.md                 | 215 +++++++++++++++++
 .../references/RELATIONSHIPS.md               | 147 ++++++++++++
 skills/powerbi-modeling/references/RLS.md     | 226 ++++++++++++++++++
 .../references/STAR-SCHEMA.md                 | 103 ++++++++
 7 files changed, 1040 insertions(+)
 create mode 100644 skills/powerbi-modeling/SKILL.md
 create mode 100644 skills/powerbi-modeling/references/MEASURES-DAX.md
 create mode 100644 skills/powerbi-modeling/references/PERFORMANCE.md
 create mode 100644 skills/powerbi-modeling/references/RELATIONSHIPS.md
 create mode 100644 skills/powerbi-modeling/references/RLS.md
 create mode 100644 skills/powerbi-modeling/references/STAR-SCHEMA.md

diff --git a/docs/README.skills.md b/docs/README.skills.md
index bdb1c155..ccfd9379 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -43,6 +43,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [microsoft-docs](../skills/microsoft-docs/SKILL.md) | Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices. | None |
 | [nuget-manager](../skills/nuget-manager/SKILL.md) | Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions. | None |
 | [plantuml-ascii](../skills/plantuml-ascii/SKILL.md) | Generate ASCII art diagrams using PlantUML text mode. Use when user asks to create ASCII diagrams, text-based diagrams, terminal-friendly diagrams, or mentions plantuml ascii, text diagram, ascii art diagram. Supports: Converting PlantUML diagrams to ASCII art, Creating sequence diagrams, class diagrams, flowcharts in ASCII format, Generating Unicode-enhanced ASCII art with -utxt flag | None |
+| [powerbi-modeling](../skills/powerbi-modeling/SKILL.md) | Power BI semantic modeling assistant for building optimized data models. Use when working with Power BI semantic models, creating measures, designing star schemas, configuring relationships, implementing RLS, or optimizing model performance. Triggers on queries about DAX calculations, table relationships, dimension/fact table design, naming conventions, model documentation, cardinality, cross-filter direction, calculation groups, and data model best practices. Always connects to the active model first using power-bi-modeling MCP tools to understand the data structure before providing guidance. | `references/MEASURES-DAX.md`<br />`references/PERFORMANCE.md`<br />`references/RELATIONSHIPS.md`<br />`references/RLS.md`<br />`references/STAR-SCHEMA.md` |
 | [prd](../skills/prd/SKILL.md) | Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis. | None |
 | [refactor](../skills/refactor/SKILL.md) | Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements. | None |
 | [scoutqa-test](../skills/scoutqa-test/SKILL.md) | This skill should be used when the user asks to "test this website", "run exploratory testing", "check for accessibility issues", "verify the login flow works", "find bugs on this page", or requests automated QA testing. Triggers on web application testing scenarios including smoke tests, accessibility audits, e-commerce flows, and user flow validation using ScoutQA CLI. IMPORTANT: Use this skill proactively after implementing web application features to verify they work correctly - don't wait for the user to ask for testing. | None |
diff --git a/skills/powerbi-modeling/SKILL.md b/skills/powerbi-modeling/SKILL.md
new file mode 100644
index 00000000..8b2abcd0
--- /dev/null
+++ b/skills/powerbi-modeling/SKILL.md
@@ -0,0 +1,153 @@
+---
+name: powerbi-modeling
+description: Power BI semantic modeling assistant for building optimized data models. Use when working with Power BI semantic models, creating measures, designing star schemas, configuring relationships, implementing RLS, or optimizing model performance. Triggers on queries about DAX calculations, table relationships, dimension/fact table design, naming conventions, model documentation, cardinality, cross-filter direction, calculation groups, and data model best practices. Always connects to the active model first using power-bi-modeling MCP tools to understand the data structure before providing guidance.
+---
+
+# Power BI Semantic Modeling
+
+Guide users in building optimized, well-documented Power BI semantic models following Microsoft best practices.
+
+## When to Use This Skill
+
+Use this skill when users ask about:
+- Creating or optimizing Power BI semantic models
+- Designing star schemas (dimension/fact tables)
+- Writing DAX measures or calculated columns
+- Configuring table relationships (cardinality, cross-filter)
+- Implementing row-level security (RLS)
+- Naming conventions for tables, columns, measures
+- Adding descriptions and documentation to models
+- Performance tuning and optimization
+- Calculation groups and field parameters
+- Model validation and best practice checks
+
+**Trigger phrases:** "create a measure", "add relationship", "star schema", "optimize model", "DAX formula", "RLS", "naming convention", "model documentation", "cardinality", "cross-filter"
+
+## Prerequisites
+
+### Required Tools
+- **Power BI Modeling MCP Server**: Required for connecting to and modifying semantic models
+  - Enables: connection_operations, table_operations, measure_operations, relationship_operations, etc.
+  - Must be configured and running to interact with models
+
+### Optional Dependencies
+- **Microsoft Learn MCP Server**: Recommended for researching latest best practices
+  - Enables: microsoft_docs_search, microsoft_docs_fetch
+  - Use for complex scenarios, new features, and official documentation
+
+## Workflow
+
+### 1. Connect and Analyze First
+
+Before providing any modeling guidance, always examine the current model state:
+
+```
+1. List connections: connection_operations(operation: "ListConnections")
+2. If no connection, check for local instances: connection_operations(operation: "ListLocalInstances")
+3. Connect to the model (Desktop or Fabric)
+4. Get model overview: model_operations(operation: "Get")
+5. List tables: table_operations(operation: "List")
+6. List relationships: relationship_operations(operation: "List")
+7. List measures: measure_operations(operation: "List")
+```
+
+### 2. Evaluate Model Health
+
+After connecting, assess the model against best practices:
+
+- **Star Schema**: Are tables properly classified as dimension or fact?
+- **Relationships**: Correct cardinality? Minimal bidirectional filters?
+- **Naming**: Human-readable, consistent naming conventions?
+- **Documentation**: Do tables, columns, measures have descriptions?
+- **Measures**: Explicit measures for key calculations?
+- **Hidden Fields**: Are technical columns hidden from report view?
+
+### 3. Provide Targeted Guidance
+
+Based on analysis, guide improvements using references:
+- Star schema design: See [STAR-SCHEMA.md](references/STAR-SCHEMA.md)
+- Relationship configuration: See [RELATIONSHIPS.md](references/RELATIONSHIPS.md)
+- DAX measures and naming: See [MEASURES-DAX.md](references/MEASURES-DAX.md)
+- Performance optimization: See [PERFORMANCE.md](references/PERFORMANCE.md)
+- Row-level security: See [RLS.md](references/RLS.md)
+
+## Quick Reference: Model Quality Checklist
+
+| Area | Best Practice |
+|------|--------------|
+| Tables | Clear dimension vs fact classification |
+| Naming | Human-readable: `Customer Name` not `CUST_NM` |
+| Descriptions | All tables, columns, measures documented |
+| Measures | Explicit DAX measures for business metrics |
+| Relationships | One-to-many from dimension to fact |
+| Cross-filter | Single direction unless specifically needed |
+| Hidden fields | Hide technical keys, IDs from report view |
+| Date table | Dedicated marked date table |
+
+## MCP Tools Reference
+
+Use these Power BI Modeling MCP operations:
+
+| Operation Category | Key Operations |
+|-------------------|----------------|
+| `connection_operations` | Connect, ListConnections, ListLocalInstances, ConnectFabric |
+| `model_operations` | Get, GetStats, ExportTMDL |
+| `table_operations` | List, Get, Create, Update, GetSchema |
+| `column_operations` | List, Get, Create, Update (descriptions, hidden, format) |
+| `measure_operations` | List, Get, Create, Update, Move |
+| `relationship_operations` | List, Get, Create, Update, Activate, Deactivate |
+| `dax_query_operations` | Execute, Validate |
+| `calculation_group_operations` | List, Create, Update |
+| `security_role_operations` | List, Create, Update, GetEffectivePermissions |
+
+## Common Tasks
+
+### Add Measure with Description
+```
+measure_operations(
+  operation: "Create",
+  definitions: [{
+    name: "Total Sales",
+    tableName: "Sales",
+    expression: "SUM(Sales[Amount])",
+    formatString: "$#,##0",
+    description: "Sum of all sales amounts"
+  }]
+)
+```
+
+### Update Column Description
+```
+column_operations(
+  operation: "Update",
+  definitions: [{
+    tableName: "Customer",
+    name: "CustomerKey",
+    description: "Unique identifier for customer dimension",
+    isHidden: true
+  }]
+)
+```
+
+### Create Relationship
+```
+relationship_operations(
+  operation: "Create",
+  definitions: [{
+    fromTable: "Sales",
+    fromColumn: "CustomerKey",
+    toTable: "Customer",
+    toColumn: "CustomerKey",
+    crossFilteringBehavior: "OneDirection"
+  }]
+)
+```
+
+## When to Use Microsoft Learn MCP
+
+Research current best practices using `microsoft_docs_search` for:
+- Latest DAX function documentation
+- New Power BI features and capabilities
+- Complex modeling scenarios (SCD Type 2, many-to-many)
+- Performance optimization techniques
+- Security implementation patterns
diff --git a/skills/powerbi-modeling/references/MEASURES-DAX.md b/skills/powerbi-modeling/references/MEASURES-DAX.md
new file mode 100644
index 00000000..2bd6ff07
--- /dev/null
+++ b/skills/powerbi-modeling/references/MEASURES-DAX.md
@@ -0,0 +1,195 @@
+# DAX Measures and Naming Conventions
+
+## Naming Conventions
+
+### General Rules
+- Use human-readable names (spaces allowed)
+- Be descriptive: `Total Sales Amount` not `TSA`
+- Avoid abbreviations unless universally understood
+- Use consistent capitalization (Title Case recommended)
+- Avoid special characters except spaces
+
+### Table Naming
+| Type | Convention | Example |
+|------|------------|---------|
+| Dimension | Singular noun | Customer, Product, Date |
+| Fact | Business process | Sales, Orders, Inventory |
+| Bridge | Combined names | CustomerAccount, ProductCategory |
+| Measure Table | Underscore prefix | _Measures, _KPIs |
+
+### Column Naming
+| Type | Convention | Example |
+|------|------------|---------|
+| Keys | Suffix with "Key" or "ID" | CustomerKey, ProductID |
+| Dates | Suffix with "Date" | OrderDate, ShipDate |
+| Amounts | Descriptive with unit hint | SalesAmount, QuantitySold |
+| Flags | Prefix with "Is" or "Has" | IsActive, HasDiscount |
+
+### Measure Naming
+| Type | Convention | Example |
+|------|------------|---------|
+| Aggregations | Verb + Noun | Total Sales, Count of Orders |
+| Ratios | X per Y or X Rate | Sales per Customer, Conversion Rate |
+| Time Intelligence | Period + Metric | YTD Sales, PY Total Sales |
+| Comparisons | Metric + vs + Baseline | Sales vs Budget, Growth vs PY |
+
+## Explicit vs Implicit Measures
+
+### Always Create Explicit Measures For:
+1. Key business metrics users will query
+2. Complex calculations with filter manipulation
+3. Measures used in MDX (Excel PivotTables)
+4. Controlled aggregation (prevent sum of averages)
+
+### Implicit Measures (Column Aggregations)
+- Acceptable for simple exploration
+- Set correct SummarizeBy property:
+  - Amounts: Sum
+  - Keys/IDs: None (Do Not Summarize)
+  - Rates/Prices: None or Average
+
+## Measure Patterns
+
+### Basic Aggregations
+```dax
+Total Sales = SUM(Sales[SalesAmount])
+Order Count = COUNTROWS(Sales)
+Average Order Value = DIVIDE([Total Sales], [Order Count])
+Distinct Customers = DISTINCTCOUNT(Sales[CustomerKey])
+```
+
+### Time Intelligence (Requires Date Table)
+```dax
+YTD Sales = TOTALYTD([Total Sales], 'Date'[Date])
+MTD Sales = TOTALMTD([Total Sales], 'Date'[Date])
+PY Sales = CALCULATE([Total Sales], SAMEPERIODLASTYEAR('Date'[Date]))
+YoY Growth = DIVIDE([Total Sales] - [PY Sales], [PY Sales])
+```
+
+### Percentage Calculations
+```dax
+Sales % of Total = 
+DIVIDE(
+    [Total Sales],
+    CALCULATE([Total Sales], REMOVEFILTERS(Product))
+)
+
+Margin % = DIVIDE([Gross Profit], [Total Sales])
+```
+
+### Running Totals
+```dax
+Running Total = 
+CALCULATE(
+    [Total Sales],
+    FILTER(
+        ALL('Date'),
+        'Date'[Date] <= MAX('Date'[Date])
+    )
+)
+```
+
+## Column References
+
+### Best Practice: Always Qualify Column Names
+```dax
+// GOOD - Fully qualified
+Sales Amount = SUM(Sales[SalesAmount])
+
+// BAD - Unqualified (can cause ambiguity)
+Sales Amount = SUM([SalesAmount])
+```
+
+### Measure References: Never Qualify
+```dax
+// GOOD - Unqualified measure
+YTD Sales = TOTALYTD([Total Sales], 'Date'[Date])
+
+// BAD - Qualified measure (breaks if home table changes)
+YTD Sales = TOTALYTD(Sales[Total Sales], 'Date'[Date])
+```
+
+## Documentation
+
+### Measure Descriptions
+Always add descriptions explaining:
+- What the measure calculates
+- Business context/usage
+- Any important assumptions
+
+```
+measure_operations(
+  operation: "Update",
+  definitions: [{
+    name: "Total Sales",
+    tableName: "Sales",
+    description: "Sum of all completed sales transactions. Excludes returns and cancelled orders."
+  }]
+)
+```
+
+### Format Strings
+| Data Type | Format String | Example Output |
+|-----------|---------------|----------------|
+| Currency | $#,##0.00 | $1,234.56 |
+| Percentage | 0.0% | 12.3% |
+| Whole Number | #,##0 | 1,234 |
+| Decimal | #,##0.00 | 1,234.56 |
+
+## Display Folders
+
+Organize measures into logical groups:
+```
+measure_operations(
+  operation: "Update",
+  definitions: [{
+    name: "YTD Sales",
+    tableName: "_Measures",
+    displayFolder: "Time Intelligence\\Year"
+  }]
+)
+```
+
+Common folder structure:
+```
+_Measures
+├── Sales
+│   ├── Total Sales
+│   └── Average Sale
+├── Time Intelligence
+│   ├── Year
+│   │   ├── YTD Sales
+│   │   └── PY Sales
+│   └── Month
+│       └── MTD Sales
+└── Ratios
+    ├── Margin %
+    └── Conversion Rate
+```
+
+## Variables for Performance
+
+Use variables to:
+- Avoid recalculating the same expression
+- Improve readability
+- Enable debugging
+
+```dax
+Gross Margin % = 
+VAR TotalSales = [Total Sales]
+VAR TotalCost = [Total Cost]
+VAR GrossProfit = TotalSales - TotalCost
+RETURN
+    DIVIDE(GrossProfit, TotalSales)
+```
+
+## Validation Checklist
+
+- [ ] All key business metrics have explicit measures
+- [ ] Measures have clear, descriptive names
+- [ ] Measures have descriptions
+- [ ] Appropriate format strings applied
+- [ ] Display folders organize related measures
+- [ ] Column references are fully qualified
+- [ ] Measure references are not qualified
+- [ ] Variables used for complex calculations
diff --git a/skills/powerbi-modeling/references/PERFORMANCE.md b/skills/powerbi-modeling/references/PERFORMANCE.md
new file mode 100644
index 00000000..c7a3428e
--- /dev/null
+++ b/skills/powerbi-modeling/references/PERFORMANCE.md
@@ -0,0 +1,215 @@
+# Performance Optimization for Power BI Models
+
+## Data Reduction Techniques
+
+### 1. Remove Unnecessary Columns
+- Only import columns needed for reporting
+- Remove audit columns (CreatedBy, ModifiedDate) unless required
+- Remove duplicate/redundant columns
+
+```
+column_operations(operation: "List", filter: { tableNames: ["Sales"] })
+// Review and remove unneeded columns
+```
+
+### 2. Remove Unnecessary Rows
+- Filter historical data to relevant period
+- Exclude cancelled/void transactions if not needed
+- Apply filters in Power Query (not in DAX)
+
+### 3. Reduce Cardinality
+High cardinality (many unique values) impacts:
+- Model size
+- Refresh time
+- Query performance
+
+**Solutions:**
+| Column Type | Reduction Technique |
+|-------------|---------------------|
+| DateTime | Split into Date and Time columns |
+| Decimal precision | Round to needed precision |
+| Text with patterns | Extract common prefix/suffix |
+| High-precision IDs | Use surrogate integer keys |
+
+### 4. Optimize Data Types
+| From | To | Benefit |
+|------|-----|---------|
+| DateTime | Date (if time not needed) | 8 bytes to 4 bytes |
+| Decimal | Fixed Decimal | Better compression |
+| Text with numbers | Whole Number | Much better compression |
+| Long text | Shorter text | Reduces storage |
+
+### 5. Group and Summarize
+Pre-aggregate data when detail not needed:
+- Daily instead of transactional
+- Monthly instead of daily
+- Consider aggregation tables for DirectQuery
+
+## Column Optimization
+
+### Prefer Power Query Columns Over Calculated Columns
+| Approach | When to Use |
+|----------|-------------|
+| Power Query (M) | Can be computed at source, static values |
+| Calculated Column (DAX) | Needs model relationships, dynamic logic |
+
+Power Query columns:
+- Load faster
+- Compress better
+- Use less memory
+
+### Avoid Calculated Columns on Relationship Keys
+DAX calculated columns in relationships:
+- Cannot use indexes
+- Generate complex SQL for DirectQuery
+- Hurt performance significantly
+
+**Use COMBINEVALUES for multi-column relationships:**
+```dax
+// If you must use calculated column for composite key
+CompositeKey = COMBINEVALUES(",", [Country], [City])
+```
+
+### Set Appropriate Summarization
+Prevent accidental aggregation of non-additive columns:
+```
+column_operations(
+  operation: "Update",
+  definitions: [{
+    tableName: "Product",
+    name: "UnitPrice",
+    summarizeBy: "None"
+  }]
+)
+```
+
+## Relationship Optimization
+
+### 1. Minimize Bidirectional Relationships
+Each bidirectional relationship:
+- Increases query complexity
+- Can create ambiguous paths
+- Reduces performance
+
+### 2. Avoid Many-to-Many When Possible
+Many-to-many relationships:
+- Generate more complex queries
+- Require more memory
+- Can produce unexpected results
+
+### 3. Reduce Relationship Cardinality
+Keep relationship columns low cardinality:
+- Use integer keys over text
+- Consider higher-grain relationships
+
+## DAX Optimization
+
+### 1. Use Variables
+```dax
+// GOOD - Calculate once, use twice
+Sales Growth = 
+VAR CurrentSales = [Total Sales]
+VAR PriorSales = [PY Sales]
+RETURN DIVIDE(CurrentSales - PriorSales, PriorSales)
+
+// BAD - Recalculates [Total Sales] and [PY Sales]
+Sales Growth = 
+DIVIDE([Total Sales] - [PY Sales], [PY Sales])
+```
+
+### 2. Avoid FILTER with Entire Tables
+```dax
+// BAD - Iterates entire table
+Sales High Value = 
+CALCULATE([Total Sales], FILTER(Sales, Sales[Amount] > 1000))
+
+// GOOD - Uses column reference
+Sales High Value = 
+CALCULATE([Total Sales], Sales[Amount] > 1000)
+```
+
+### 3. Use KEEPFILTERS Appropriately
+```dax
+// Respects existing filters
+Sales with Filter = 
+CALCULATE([Total Sales], KEEPFILTERS(Product[Category] = "Bikes"))
+```
+
+### 4. Prefer DIVIDE Over Division Operator
+```dax
+// GOOD - Handles divide by zero
+Margin % = DIVIDE([Profit], [Sales])
+
+// BAD - Errors on zero
+Margin % = [Profit] / [Sales]
+```
+
+## DirectQuery Optimization
+
+### 1. Minimize Columns and Tables
+DirectQuery models:
+- Query source for every visual
+- Performance depends on source
+- Minimize data retrieved
+
+### 2. Avoid Complex Power Query Transformations
+- Transforms become subqueries
+- Native queries are faster
+- Materialize at source when possible
+
+### 3. Keep Measures Simple Initially
+Complex DAX generates complex SQL:
+- Start with basic aggregations
+- Add complexity gradually
+- Monitor query performance
+
+### 4. Disable Auto Date/Time
+For DirectQuery models, disable auto date/time:
+- Creates hidden calculated tables
+- Increases model complexity
+- Use explicit date table instead
+
+## Aggregations
+
+### User-Defined Aggregations
+Pre-aggregate fact tables for:
+- Very large models (billions of rows)
+- Hybrid DirectQuery/Import
+- Common query patterns
+
+```
+table_operations(
+  operation: "Create",
+  definitions: [{
+    name: "SalesAgg",
+    mode: "Import",
+    mExpression: "..."
+  }]
+)
+```
+
+## Performance Testing
+
+### Use Performance Analyzer
+1. Enable in Power BI Desktop
+2. Start recording
+3. Interact with visuals
+4. Review DAX query times
+
+### Monitor with DAX Studio
+External tool for:
+- Query timing
+- Server timings
+- Query plans
+
+## Validation Checklist
+
+- [ ] Unnecessary columns removed
+- [ ] Appropriate data types used
+- [ ] High-cardinality columns addressed
+- [ ] Bidirectional relationships minimized
+- [ ] DAX uses variables for repeated expressions
+- [ ] No FILTER on entire tables
+- [ ] DIVIDE used instead of division operator
+- [ ] Auto date/time disabled for DirectQuery
+- [ ] Performance tested with representative data
diff --git a/skills/powerbi-modeling/references/RELATIONSHIPS.md b/skills/powerbi-modeling/references/RELATIONSHIPS.md
new file mode 100644
index 00000000..a902b537
--- /dev/null
+++ b/skills/powerbi-modeling/references/RELATIONSHIPS.md
@@ -0,0 +1,147 @@
+# Relationships in Power BI
+
+## Relationship Properties
+
+### Cardinality
+| Type | Use Case | Notes |
+|------|----------|-------|
+| One-to-Many (*:1) | Dimension to Fact | Most common, preferred |
+| Many-to-One (1:*) | Fact to Dimension | Same as above, direction reversed |
+| One-to-One (1:1) | Dimension extensions | Use sparingly |
+| Many-to-Many (*:*) | Bridge tables, complex scenarios | Requires careful design |
+
+### Cross-Filter Direction
+| Setting | Behavior | When to Use |
+|---------|----------|-------------|
+| Single | Filters flow from "one" to "many" | Default, best performance |
+| Both | Filters flow in both directions | Only when necessary |
+
+## Best Practices
+
+### 1. Prefer One-to-Many Relationships
+```
+Customer (1) --> (*) Sales
+Product  (1) --> (*) Sales
+Date     (1) --> (*) Sales
+```
+
+### 2. Use Single-Direction Cross-Filtering
+Bidirectional filtering:
+- Impacts performance negatively
+- Can create ambiguous filter paths
+- May produce unexpected results
+
+**Only use bidirectional when:**
+- Dimension-to-dimension analysis through fact table
+- Specific RLS requirements
+
+**Better alternative:** Use CROSSFILTER in DAX measures:
+```dax
+Countries Sold = 
+CALCULATE(
+    DISTINCTCOUNT(Customer[Country]),
+    CROSSFILTER(Customer[CustomerKey], Sales[CustomerKey], BOTH)
+)
+```
+
+### 3. One Active Path Between Tables
+- Only one active relationship between any two tables
+- Use USERELATIONSHIP for role-playing dimensions:
+
+```dax
+Sales by Ship Date = 
+CALCULATE(
+    [Total Sales],
+    USERELATIONSHIP(Sales[ShipDate], Date[Date])
+)
+```
+
+### 4. Avoid Ambiguous Paths
+Circular references cause errors. Solutions:
+- Deactivate one relationship
+- Restructure model
+- Use USERELATIONSHIP in measures
+
+## Relationship Patterns
+
+### Standard Star Schema
+```
+     [Date]
+       |
+[Product]--[Sales]--[Customer]
+       |
+   [Store]
+```
+
+### Role-Playing Dimension
+```
+[Date] --(active)-- [Sales.OrderDate]
+   |
+   +--(inactive)-- [Sales.ShipDate]
+```
+
+### Bridge Table (Many-to-Many)
+```
+[Customer]--(*)--[CustomerAccount]--(*)--[Account]
+```
+
+### Factless Fact Table
+```
+[Product]--[ProductPromotion]--[Promotion]
+```
+Used to capture relationships without measures.
+
+## Creating Relationships via MCP
+
+### List Current Relationships
+```
+relationship_operations(operation: "List")
+```
+
+### Create New Relationship
+```
+relationship_operations(
+  operation: "Create",
+  definitions: [{
+    fromTable: "Sales",
+    fromColumn: "ProductKey",
+    toTable: "Product", 
+    toColumn: "ProductKey",
+    crossFilteringBehavior: "OneDirection",
+    isActive: true
+  }]
+)
+```
+
+### Deactivate Relationship
+```
+relationship_operations(
+  operation: "Deactivate",
+  references: [{ name: "relationship-guid-here" }]
+)
+```
+
+## Troubleshooting
+
+### "Ambiguous Path" Error
+Multiple active paths exist between tables.
+- Check for: Multiple fact tables sharing dimensions
+- Solution: Deactivate redundant relationships
+
+### Bidirectional Not Allowed
+Circular reference would be created.
+- Solution: Restructure or use DAX CROSSFILTER
+
+### Relationship Not Detected
+Columns may have different data types.
+- Ensure both columns have identical types
+- Check for trailing spaces in text keys
+
+## Validation Checklist
+
+- [ ] All relationships are one-to-many where possible
+- [ ] Cross-filter is single direction by default
+- [ ] Only one active path between any two tables
+- [ ] Role-playing dimensions use inactive relationships
+- [ ] No circular reference paths
+- [ ] Key columns have matching data types
diff --git a/skills/powerbi-modeling/references/RLS.md b/skills/powerbi-modeling/references/RLS.md
new file mode 100644
index 00000000..b862e129
--- /dev/null
+++ b/skills/powerbi-modeling/references/RLS.md
@@ -0,0 +1,226 @@
+# Row-Level Security (RLS) in Power BI
+
+## Overview
+
+Row-Level Security restricts data access at the row level based on user identity. Users see only the data they're authorized to view.
+
+## Design Principles
+
+### 1. Filter on Dimension Tables
+Apply RLS to dimensions, not fact tables:
+- More efficient (smaller tables)
+- Filters propagate through relationships
+- Easier to maintain
+
+```dax
+// On Customer dimension - filters propagate to Sales
+[Region] = "West"
+```
+
+### 2. Create Minimal Roles
+Avoid many role combinations:
+- Each role = separate cache
+- Roles are additive (union, not intersection)
+- Consolidate where possible
+
+### 3. Use Dynamic RLS When Possible
+Data-driven rules scale better:
+- User mapping in a table
+- USERPRINCIPALNAME() for identity
+- No role changes when users change
+
+## Static vs Dynamic RLS
+
+### Static RLS
+Fixed rules per role:
+```dax
+// Role: West Region
+[Region] = "West"
+
+// Role: East Region  
+[Region] = "East"
+```
+
+**Pros:** Simple, clear
+**Cons:** Doesn't scale, requires role per group
+
+### Dynamic RLS
+User identity drives filtering:
+```dax
+// Single role filters based on logged-in user
+[ManagerEmail] = USERPRINCIPALNAME()
+```
+
+**Pros:** Scales, self-maintaining
+**Cons:** Requires user mapping data
+
+## Implementation Patterns
+
+### Pattern 1: Direct User Mapping
+User email in dimension table:
+```dax
+// On Customer table
+[CustomerEmail] = USERPRINCIPALNAME()
+```
+
+### Pattern 2: Security Table
+Separate table mapping users to data:
+```
+SecurityMapping table:
+| UserEmail | Region |
+|-----------|--------|
+| joe@co.com | West  |
+| sue@co.com | East  |
+```
+
+```dax
+// On Region dimension
+[Region] IN 
+    SELECTCOLUMNS(
+        FILTER(SecurityMapping, [UserEmail] = USERPRINCIPALNAME()),
+        "Region", [Region]
+    )
+```
+
+### Pattern 3: Manager Hierarchy
+Users see their data plus subordinates:
+```dax
+// Using PATH functions for hierarchy
+PATHCONTAINS(Employee[ManagerPath], 
+    LOOKUPVALUE(Employee[EmployeeID], Employee[Email], USERPRINCIPALNAME()))
+```
+
+### Pattern 4: Multiple Rules
+Combine conditions:
+```dax
+// Users see their region OR if they're a global viewer
+[Region] = LOOKUPVALUE(Users[Region], Users[Email], USERPRINCIPALNAME())
+|| LOOKUPVALUE(Users[IsGlobal], Users[Email], USERPRINCIPALNAME()) = TRUE()
+```
+
+## Creating Roles via MCP
+
+### List Existing Roles
+```
+security_role_operations(operation: "List")
+```
+
+### Create Role with Permission
+```
+security_role_operations(
+  operation: "Create",
+  definitions: [{
+    name: "Regional Sales",
+    modelPermission: "Read",
+    description: "Restricts sales data by region"
+  }]
+)
+```
+
+### Add Table Permission (Filter)
+```
+security_role_operations(
+  operation: "CreatePermissions",
+  permissionDefinitions: [{
+    roleName: "Regional Sales",
+    tableName: "Customer",
+    filterExpression: "[Region] = USERPRINCIPALNAME()"
+  }]
+)
+```
+
+### Get Effective Permissions
+```
+security_role_operations(
+  operation: "GetEffectivePermissions",
+  references: [{ name: "Regional Sales" }]
+)
+```
+
+## Testing RLS
+
+### In Power BI Desktop
+1. Modeling tab > View As
+2. Select role(s) to test
+3. Optionally specify user identity
+4. Verify data filtering
+
+### Test Unexpected Values
+For dynamic RLS, test:
+- Valid users
+- Unknown users (should see nothing or error gracefully)
+- NULL/blank values
+
+```dax
+// Defensive pattern - returns no data for unknown users
+IF(
+    USERPRINCIPALNAME() IN VALUES(SecurityMapping[UserEmail]),
+    [Region] IN SELECTCOLUMNS(...),
+    FALSE()
+)
+```
+
+## Common Mistakes
+
+### 1. RLS on Fact Tables Only
+**Problem:** Large table scans, poor performance
+**Solution:** Apply to dimension tables, let relationships propagate
+
+### 2. Using LOOKUPVALUE Instead of Relationships
+**Problem:** Expensive, doesn't scale
+**Solution:** Create proper relationships, let filters flow
+
+### 3. Expecting Intersection Behavior
+**Problem:** Multiple roles = UNION (additive), not intersection
+**Solution:** Design roles with union behavior in mind
+
+### 4. Forgetting About DirectQuery
+**Problem:** RLS filters become WHERE clauses
+**Solution:** Ensure source database can handle the query patterns
+
+### 5. Not Testing Edge Cases
+**Problem:** Users see unexpected data
+**Solution:** Test with: valid users, invalid users, multiple roles
+
+## Bidirectional RLS
+
+For bidirectional relationships with RLS:
+```
+Enable "Apply security filter in both directions"
+```
+
+Only use when:
+- RLS requires filtering through many-to-many
+- Dimension-to-dimension security needed
+
+**Caution:** Only one bidirectional relationship per path allowed.
+
+## Performance Considerations
+
+- RLS adds WHERE clauses to every query
+- Complex DAX in filters hurts performance
+- Test with realistic user counts
+- Consider aggregations for large models
+
+## Object-Level Security (OLS)
+
+Restrict access to entire tables or columns:
+```
+// Via XMLA/TMSL - not available in Desktop UI
+```
+
+Use for:
+- Hiding sensitive columns (salary, SSN)
+- Restricting entire tables
+- Combined with RLS for comprehensive security
+
+## Validation Checklist
+
+- [ ] RLS applied to dimension tables (not fact tables)
+- [ ] Filters propagate correctly through relationships
+- [ ] Dynamic RLS uses USERPRINCIPALNAME()
+- [ ] Tested with valid and invalid users
+- [ ] Edge cases handled (NULL, unknown users)
+- [ ] Performance tested under load
+- [ ] Role mappings documented
+- [ ] Workspace roles understood (Admins bypass RLS)
diff --git a/skills/powerbi-modeling/references/STAR-SCHEMA.md b/skills/powerbi-modeling/references/STAR-SCHEMA.md
new file mode 100644
index 00000000..e5a744a9
--- /dev/null
+++ b/skills/powerbi-modeling/references/STAR-SCHEMA.md
@@ -0,0 +1,103 @@
+# Star Schema Design for Power BI
+
+## Overview
+
+Star schema is the optimal design pattern for Power BI semantic models. It organizes data into:
+- **Dimension tables**: Enable filtering and grouping (the "one" side)
+- **Fact tables**: Enable summarization (the "many" side)
+
+## Table Classification
+
+### Dimension Tables
+- Contain descriptive attributes for filtering/slicing
+- Have unique key columns (one row per entity)
+- Examples: Customer, Product, Date, Geography, Employee
+- Naming convention: Singular noun (`Customer`, `Product`)
+
+### Fact Tables  
+- Contain measurable, quantitative data
+- Have foreign keys to dimensions
+- Store data at consistent grain (one row per transaction/event)
+- Examples: Sales, Orders, Inventory, WebVisits
+- Naming convention: Business process noun (`Sales`, `Orders`)
+
+## Design Principles
+
+### 1. Separate Dimensions from Facts
+```
+BAD:  Single denormalized "Sales" table with customer details
+GOOD: "Sales" fact table + "Customer" dimension table
+```
+
+### 2. Consistent Grain
+Every row in a fact table represents the same thing:
+- Order line level (most common)
+- Daily aggregation
+- Monthly summary
+
+Never mix grains in one table.
+
+### 3. Surrogate Keys
+Add surrogate keys when source lacks unique identifiers:
+```m
+// Power Query: Add index column
+= Table.AddIndexColumn(Source, "CustomerKey", 1, 1)
+```
+
+### 4. Date Dimension
+Always create a dedicated date table:
+- Mark as date table in Power BI
+- Include fiscal periods if needed
+- Add relative date columns (IsCurrentMonth, IsPreviousYear)
+
+```dax
+Date = 
+ADDCOLUMNS(
+    CALENDAR(DATE(2020,1,1), DATE(2030,12,31)),
+    "Year", YEAR([Date]),
+    "Month", FORMAT([Date], "MMMM"),
+    "MonthNum", MONTH([Date]),
+    "Quarter", "Q" & FORMAT([Date], "Q"),
+    "WeekDay", FORMAT([Date], "dddd")
+)
+```
+
+## Special Dimension Types
+
+### Role-Playing Dimensions
+Same dimension used multiple times (e.g., Date for OrderDate, ShipDate):
+- Option 1: Duplicate the table (OrderDate, ShipDate tables)
+- Option 2: Use inactive relationships with USERELATIONSHIP in DAX
+
+### Slowly Changing Dimensions (Type 2)
+Track historical changes with version columns:
+- StartDate, EndDate columns
+- IsCurrent flag
+- Requires pre-processing in data warehouse
+
+### Junk Dimensions
+Combine low-cardinality flags into one table:
+```
+OrderFlags dimension: IsRush, IsGift, IsOnline
+```
+
+### Degenerate Dimensions
+Keep transaction identifiers (OrderNumber, InvoiceID) in fact table.
+
+## Anti-Patterns to Avoid
+
+| Anti-Pattern | Problem | Solution |
+|--------------|---------|----------|
+| Wide denormalized tables | Poor performance, hard to maintain | Split into star schema |
+| Snowflake (normalized dims) | Extra joins hurt performance | Flatten dimensions |
+| Many-to-many without bridge | Ambiguous results | Add bridge/junction table |
+| Mixed grain facts | Incorrect aggregations | Separate tables per grain |
+
+## Validation Checklist
+
+- [ ] Each table is clearly dimension or fact
+- [ ] Fact tables have foreign keys to all related dimensions
+- [ ] Dimensions have unique key columns
+- [ ] Date table exists and is marked
+- [ ] No circular relationship paths
+- [ ] Consistent naming conventions

From 3cc24129938fe3559c2b899166721ea68e469b5d Mon Sep 17 00:00:00 2001
From: Mohammad <mmohammadq8@outlook.com>
Date: Tue, 3 Feb 2026 12:49:55 +0300
Subject: [PATCH 38/49] Fix formatting of description in powerbi-modeling skill

---
 skills/powerbi-modeling/SKILL.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/skills/powerbi-modeling/SKILL.md b/skills/powerbi-modeling/SKILL.md
index 8b2abcd0..b4c4f140 100644
--- a/skills/powerbi-modeling/SKILL.md
+++ b/skills/powerbi-modeling/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: powerbi-modeling
-description: Power BI semantic modeling assistant for building optimized data models. Use when working with Power BI semantic models, creating measures, designing star schemas, configuring relationships, implementing RLS, or optimizing model performance. Triggers on queries about DAX calculations, table relationships, dimension/fact table design, naming conventions, model documentation, cardinality, cross-filter direction, calculation groups, and data model best practices. Always connects to the active model first using power-bi-modeling MCP tools to understand the data structure before providing guidance.
+description: 'Power BI semantic modeling assistant for building optimized data models. Use when working with Power BI semantic models, creating measures, designing star schemas, configuring relationships, implementing RLS, or optimizing model performance. Triggers on queries about DAX calculations, table relationships, dimension/fact table design, naming conventions, model documentation, cardinality, cross-filter direction, calculation groups, and data model best practices. Always connects to the active model first using power-bi-modeling MCP tools to understand the data structure before providing guidance.'
 ---
 
 # Power BI Semantic Modeling

From a08d09b311aaac9a56023b341b2b2d47c047a801 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Amaury=20Lev=C3=A9?= <amauryleve@microsoft.com>
Date: Tue, 3 Feb 2026 14:12:06 +0100
Subject: [PATCH 39/49] Improve best practices for MSTest

---
 prompts/csharp-mstest.prompt.md | 490 +++++++++++++++++++++++++++++---
 1 file changed, 449 insertions(+), 41 deletions(-)

diff --git a/prompts/csharp-mstest.prompt.md b/prompts/csharp-mstest.prompt.md
index ae4fc938..77d903a6 100644
--- a/prompts/csharp-mstest.prompt.md
+++ b/prompts/csharp-mstest.prompt.md
@@ -1,67 +1,475 @@
 ---
 agent: 'agent'
 tools: ['changes', 'search/codebase', 'edit/editFiles', 'problems', 'search']
-description: 'Get best practices for MSTest unit testing, including data-driven tests'
+description: 'Get best practices for MSTest 3.x/4.x unit testing, including modern assertion APIs and data-driven tests'
 ---
 
-# MSTest Best Practices
+# MSTest Best Practices (MSTest 3.x/4.x)
 
-Your goal is to help me write effective unit tests with MSTest, covering both standard and data-driven testing approaches.
+Your goal is to help me write effective unit tests with modern MSTest, using current APIs and best practices.
 
 ## Project Setup
 
 - Use a separate test project with naming convention `[ProjectName].Tests`
-- Reference MSTest package
-- Create test classes that match the classes being tested (e.g., `CalculatorTests` for `Calculator`)
-- Use .NET SDK test commands: `dotnet test` for running tests
+- Reference MSTest 3.x+ NuGet packages (includes analyzers)
+- Consider using MSTest.Sdk for simplified project setup
+- Run tests with `dotnet test`
 
-## Test Structure
+## Test Class Structure
 
 - Use `[TestClass]` attribute for test classes
-- Use `[TestMethod]` attribute for test methods
-- Follow the Arrange-Act-Assert (AAA) pattern
-- Name tests using the pattern `MethodName_Scenario_ExpectedBehavior`
-- Use `[TestInitialize]` and `[TestCleanup]` for per-test setup and teardown
-- Use `[ClassInitialize]` and `[ClassCleanup]` for per-class setup and teardown
-- Use `[AssemblyInitialize]` and `[AssemblyCleanup]` for assembly-level setup and teardown
+- **Seal test classes by default** for performance and design clarity
+- Use `[TestMethod]` for test methods (prefer over `[DataTestMethod]`)
+- Follow Arrange-Act-Assert (AAA) pattern
+- Name tests using pattern `MethodName_Scenario_ExpectedBehavior`
 
-## Standard Tests
+```csharp
+[TestClass]
+public sealed class CalculatorTests
+{
+    [TestMethod]
+    public void Add_TwoPositiveNumbers_ReturnsSum()
+    {
+        // Arrange
+        var calculator = new Calculator();
 
-- Keep tests focused on a single behavior
-- Avoid testing multiple behaviors in one test method
-- Use clear assertions that express intent
-- Include only the assertions needed to verify the test case
-- Make tests independent and idempotent (can run in any order)
-- Avoid test interdependencies
+        // Act
+        var result = calculator.Add(2, 3);
+
+        // Assert
+        Assert.AreEqual(5, result);
+    }
+}
+```
+
+## Test Lifecycle
+
+- **Prefer constructors over `[TestInitialize]`** - enables `readonly` fields and follows standard C# patterns
+- Use `[TestCleanup]` for cleanup that must run even if test fails
+- Combine constructor with async `[TestInitialize]` when async setup is needed
+
+```csharp
+[TestClass]
+public sealed class ServiceTests
+{
+    private readonly MyService _service;  // readonly enabled by constructor
+
+    public ServiceTests()
+    {
+        _service = new MyService();
+    }
+
+    [TestInitialize]
+    public async Task InitAsync()
+    {
+        // Use for async initialization only
+        await _service.WarmupAsync();
+    }
+
+    [TestCleanup]
+    public void Cleanup() => _service.Reset();
+}
+```
+
+### Execution Order
+
+1. **Assembly Initialization** - `[AssemblyInitialize]` (once per test assembly)
+2. **Class Initialization** - `[ClassInitialize]` (once per test class)
+3. **Test Initialization** (for every test method):
+   1. Constructor
+   2. Set `TestContext` property
+   3. `[TestInitialize]`
+4. **Test Execution** - test method runs
+5. **Test Cleanup** (for every test method):
+   1. `[TestCleanup]`
+   2. `DisposeAsync` (if implemented)
+   3. `Dispose` (if implemented)
+6. **Class Cleanup** - `[ClassCleanup]` (once per test class)
+7. **Assembly Cleanup** - `[AssemblyCleanup]` (once per test assembly)
+
+## Modern Assertion APIs
+
+MSTest provides three assertion classes: `Assert`, `StringAssert`, and `CollectionAssert`.
+
+### Assert Class - Core Assertions
+
+```csharp
+// Equality
+Assert.AreEqual(expected, actual);
+Assert.AreNotEqual(notExpected, actual);
+Assert.AreSame(expectedObject, actualObject);      // Reference equality
+Assert.AreNotSame(notExpectedObject, actualObject);
+
+// Null checks
+Assert.IsNull(value);
+Assert.IsNotNull(value);
+
+// Boolean
+Assert.IsTrue(condition);
+Assert.IsFalse(condition);
+
+// Fail/Inconclusive
+Assert.Fail("Test failed due to...");
+Assert.Inconclusive("Test cannot be completed because...");
+```
+
+### Exception Testing (Prefer over `[ExpectedException]`)
+
+```csharp
+// Assert.Throws - matches TException or derived types
+var ex = Assert.Throws<ArgumentException>(() => Method(null));
+Assert.AreEqual("Value cannot be null.", ex.Message);
+
+// Assert.ThrowsExactly - matches exact type only
+var ex = Assert.ThrowsExactly<InvalidOperationException>(() => Method());
+
+// Async versions
+var ex = await Assert.ThrowsAsync<HttpRequestException>(async () => await client.GetAsync(url));
+var ex = await Assert.ThrowsExactlyAsync<InvalidOperationException>(async () => await Method());
+```
+
+### Collection Assertions (Assert class)
+
+```csharp
+Assert.Contains(expectedItem, collection);
+Assert.DoesNotContain(unexpectedItem, collection);
+Assert.ContainsSingle(collection);  // exactly one element
+Assert.HasCount(5, collection);
+Assert.IsEmpty(collection);
+Assert.IsNotEmpty(collection);
+```
+
+### String Assertions (Assert class)
+
+```csharp
+Assert.Contains("expected", actualString);
+Assert.StartsWith("prefix", actualString);
+Assert.EndsWith("suffix", actualString);
+Assert.DoesNotStartWith("prefix", actualString);
+Assert.DoesNotEndWith("suffix", actualString);
+Assert.MatchesRegex(@"\d{3}-\d{4}", phoneNumber);
+Assert.DoesNotMatchRegex(@"\d+", textOnly);
+```
+
+### Comparison Assertions
+
+```csharp
+Assert.IsGreaterThan(lowerBound, actual);
+Assert.IsGreaterThanOrEqualTo(lowerBound, actual);
+Assert.IsLessThan(upperBound, actual);
+Assert.IsLessThanOrEqualTo(upperBound, actual);
+Assert.IsInRange(actual, low, high);
+Assert.IsPositive(number);
+Assert.IsNegative(number);
+```
+
+### Type Assertions
+
+```csharp
+// Returns typed result for further assertions
+Assert.IsInstanceOfType<MyClass>(obj, out var typed);
+typed.DoSomething();
+
+Assert.IsNotInstanceOfType<WrongType>(obj);
+```
+
+### Assert.That (MSTest 4.0+)
+
+```csharp
+Assert.That(result.Count > 0);  // Auto-captures expression in failure message
+```
+
+### StringAssert Class
+
+> **Note:** Prefer `Assert` class equivalents when available (e.g., `Assert.Contains("expected", actual)` over `StringAssert.Contains(actual, "expected")`).
+
+```csharp
+StringAssert.Contains(actualString, "expected");
+StringAssert.StartsWith(actualString, "prefix");
+StringAssert.EndsWith(actualString, "suffix");
+StringAssert.Matches(actualString, new Regex(@"\d{3}-\d{4}"));
+StringAssert.DoesNotMatch(actualString, new Regex(@"\d+"));
+```
+
+### CollectionAssert Class
+
+> **Note:** Prefer `Assert` class equivalents when available (e.g., `Assert.Contains`).
+
+```csharp
+// Containment
+CollectionAssert.Contains(collection, expectedItem);
+CollectionAssert.DoesNotContain(collection, unexpectedItem);
+
+// Equality (same elements, same order)
+CollectionAssert.AreEqual(expectedCollection, actualCollection);
+CollectionAssert.AreNotEqual(unexpectedCollection, actualCollection);
+
+// Equivalence (same elements, any order)
+CollectionAssert.AreEquivalent(expectedCollection, actualCollection);
+CollectionAssert.AreNotEquivalent(unexpectedCollection, actualCollection);
+
+// Subset checks
+CollectionAssert.IsSubsetOf(subset, superset);
+CollectionAssert.IsNotSubsetOf(notSubset, collection);
+
+// Element validation
+CollectionAssert.AllItemsAreInstancesOfType(collection, typeof(MyClass));
+CollectionAssert.AllItemsAreNotNull(collection);
+CollectionAssert.AllItemsAreUnique(collection);
+```
 
 ## Data-Driven Tests
 
-- Use `[TestMethod]` combined with data source attributes
-- Use `[DataRow]` for inline test data
-- Use `[DynamicData]` for programmatically generated test data
-- Use `[TestProperty]` to add metadata to tests
-- Use meaningful parameter names in data-driven tests
+### DataRow
 
-## Assertions
+```csharp
+[TestMethod]
+[DataRow(1, 2, 3)]
+[DataRow(0, 0, 0, DisplayName = "Zeros")]
+[DataRow(-1, 1, 0, IgnoreMessage = "Known issue #123")]  // MSTest 3.8+
+public void Add_ReturnsSum(int a, int b, int expected)
+{
+    Assert.AreEqual(expected, Calculator.Add(a, b));
+}
+```
 
-- Use `Assert.AreEqual` for value equality
-- Use `Assert.AreSame` for reference equality
-- Use `Assert.IsTrue`/`Assert.IsFalse` for boolean conditions
-- Use `CollectionAssert` for collection comparisons
-- Use `StringAssert` for string-specific assertions
-- Use `Assert.Throws<T>` to test exceptions
-- Ensure assertions are simple in nature and have a message provided for clarity on failure
+### DynamicData
 
-## Mocking and Isolation
+The data source can return any of the following types:
 
-- Consider using Moq or NSubstitute alongside MSTest
-- Mock dependencies to isolate units under test
-- Use interfaces to facilitate mocking
-- Consider using a DI container for complex test setups
+- `IEnumerable<(T1, T2, ...)>` (ValueTuple) - **preferred**, provides type safety (MSTest 3.7+)
+- `IEnumerable<Tuple<T1, T2, ...>>` - provides type safety
+- `IEnumerable<TestDataRow>` - provides type safety plus control over test metadata (display name, categories)
+- `IEnumerable<object[]>` - **least preferred**, no type safety
+
+> **Note:** When creating new test data methods, prefer `ValueTuple` or `TestDataRow` over `IEnumerable<object[]>`. The `object[]` approach provides no compile-time type checking and can lead to runtime errors from type mismatches.
+
+```csharp
+[TestMethod]
+[DynamicData(nameof(TestData))]
+public void DynamicTest(int a, int b, int expected)
+{
+    Assert.AreEqual(expected, Calculator.Add(a, b));
+}
+
+// ValueTuple - preferred (MSTest 3.7+)
+public static IEnumerable<(int a, int b, int expected)> TestData =>
+[
+    (1, 2, 3),
+    (0, 0, 0),
+];
+
+// TestDataRow - when you need custom display names or metadata
+public static IEnumerable<TestDataRow<(int a, int b, int expected)>> TestDataWithMetadata =>
+[
+    new((1, 2, 3)) { DisplayName = "Positive numbers" },
+    new((0, 0, 0)) { DisplayName = "Zeros" },
+    new((-1, 1, 0)) { DisplayName = "Mixed signs", IgnoreMessage = "Known issue #123" },
+];
+
+// IEnumerable<object[]> - avoid for new code (no type safety)
+public static IEnumerable<object[]> LegacyTestData =>
+[
+    [1, 2, 3],
+    [0, 0, 0],
+];
+```
+
+## TestContext
+
+The `TestContext` class provides test run information, cancellation support, and output methods.
+See [TestContext documentation](https://learn.microsoft.com/dotnet/core/testing/unit-testing-mstest-writing-tests-testcontext) for complete reference.
+
+### Accessing TestContext
+
+```csharp
+// Property (MSTest suppresses CS8618 - don't use nullable or = null!)
+public TestContext TestContext { get; set; }
+
+// Constructor injection (MSTest 3.6+) - preferred for immutability
+[TestClass]
+public sealed class MyTests
+{
+    private readonly TestContext _testContext;
+
+    public MyTests(TestContext testContext)
+    {
+        _testContext = testContext;
+    }
+}
+
+// Static methods receive it as parameter
+[ClassInitialize]
+public static void ClassInit(TestContext context) { }
+
+// Optional for cleanup methods (MSTest 3.6+)
+[ClassCleanup]
+public static void ClassCleanup(TestContext context) { }
+
+[AssemblyCleanup]
+public static void AssemblyCleanup(TestContext context) { }
+```
+
+### Cancellation Token
+
+Always use `TestContext.CancellationToken` for cooperative cancellation with `[Timeout]`:
+
+```csharp
+[TestMethod]
+[Timeout(5000)]
+public async Task LongRunningTest()
+{
+    await _httpClient.GetAsync(url, TestContext.CancellationToken);
+}
+```
+
+### Test Run Properties
+
+```csharp
+TestContext.TestName              // Current test method name
+TestContext.TestDisplayName       // Display name (3.7+)
+TestContext.CurrentTestOutcome    // Pass/Fail/InProgress
+TestContext.TestData              // Parameterized test data (3.7+, in TestInitialize/Cleanup)
+TestContext.TestException         // Exception if test failed (3.7+, in TestCleanup)
+TestContext.DeploymentDirectory   // Directory with deployment items
+```
+
+### Output and Result Files
+
+```csharp
+// Write to test output (useful for debugging)
+TestContext.WriteLine("Processing item {0}", itemId);
+
+// Attach files to test results (logs, screenshots)
+TestContext.AddResultFile(screenshotPath);
+
+// Store/retrieve data across test methods
+TestContext.Properties["SharedKey"] = computedValue;
+```
+
+## Advanced Features
+
+### Retry for Flaky Tests (MSTest 3.9+)
+
+```csharp
+[TestMethod]
+[Retry(3)]
+public void FlakyTest() { }
+```
+
+### Conditional Execution (MSTest 3.10+)
+
+Skip or run tests based on OS or CI environment:
+
+```csharp
+// OS-specific tests
+[TestMethod]
+[OSCondition(OperatingSystems.Windows)]
+public void WindowsOnlyTest() { }
+
+[TestMethod]
+[OSCondition(OperatingSystems.Linux | OperatingSystems.MacOS)]
+public void UnixOnlyTest() { }
+
+[TestMethod]
+[OSCondition(ConditionMode.Exclude, OperatingSystems.Windows)]
+public void SkipOnWindowsTest() { }
+
+// CI environment tests
+[TestMethod]
+[CICondition]  // Runs only in CI (default: ConditionMode.Include)
+public void CIOnlyTest() { }
+
+[TestMethod]
+[CICondition(ConditionMode.Exclude)]  // Skips in CI, runs locally
+public void LocalOnlyTest() { }
+```
+
+### Parallelization
+
+```csharp
+// Assembly level
+[assembly: Parallelize(Workers = 4, Scope = ExecutionScope.MethodLevel)]
+
+// Disable for specific class
+[TestClass]
+[DoNotParallelize]
+public sealed class SequentialTests { }
+```
+
+### Work Item Traceability (MSTest 3.8+)
+
+Link tests to work items for traceability in test reports:
+
+```csharp
+// Azure DevOps work items
+[TestMethod]
+[WorkItem(12345)]  // Links to work item #12345
+public void Feature_Scenario_ExpectedBehavior() { }
+
+// Multiple work items
+[TestMethod]
+[WorkItem(12345)]
+[WorkItem(67890)]
+public void Feature_CoversMultipleRequirements() { }
+
+// GitHub issues (MSTest 3.8+)
+[TestMethod]
+[GitHubWorkItem("https://github.com/owner/repo/issues/42")]
+public void BugFix_Issue42_IsResolved() { }
+```
+
+Work item associations appear in test results and can be used for:
+- Tracing test coverage to requirements
+- Linking bug fixes to regression tests
+- Generating traceability reports in CI/CD pipelines
+
+## Common Mistakes to Avoid
+
+```csharp
+// ❌ Wrong argument order
+Assert.AreEqual(actual, expected);
+// ✅ Correct
+Assert.AreEqual(expected, actual);
+
+// ❌ Using ExpectedException (obsolete)
+[ExpectedException(typeof(ArgumentException))]
+// ✅ Use Assert.Throws
+Assert.Throws<ArgumentException>(() => Method());
+
+// ❌ Using LINQ Single() - unclear exception
+var item = items.Single();
+// ✅ Use ContainsSingle - better failure message
+var item = Assert.ContainsSingle(items);
+
+// ❌ Hard cast - unclear exception
+var handler = (MyHandler)result;
+// ✅ Type assertion - shows actual type on failure
+var handler = Assert.IsInstanceOfType<MyHandler>(result);
+
+// ❌ Ignoring cancellation token
+await client.GetAsync(url, CancellationToken.None);
+// ✅ Flow test cancellation
+await client.GetAsync(url, TestContext.CancellationToken);
+
+// ❌ Making TestContext nullable - leads to unnecessary null checks
+public TestContext? TestContext { get; set; }
+// ❌ Using null! - MSTest already suppresses CS8618 for this property
+public TestContext TestContext { get; set; } = null!;
+// ✅ Declare without nullable or initializer - MSTest handles the warning
+public TestContext TestContext { get; set; }
+```
 
 ## Test Organization
 
 - Group tests by feature or component
-- Use test categories with `[TestCategory("Category")]`
-- Use test priorities with `[Priority(1)]` for critical tests
-- Use `[Owner("DeveloperName")]` to indicate ownership
+- Use `[TestCategory("Category")]` for filtering
+- Use `[TestProperty("Name", "Value")]` for custom metadata (e.g., `[TestProperty("Bug", "12345")]`)
+- Use `[Priority(1)]` for critical tests
+- Enable relevant MSTest analyzers (MSTEST0020 for constructor preference)
+
+## Mocking and Isolation
+
+- Use Moq or NSubstitute for mocking dependencies
+- Use interfaces to facilitate mocking
+- Mock dependencies to isolate units under test

From 5056db77ebd835c71b2336606698aa175323bd62 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Amaury=20Lev=C3=A9?= <amauryleve@microsoft.com>
Date: Tue, 3 Feb 2026 14:26:17 +0100
Subject: [PATCH 40/49] Fix readme

---
 docs/README.prompts.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/README.prompts.md b/docs/README.prompts.md
index 6a828118..816a758b 100644
--- a/docs/README.prompts.md
+++ b/docs/README.prompts.md
@@ -98,7 +98,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi
 | [Microsoft 365 Declarative Agents Development Kit](../prompts/declarative-agents.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdeclarative-agents.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdeclarative-agents.prompt.md) | Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration |
 | [Migration and Code Evolution Instructions Generator](../prompts/generate-custom-instructions-from-codebase.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fgenerate-custom-instructions-from-codebase.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fgenerate-custom-instructions-from-codebase.prompt.md) | Migration and code evolution instructions generator for GitHub Copilot. Analyzes differences between two project versions (branches, commits, or releases) to create precise instructions allowing Copilot to maintain consistency during technology migrations, major refactoring, or framework version upgrades. |
 | [MkDocs AI Translator](../prompts/mkdocs-translations.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmkdocs-translations.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmkdocs-translations.prompt.md) | Generate a language translation for a mkdocs documentation stack. |
-| [MSTest Best Practices](../prompts/csharp-mstest.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mstest.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mstest.prompt.md) | Get best practices for MSTest unit testing, including data-driven tests |
+| [MSTest Best Practices (MSTest 3.x/4.x)](../prompts/csharp-mstest.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mstest.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mstest.prompt.md) | Get best practices for MSTest 3.x/4.x unit testing, including modern assertion APIs and data-driven tests |
 | [Multi Stage Dockerfile](../prompts/multi-stage-dockerfile.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmulti-stage-dockerfile.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmulti-stage-dockerfile.prompt.md) | Create optimized multi-stage Dockerfiles for any language or framework |
 | [My Issues](../prompts/my-issues.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmy-issues.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmy-issues.prompt.md) | List my issues in the current repository |
 | [My Pull Requests](../prompts/my-pull-requests.prompt.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmy-pull-requests.prompt.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmy-pull-requests.prompt.md) | List my pull requests in the current repository |

From de652427f24f11acdfb10e2144396c9b02726bf1 Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Tue, 3 Feb 2026 22:52:59 +0800
Subject: [PATCH 41/49] feat(skill): add meeting minutes generation skill

This commit introduces a new skill for generating concise and actionable
meeting minutes for internal meetings. The skill includes metadata,
attendance, agenda, decisions, action items, and follow-up steps,
ensuring a standardized format for documentation.

- Supports short meetings
- Follows a strict schema for output
- Includes operational workflow and clarifying questions for intake
---
 skills/meeting-minutes/SKILL.md | 241 ++++++++++++++++++++++++++++++++
 1 file changed, 241 insertions(+)
 create mode 100644 skills/meeting-minutes/SKILL.md

diff --git a/skills/meeting-minutes/SKILL.md b/skills/meeting-minutes/SKILL.md
new file mode 100644
index 00000000..8d961bef
--- /dev/null
+++ b/skills/meeting-minutes/SKILL.md
@@ -0,0 +1,241 @@
+---
+name: meeting-minutes
+description: "Generate concise, actionable meeting minutes for internal meetings. Includes metadata, attendees, agenda, decisions, action items (owner + due date), and follow-up steps."
+---
+
+# Meeting Minutes Skill — Short Internal Meetings
+
+## Purpose / Overview
+
+This Skill produces high-quality, consistent meeting minutes for internal meetings that are 60 minutes or shorter. Output is designed to be clear, actionable, and easy to convert into task trackers (e.g., GitHub Issues, Jira). The generated minutes prioritize decisions and action items so teams can move quickly from discussion to execution.
+
+## When to Use
+
+Use this skill when:
+
+- Internal syncs, standups, design reviews, triage, planning or ad-hoc meetings with short duration
+- Situations that require a concise record of decisions, assigned action items, and follow-ups
+- Creating a standardized minutes document from a live meeting, transcript, recording, or notes
+
+---
+
+## Operational Workflow
+
+### Phase 1: Intake (before drafting)
+
+- Obtain meeting metadata: title, date, start/end time (or duration), organizer, and intended audience.
+- Confirm available inputs: agenda, slides, recording, transcript, or raw notes.
+- If key details are missing, ask up to 3 clarifying questions before producing minutes (see "Discovery" below).
+
+### Phase 2: Capture (during / immediately after meeting)
+
+- Record attendees and absentees.
+- Capture brief notes per agenda item with time markers if available.
+- Record explicit decisions, rationale summary (1–2 sentences), and action items (owner + due date).
+
+### Phase 3: Drafting
+
+- Generate minutes following the **Strict Minutes Schema** (below).
+- Ensure every action item includes owner, due date (or timeframe), and acceptance criteria when applicable.
+- Mark unresolved issues or items requiring follow-up in the Parking Lot.
+
+### Phase 4: Review & Publish
+
+- If possible, send draft to meeting organizer or a designated reviewer for quick verification (within 24 hours).
+- Publish final minutes to the agreed channel (shared drive, repo, ticket, or email) and optionally create tasks in the team's tracker.
+
+---
+
+## Discovery (required clarifying questions)
+
+Before generating minutes, the agent **MUST** ask up to three clarifying questions if any of these are missing:
+
+- What is the meeting title, date, start time (or duration), and organizer?
+- Is there an agenda or transcript/recording to reference? If yes, please provide.
+- Who should be assigned as the reviewer or approver for the minutes?
+
+If the user responds "no transcript" or "no agenda," proceed but mark source material as "ad-hoc notes" and flag potential gaps.
+
+---
+
+## Strict Minutes Schema (Output Structure)
+
+You **MUST** produce meeting minutes following this exact structure. If information is unavailable, use `TBD` or `Unknown` and explain how to obtain it.
+
+### 1. Metadata
+
+- **Title**:
+- **Date (YYYY-MM-DD)**:
+- **Start Time (UTC)**:
+- **End Time (UTC) or Duration**:
+- **Organizer**:
+- **Location / Virtual Link**:
+- **Minutes Author** (agent or person):
+- **Distribution List** (who receives the minutes):
+
+### 2. Attendance
+
+- **Present**: [list of names + roles]
+- **Regrets / Absent**: [list]
+- **Notetaker / Recorder**: [name or "agent"]
+
+### 3. Agenda
+
+Bullet list of agenda items, in order:
+
+- Item 1: short title
+- Item 2: short title
+- ...
+
+### 4. Summary
+
+A concise one-paragraph summary (1–3 sentences) of the meeting's objective and high-level outcome.
+
+### 5. Decisions Made
+
+Each as a separate bullet:
+
+- **Decision 1**: statement of decision.
+  - Who decided / approved: [name(s) or group]
+  - Rationale (1–2 sentences): brief reason.
+  - Effective date (if applicable): YYYY-MM-DD
+- **Decision 2**: ...
+
+### 6. Action Items
+
+Table-style bullets; **must include owner and due date**:
+
+- **[ID] Action**: short description
+  - **Owner**: Name (team)
+  - **Due**: YYYY-MM-DD or "ASAP" / timeframe
+  - **Acceptance Criteria**: (what completes this action)
+  - **Linked artifacts / tickets**: (optional URL or ticket id)
+
+**Example:**
+
+- [A1] Draft deployment runbook for feature X
+  - Owner: Alex (Engineering)
+  - Due: 2026-02-05
+  - Acceptance Criteria: runbook includes steps for rollback, health checks, and monitoring links
+  - Linked artifacts: https://github.com/owner/repo/issues/123
+
+### 7. Notes by Agenda Item
+
+Brief, factual, timestamp optional:
+
+- **Agenda Item 1**: title
+  - Key points:
+    - Point A (timestamp 00:05)
+    - Point B (timestamp 00:12)
+  - Open issues / questions:
+    - Q1: question text (owner if assigned)
+- **Agenda Item 2**: ...
+
+### 8. Parking Lot / Unresolved Items
+
+- **Item**: short description
+  - Why parked / next step:
+  - Suggested owner or next meeting to resolve
+
+### 9. Risks / Blockers (if any)
+
+- **Risk 1**: short description, impact, mitigation owner
+- **Risk 2**: ...
+
+### 10. Next Meeting / Follow-up
+
+- Proposed date/time (if any)
+- Objectives for next meeting
+
+### 11. Attachments / References
+
+- Agenda document: URL
+- Slides: URL
+- Transcript / Recording: URL
+- Related tickets: list of URLs or IDs
+
+### 12. Version & Change Log
+
+- **Version**: 1.0
+- **Last updated**: YYYY-MM-DDTHH:MM:SSZ
+- **Changes**: short notes on edits and who made them
+
+---
+
+## Style & Quality Rules
+
+- Keep minutes concise: total length should typically be under 1 A4 page for meetings <= 30 minutes and under 2 pages for meetings close to 60 minutes.
+- Use plain language and bullet lists for readability.
+- Prioritize decisions and action items at the top of the document.
+- Do NOT include speculative language or unverified claims. If something is uncertain, label it `TBD` and note the missing info source.
+- Use consistent timestamps and ISO 8601 dates (YYYY-MM-DD or full UTC timestamp).
+
+---
+
+## DO / DON'T
+
+**DO:**
+
+- Include owner and due date for every action item.
+- Provide acceptance criteria for action items when possible.
+- Link to artifacts (tickets, slides, recordings) for traceability.
+- Send draft for quick review if minutes contain significant decisions.
+
+**DON'T:**
+
+- Omit decisions or action items — these are the primary value of minutes.
+- Mix personal opinions with facts. Keep commentary clearly marked as "Opinion" or exclude it.
+- Publish raw PII gathered during discussion unless required and authorized.
+
+---
+
+## Example Prompts (for Copilot / Agent)
+
+**Prompt to generate minutes from transcript:**
+
+> "Generate meeting minutes from the following meeting transcript. Meeting title: 'Platform Weekly Sync'. Date: 2026-02-10. Duration: 45 minutes. Organizer: Priya (Platform Lead). Transcript: <paste transcript>. Follow the Strict Minutes Schema. Highlight decisions and create action items with owners and due dates where implied."
+
+**Prompt to generate minutes from notes:**
+
+> "I have raw notes from a 30-minute design review. Title: 'Feature Y Design Review'. Date: 2026-02-11. Notes: <paste notes>. Produce concise minutes following the Strict Minutes Schema. Ask up to 3 clarifying questions if critical fields are missing."
+
+---
+
+## Quick Templates (copyable)
+
+### Concise minutes template (short):
+
+```
+- Title:
+- Date:
+- Organizer:
+- Present:
+- Summary:
+- Decisions:
+  - Decision 1 — Who — Effective:
+- Action Items:
+  - [A1] Action — Owner — Due — Acceptance Criteria
+- Next Steps / Next Meeting:
+```
+
+### Detailed minutes template (full schema):
+
+Use the Strict Minutes Schema above.
+
+---
+
+## Verification & Acceptance Criteria for Generated Minutes
+
+A generated minutes document is acceptable if:
+
+- It contains Metadata, Attendance, Decisions, and Action Items sections.
+- Every action item has an assigned owner and a due date or a clear timeframe.
+- All significant decisions are captured with at least 1-line rationale.
+- Attachments or references are listed or explicitly marked `None`.
+- The document is factual; uncertain items are labeled `TBD`.
+
+---
+
+## Change History
+
+- 2026-02-03 — v1.0 — Initial version for short internal meetings.

From f8c11eeab787f1f1462698e20ab157edab7bfd03 Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Tue, 3 Feb 2026 22:59:29 +0800
Subject: [PATCH 42/49] feat(skill): add meeting minutes generation skill

Generate concise, actionable meeting minutes for internal meetings.
Includes metadata, attendees, agenda, decisions, action items (owner
+ due date), and follow-up steps.
---
 docs/README.skills.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/README.skills.md b/docs/README.skills.md
index bdb1c155..f2be3d47 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -39,6 +39,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [make-skill-template](../skills/make-skill-template/SKILL.md) | Create new Agent Skills for GitHub Copilot from prompts or by duplicating this template. Use when asked to "create a skill", "make a new skill", "scaffold a skill", or when building specialized AI capabilities with bundled resources. Generates SKILL.md files with proper frontmatter, directory structure, and optional scripts/references/assets folders. | None |
 | [markdown-to-html](../skills/markdown-to-html/SKILL.md) | Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors. | `references/basic-markdown-to-html.md`<br />`references/basic-markdown.md`<br />`references/code-blocks-to-html.md`<br />`references/code-blocks.md`<br />`references/collapsed-sections-to-html.md`<br />`references/collapsed-sections.md`<br />`references/gomarkdown.md`<br />`references/hugo.md`<br />`references/jekyll.md`<br />`references/marked.md`<br />`references/pandoc.md`<br />`references/tables-to-html.md`<br />`references/tables.md`<br />`references/writing-mathematical-expressions-to-html.md`<br />`references/writing-mathematical-expressions.md` |
 | [mcp-cli](../skills/mcp-cli/SKILL.md) | Interface for MCP (Model Context Protocol) servers via CLI. Use when you need to interact with external tools, APIs, or data sources through MCP servers, list available MCP servers/tools, or call MCP tools from command line. | None |
+| [meeting-minutes](../skills/meeting-minutes/SKILL.md) | Generate concise, actionable meeting minutes for internal meetings. Includes metadata, attendees, agenda, decisions, action items (owner + due date), and follow-up steps. | None |
 | [microsoft-code-reference](../skills/microsoft-code-reference/SKILL.md) | Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs. | None |
 | [microsoft-docs](../skills/microsoft-docs/SKILL.md) | Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices. | None |
 | [nuget-manager](../skills/nuget-manager/SKILL.md) | Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions. | None |

From 635d7be15c3df7b78e5f3ed6b6c1eb406895c5ac Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Tue, 3 Feb 2026 23:06:02 +0800
Subject: [PATCH 43/49] docs(skill): update description for meeting minutes
 skill

Refined the description of the meeting minutes skill to ensure clarity
and consistency in the documentation. The updated description maintains
the same informative content while improving readability.

- Changed double quotes to single quotes for consistency
---
 skills/meeting-minutes/SKILL.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/skills/meeting-minutes/SKILL.md b/skills/meeting-minutes/SKILL.md
index 8d961bef..8ff5d7da 100644
--- a/skills/meeting-minutes/SKILL.md
+++ b/skills/meeting-minutes/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: meeting-minutes
-description: "Generate concise, actionable meeting minutes for internal meetings. Includes metadata, attendees, agenda, decisions, action items (owner + due date), and follow-up steps."
+description: 'Generate concise, actionable meeting minutes for internal meetings. Includes metadata, attendees, agenda, decisions, action items (owner + due date), and follow-up steps.'
 ---
 
 # Meeting Minutes Skill — Short Internal Meetings

From 461c92745d3974a24e2ac097696544393bc5d296 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Amaury=20Lev=C3=A9?= <amauryleve@microsoft.com>
Date: Tue, 3 Feb 2026 16:33:50 +0100
Subject: [PATCH 44/49] Fix assertion

---
 prompts/csharp-mstest.prompt.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/prompts/csharp-mstest.prompt.md b/prompts/csharp-mstest.prompt.md
index 77d903a6..9a27bda8 100644
--- a/prompts/csharp-mstest.prompt.md
+++ b/prompts/csharp-mstest.prompt.md
@@ -166,10 +166,14 @@ Assert.IsNegative(number);
 ### Type Assertions
 
 ```csharp
-// Returns typed result for further assertions
+// MSTest 3.x - uses out parameter
 Assert.IsInstanceOfType<MyClass>(obj, out var typed);
 typed.DoSomething();
 
+// MSTest 4.x - returns typed result directly
+var typed = Assert.IsInstanceOfType<MyClass>(obj);
+typed.DoSomething();
+
 Assert.IsNotInstanceOfType<WrongType>(obj);
 ```
 

From e0ef76bcaf459dd4d584f7a752340e2572cd6be6 Mon Sep 17 00:00:00 2001
From: Steven Vore <steven@vorefamily.net>
Date: Tue, 3 Feb 2026 11:02:24 -0500
Subject: [PATCH 45/49] Update tools section in conventional commit prompt

---
 prompts/conventional-commit.prompt.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/prompts/conventional-commit.prompt.md b/prompts/conventional-commit.prompt.md
index c517d438..01cf2b5a 100644
--- a/prompts/conventional-commit.prompt.md
+++ b/prompts/conventional-commit.prompt.md
@@ -1,6 +1,6 @@
 ---
 description: 'Prompt and workflow for generating conventional commit messages using a structured XML format. Guides users to create standardized, descriptive commit messages in line with the Conventional Commits specification, including instructions, examples, and validation.'
-tools: ['runCommands/runInTerminal', 'runCommands/getTerminalOutput']
+tools: ['execute/runInTerminal', 'execute/getTerminalOutput']
 ---
 
 ### Instructions

From e7f08b382e6af8a223acbb6053a461010da9c0bf Mon Sep 17 00:00:00 2001
From: trycatchkamal <=>
Date: Tue, 3 Feb 2026 22:51:52 +0530
Subject: [PATCH 46/49] Updated python installation instructions

---
 cookbook/copilot-sdk/python/pr-visualization.md | 2 +-
 instructions/copilot-sdk-python.instructions.md | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/cookbook/copilot-sdk/python/pr-visualization.md b/cookbook/copilot-sdk/python/pr-visualization.md
index 3d8b7969..0419aed1 100644
--- a/cookbook/copilot-sdk/python/pr-visualization.md
+++ b/cookbook/copilot-sdk/python/pr-visualization.md
@@ -20,7 +20,7 @@ You want to understand how long PRs have been open in a repository. This tool de
 ## Prerequisites
 
 ```bash
-pip install copilot-sdk
+pip install github-copilot-sdk
 ```
 
 ## Usage
diff --git a/instructions/copilot-sdk-python.instructions.md b/instructions/copilot-sdk-python.instructions.md
index 8bc46757..ae8a23d5 100644
--- a/instructions/copilot-sdk-python.instructions.md
+++ b/instructions/copilot-sdk-python.instructions.md
@@ -18,11 +18,11 @@ name: "GitHub Copilot SDK Python Instructions"
 Always install via pip:
 
 ```bash
-pip install copilot-sdk
+pip install github-copilot-sdk
 # or with poetry
-poetry add copilot-sdk
+poetry add github-copilot-sdk
 # or with uv
-uv add copilot-sdk
+uv add github-copilot-sdk
 ```
 
 ## Client Initialization

From c827c258e3edc3ae2a3cd779d03b8ce85b415a93 Mon Sep 17 00:00:00 2001
From: Igor Shishkin <specialforest@users.noreply.github.com>
Date: Tue, 3 Feb 2026 10:21:10 -0800
Subject: [PATCH 47/49] Update references of older net versions with new

---
 instructions/dotnet-upgrade.instructions.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/instructions/dotnet-upgrade.instructions.md b/instructions/dotnet-upgrade.instructions.md
index 7c8b733b..f2a146d9 100644
--- a/instructions/dotnet-upgrade.instructions.md
+++ b/instructions/dotnet-upgrade.instructions.md
@@ -23,9 +23,9 @@ Follow the steps **sequentially** and **do not attempt to upgrade all projects a
    - Note the current target and SDK.
 
 2. **Select Target Version**
-   - **.NET (Core/Modern)**: Upgrade to the latest LTS (e.g., `net8.0`).
-   - **.NET Standard**: Prefer migrating to **.NET 6+** if possible. If staying, target `netstandard2.1`.
-   - **.NET Framework**: Upgrade to at least **4.8**, or migrate to .NET 6+ if feasible.
+   - **.NET (Core/Modern)**: Upgrade to the latest LTS (e.g., `net10.0`).
+   - **.NET Standard**: Prefer migrating to **.NET 8+** if possible. If staying, target `netstandard2.1`.
+   - **.NET Framework**: Upgrade to at least **4.8**, or migrate to .NET 8+ if feasible.
 
 3. **Review Release Notes & Breaking Changes**
    - [.NET Core/.NET Upgrade Docs](https://learn.microsoft.com/dotnet/core/whats-new/)
@@ -76,7 +76,7 @@ For each project:
    ```
 
 2. Check for:
-   - `TargetFramework` → Change to the desired version (e.g., `net8.0`).
+   - `TargetFramework` → Change to the desired version (e.g., `net10.0`).
    - `PackageReference` → Verify if each NuGet package supports the new framework.  
      - Run:
        ```bash
@@ -148,7 +148,7 @@ BlobServiceClient client = new BlobServiceClient(connectionString);
 - Common issues:
   - Deprecated APIs → Replace with supported alternatives.
   - Package incompatibility → Find updated NuGet or migrate to Microsoft-supported library.
-  - Configuration differences (e.g., `Startup.cs` → `Program.cs` in .NET 6+).
+  - Configuration differences (e.g., `Startup.cs` → `Program.cs` in .NET 8+).
 
 
 ---
@@ -239,9 +239,9 @@ Use this table as a sample to track the progress of the upgrade across all proje
 
 | Project Name | Target Framework | Dependencies Updated | Builds Successfully | Tests Passing | Deployment Verified | Notes |
 |--------------|------------------|-----------------------|---------------------|---------------|---------------------|-------|
-| Project A    | ☐ net8.0         | ☐                     | ☐                   | ☐             | ☐                   |       |
-| Project B    | ☐ net8.0         | ☐                     | ☐                   | ☐             | ☐                   |       |
-| Project C    | ☐ net8.0         | ☐                     | ☐                   | ☐             | ☐                   |       |
+| Project A    | ☐ net10.0         | ☐                     | ☐                   | ☐             | ☐                   |       |
+| Project B    | ☐ net10.0         | ☐                     | ☐                   | ☐             | ☐                   |       |
+| Project C    | ☐ net10.0         | ☐                     | ☐                   | ☐             | ☐                   |       |
 
 > ✅ Mark each column as you complete the step for every project.
 
@@ -272,7 +272,7 @@ For organizations with multiple repositories:
 ## 🔑 Notes & Best Practices
 
 - **Prefer Migration to Modern .NET**  
-  If on .NET Framework or .NET Standard, evaluate moving to .NET 6/8 for long-term support.
+  If on .NET Framework or .NET Standard, evaluate moving to .NET 8/10 for long-term support.
 - **Automate Tests Early**  
   CI/CD should block merges if tests fail.
 - **Incremental Upgrades**  

From 3729a7f59fa8e7f7a937b42a06a5f59d235a97df Mon Sep 17 00:00:00 2001
From: Igor Shishkin <specialforest@users.noreply.github.com>
Date: Tue, 3 Feb 2026 10:25:12 -0800
Subject: [PATCH 48/49] Update .NET Framework migration target to .NET 8

---
 agents/dotnet-upgrade.agent.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/agents/dotnet-upgrade.agent.md b/agents/dotnet-upgrade.agent.md
index 7e7bd5e6..083a2f13 100644
--- a/agents/dotnet-upgrade.agent.md
+++ b/agents/dotnet-upgrade.agent.md
@@ -122,7 +122,7 @@ dotnet msbuild <ProjectName>.csproj /t:GenerateRestoreGraphFile /p:RestoreGraphO
 ## Classification Rules
 - `TargetFramework` starts with `netcoreapp`, `net5.0+`, `net6.0+`, etc. → **Modern .NET**
 - `netstandard*` → **.NET Standard** (migrate to current .NET version)
-- `net4*` → **.NET Framework** (migrate via intermediate step to .NET 6+)
+- `net4*` → **.NET Framework** (migrate via intermediate step to .NET 8+)
 
 ---
 

From 68e58890cbc67c797d1356a6558adc5b12148fd4 Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Wed, 4 Feb 2026 06:40:46 +0800
Subject: [PATCH 49/49] docs(skill): remove change history section from
 SKILL.md

The change history section has been removed to streamline the document
and focus on the current skills and guidelines. This helps in maintaining
clarity and relevance in the documentation.

- Simplified the structure of SKILL.md
---
 skills/meeting-minutes/SKILL.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/skills/meeting-minutes/SKILL.md b/skills/meeting-minutes/SKILL.md
index 8ff5d7da..63424b8b 100644
--- a/skills/meeting-minutes/SKILL.md
+++ b/skills/meeting-minutes/SKILL.md
@@ -233,9 +233,3 @@ A generated minutes document is acceptable if:
 - All significant decisions are captured with at least 1-line rationale.
 - Attachments or references are listed or explicitly marked `None`.
 - The document is factual; uncertain items are labeled `TBD`.
-
----
-
-## Change History
-
-- 2026-02-03 — v1.0 — Initial version for short internal meetings.