Merge remote-tracking branch 'origin/main' into users/suyashpatel/server-logic-skill

Author: Priyanshu Agrawal

.claude-plugin/marketplace.json

@@ -34,7 +34,22 @@
             ]
         },
         {
-            "name": "code-apps",
+            "name": "canvas-apps",
+            "source": "./plugins/canvas-apps",
+            "description": "Build Power Apps Canvas Apps using the Canvas Authoring MCP server",
+            "category": "development",
+            "tags": [
+                "power platform",
+                "power apps",
+                "canvas apps",
+                "pa-yaml",
+                "msapp",
+                "connectors",
+                "microsoft"
+            ]
+        },
+        {
+            "name": "code-apps-preview",
             "source": "./plugins/code-apps",
             "description": "Build and deploy Power Apps code apps using React, Vite, and Power Platform connectors",
             "category": "development",
@@ -51,4 +66,3 @@
         }
     ]
 }
-

.claude/settings.json

@@ -1,4 +1,15 @@
 {
+  "extraKnownMarketplaces": {
+    "anthropic-agent-skills": {
+      "source": {
+        "source": "github",
+        "repo": "anthropics/skills"
+      }
+    }
+  },
+  "enabledPlugins": {
+    "document-skills@anthropic-agent-skills": true
+  },
   "permissions": {
     "allow": [
       "Bash(pac *)",

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -8,6 +8,7 @@ body:
       label: Plugin
       description: Which plugin is this bug related to?
       options:
+        - canvas-apps
         - code-apps
         - model-apps
         - power-pages

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -8,6 +8,7 @@ body:
       label: Plugin
       description: Which plugin is this feature request for?
       options:
+        - canvas-apps
         - code-apps
         - model-apps
         - power-pages

.github/workflows/validate-plugin-names.yml

@@ -0,0 +1,56 @@
+name: validate-plugin-names
+
+on:
+    push:
+        branches:
+            - main
+    workflow_dispatch:
+
+jobs:
+    validate-plugin-names:
+        name: validate-plugin-names
+        runs-on: ubuntu-latest
+        steps:
+            - name: checkout
+              uses: actions/checkout@v4
+
+            - name: validate-kebab-case-plugin-names
+              shell: bash
+              run: |
+                  python3 <<'PY'
+                  import json
+                  import re
+                  from pathlib import Path
+
+                  KEBAB_CASE_PATTERN = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
+
+
+                  def validate_name(name, source):
+                      if KEBAB_CASE_PATTERN.fullmatch(name):
+                          return None
+                      return f"{source}: '{name}' is not kebab-case"
+
+
+                  errors = []
+
+                  marketplace_path = Path(".claude-plugin/marketplace.json")
+                  marketplace = json.loads(marketplace_path.read_text())
+                  for index, plugin in enumerate(marketplace.get("plugins", [])):
+                      error = validate_name(plugin["name"], f"{marketplace_path} plugins[{index}].name")
+                      if error:
+                          errors.append(error)
+
+                  for plugin_manifest_path in sorted(Path("plugins").glob("*/.claude-plugin/plugin.json")):
+                      plugin_manifest = json.loads(plugin_manifest_path.read_text())
+                      error = validate_name(plugin_manifest["name"], f"{plugin_manifest_path} name")
+                      if error:
+                          errors.append(error)
+
+                  if errors:
+                      print("Found plugin names that are not kebab-case:")
+                      for error in errors:
+                          print(f"- {error}")
+                      raise SystemExit(1)
+
+                  print("All plugin names are kebab-case.")
+                  PY

README.md

@@ -47,6 +47,7 @@ If you prefer to install manually, run these commands inside a Claude Code or Gi
     /plugin install power-pages@power-platform-skills
     /plugin install model-apps@power-platform-skills
     /plugin install code-apps@power-platform-skills
+    /plugin install canvas-apps@power-platform-skills
     ```
 
 ## Available Plugins
@@ -69,6 +70,12 @@ Build and deploy Power Apps code apps connected to Power Platform via connectors
 
 **Stack**: React + Vite + TypeScript, deployed via PAC CLI
 
+### [Canvas Apps](plugins/canvas-apps/AGENTS.md) (`plugins/canvas-apps`)
+
+Author Power Apps Canvas Apps using the Canvas Authoring MCP server.
+
+**Stack**: PA YAML (`.pa.yaml`) authored via `CanvasAuthoringMcpServer`, requires .NET 10 SDK
+
 ## Local Development
 
 To develop and test plugins locally, follow these steps:
@@ -80,6 +87,7 @@ To develop and test plugins locally, follow these steps:
     claude --plugin-dir /path/to/power-platform-skills/plugins/power-pages
     claude --plugin-dir /path/to/power-platform-skills/plugins/model-apps
     claude --plugin-dir /path/to/power-platform-skills/plugins/code-apps
+    claude --plugin-dir /path/to/power-platform-skills/plugins/canvas-apps
     ```
 
 ## Running Without Interruption
@@ -159,18 +167,23 @@ power-platform-skills/
 │   │   ├── shared/
 │   │   └── skills/
 │   ├── model-apps/           # Model Apps plugin
+│   |   ├── .claude-plugin/
+│   │   └── plugin.json
+│   |   ├── commands/
+│   |   ├── skills/
+│   |   ├── shared/           # Shared references + samples
+│   |   └── github/           # GitHub Copilot instructions
+│   ├── code-apps/            # Code Apps plugin
+│   │   ├── .claude-plugin/
+│   │   │   └── plugin.json
+│   │   ├── agents/
+│   │   ├── skills/
+│   │   └── shared/           # Shared instructions + references
+│   └── canvas-apps/          # Canvas Apps plugin
 │       ├── .claude-plugin/
 │       │   └── plugin.json
-│       ├── commands/
-│       ├── skills/
-│       ├── shared/           # Shared references + samples
-│       └── github/           # GitHub Copilot instructions
-│   └── code-apps/            # Code Apps plugin
-│       ├── .claude-plugin/
-│       │   └── plugin.json
-│       ├── agents/
-│       ├── skills/
-│       └── shared/           # Shared instructions + references
+│       ├── references/       # Technical + design guides
+│       └── skills/
 ├── AGENTS.md                 # Development guidelines
 └── README.md
 ```

plugins/canvas-apps/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "canvas-apps",
+  "version": "1.0.1",
+  "description": "Build Power Apps Canvas Apps using the Canvas Authoring MCP server.",
+  "author": {
+    "name": "Microsoft",
+    "url": "https://www.microsoft.com"
+  },
+  "homepage": "https://github.com/microsoft/power-platform-skills/",
+  "repository": "https://github.com/microsoft/power-platform-skills/",
+  "license": "MIT",
+  "keywords": [
+    "canvas-apps",
+    "power-apps",
+    "canvas",
+    "pa-yaml",
+    "msapp"
+  ]
+}

plugins/canvas-apps/AGENTS.md

@@ -0,0 +1,62 @@
+# AGENTS.md — Canvas Apps Plugin
+
+This file provides guidance to AI Agents when working with the **canvas-apps** plugin.
+
+## What This Plugin Is
+
+A plugin for authoring Power Apps Canvas Apps. The Canvas Authoring MCP server (`CanvasAuthoringMcpServer`) exposes tools and prompts that Claude uses directly — no skill orchestration layer is needed. Claude calls the MCP tools in conversation to generate, validate, and compile Canvas App YAML files (`.pa.yaml`) in conjunction with a running coauthoring studio session
+
+## Local Development
+
+Test this plugin locally:
+
+```bash
+claude --plugin-dir /path/to/plugins/canvas-apps
+```
+
+## Architecture
+
+```
+.claude-plugin/plugin.json     ← Plugin metadata (name, version, keywords)
+AGENTS.md                      ← Plugin guidance for AI agents (this file)
+CLAUDE.md                      ← Symlink → AGENTS.md
+references/
+  TechnicalGuide.md            ← YAML syntax, control selection, layout strategies, Power Fx patterns
+  DesignGuide.md               ← Aesthetic guidelines, anti-patterns, design process
+skills/
+  configure-canvas-mcp/
+    SKILL.md                   ← Registers the Canvas Authoring MCP server with Claude Code
+  generate-canvas-app/
+    SKILL.md                   ← Generates pa.yaml source files for a described Canvas App
+  edit-canvas-app/
+    SKILL.md                   ← Edits pa.yaml source files for an existing Canvas App
+```
+
+## Skills
+
+| Skill | Description |
+|-------|-------------|
+| `/configure-canvas-mcp` | Register the Canvas Authoring MCP server with Claude Code |
+| `/generate-canvas-app` | Generate a complete Canvas App from a natural language description |
+| `/edit-canvas-app` | Edit an existing Canvas App from a natural language description of changes |
+
+## MCP Tools
+
+The `canvas-authoring` MCP server exposes the following tools:
+
+| Tool | Description |
+|------|-------------|
+| `compile_canvas` | Validates canvas app YAML files in a directory using the Power Apps authoring service |
+| `describe_api` | Gets detailed information about a specific API (connector) including its operations and parameters |
+| `describe_control` | Gets detailed information about a specific Power Apps control including properties, variants, and metadata |
+| `get_data_source_schema` | Gets the schema (columns and their Power Fx types) for a specific data source in the current authoring session |
+| `list_apis` | Lists all available APIs (connectors) in the current authoring session |
+| `list_controls` | Lists all available Power Apps controls in the current authoring session |
+| `list_data_sources` | Lists all available data sources in the current authoring session |
+| `sync_canvas` | Syncs the current coauthoring session state from the server to a local directory, writing all YAML files |
+
+## Prerequisites
+
+Before the MCP server will start, you need:
+
+**.NET 10 SDK** — [Download from Microsoft](https://dotnet.microsoft.com/download/dotnet/10.0)

plugins/canvas-apps/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

plugins/canvas-apps/README.md

@@ -0,0 +1,79 @@
+# Canvas Apps Plugin
+
+Build Power Apps Canvas Apps with your coding agent as coauthor. This plugin connects AI coding assistants to the Power Apps authoring service over stdio, enabling them to validate .pa.yaml files, browse available controls and their properties, discover APIs/connectors and data sources, and sync app state from live coauthoring sessions. 
+
+> **Preview:** This plugin is currently in [preview](https://www.microsoft.com/en-us/business-applications/legal/supp-powerplatform-preview/). These features are available before official release for customers to provide feedback.
+
+## Prerequisites
+
+- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
+
+## Installation
+
+### From the marketplace
+
+```bash
+/plugin marketplace add microsoft/power-platform-skills
+/plugin install canvas-apps@power-platform-skills
+```
+
+### From a local clone
+
+```bash
+claude --plugin-dir /path/to/power-platform-skills/plugins/canvas-apps
+```
+
+## Skills
+
+### `/configure-canvas-mcp`
+
+Register the Canvas Authoring MCP server with Claude Code or GitHub Copilot.
+
+**Usage:** Invoke directly with `/configure-canvas-mcp`, or use any of the keywords below to trigger the skill automatically:
+
+- `Configure MCP for Canvas Apps`
+- `Set up the Canvas Authoring MCP server`
+- `Connect Canvas Apps MCP`
+
+### `/generate-canvas-app`
+
+Generate a complete Canvas App from a natural language description.
+
+**Usage:** Invoke directly with `/generate-canvas-app`, or use any of the keywords below to trigger the skill automatically:
+
+- `Create a Canvas App for managing inventory`
+- `I need a Canvas App for tracking employee time off`
+
+### `/edit-canvas-app`
+
+Edit an existing Canvas App from a natural language description of changes.
+
+**Usage:** Invoke directly with `/edit-canvas-app`, or use any of the keywords below to trigger the skill automatically:
+
+- `Modify the form in my existing Canvas App to include validation`
+- `Edit my Canvas App to add a new screen for reports`
+
+## MCP Tools
+
+The `canvas-authoring` MCP server exposes the following tools:
+
+| Tool | Description |
+|------|-------------|
+| `compile_canvas` | Validates canvas app YAML files in a directory using the Power Apps authoring service |
+| `describe_api` | Gets detailed information about a specific API (connector) including its operations and parameters |
+| `describe_control` | Gets detailed information about a specific Power Apps control including properties, variants, and metadata |
+| `get_data_source_schema` | Gets the schema (columns and their Power Fx types) for a specific data source in the current authoring session |
+| `list_apis` | Lists all available APIs (connectors) in the current authoring session |
+| `list_controls` | Lists all available Power Apps controls in the current authoring session |
+| `list_data_sources` | Lists all available data sources in the current authoring session |
+| `sync_canvas` | Syncs the current coauthoring session state from the server to a local directory, writing all YAML files |
+
+## Security
+
+Your credentials are always handled securely through the official Azure Identity SDK - we never store or manage tokens directly.
+
+MCP is a new and developing standard. As with all new technology standards, you should review the security of any systems that integrate with MCP servers, such as MCP hosts, clients, agents, AI applications, and models and confirm that they comply with system requirements, standards, and expectations. You should follow Microsoft security guidance for MCP servers, including enabling Entra ID authentication, secure token management, and network isolation. Refer to Microsoft Security Documentation for details.
+
+
+## License
+See the [LICENSE](../../LICENSE) file for license information.