devskill 2.0.7 → 2.0.8

package/skills/markdown-to-html/references/writing-mathematical-expressions-to-html.md

@@ -0,0 +1,350 @@
+# Writing Mathematical Expressions to HTML
+
+## Writing Inline Expressions
+
+### Markdown
+
+```markdown
+This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$
+```
+
+### Parsed HTML
+
+```html
+<p>This sentence uses <code>$</code> delimiters to show math inline:
+ <math-renderer><math xmlns="http://www.w3.org/1998/Math/MathML">
+  <msqrt>
+   <mn>3</mn>
+   <mi>x</mi>
+   <mo>−</mo>
+   <mn>1</mn>
+  </msqrt>
+  <mo>+</mo>
+  <mo>(</mo>
+  <mn>1</mn>
+  <mo>+</mo>
+  <mi>x</mi>
+  <msup>
+   <mo>)</mo>
+   <mn>2</mn>
+  </msup>
+</math>
+</math-renderer>
+</p>
+```
+
+### Markdown
+
+```markdown
+This sentence uses $\` and \`$ delimiters to show math inline: $`\sqrt{3x-1}+(1+x)^2`$
+```
+
+### Parsed HTML
+
+```html
+<p>This sentence uses
+ <math-renderer>
+  <math xmlns="http://www.w3.org/1998/Math/MathML">
+   <mo>‘</mo>
+   <mi>a</mi>
+   <mi>n</mi>
+   <mi>d</mi>
+   <mo>‘</mo>
+  </math>
+ </math-renderer> delimiters to show math inline:
+ <math-renderer>
+  <math xmlns="http://www.w3.org/1998/Math/MathML">
+   <msqrt>
+    <mn>3</mn>
+    <mi>x</mi>
+    <mo>−</mo>
+    <mn>1</mn>
+   </msqrt>
+   <mo>+</mo>
+   <mo stretchy="false">(</mo>
+   <mn>1</mn>
+   <mo>+</mo>
+   <mi>x</mi>
+   <msup>
+    <mo stretchy="false">)</mo>
+    <mn>2</mn>
+   </msup>
+  </math>
+ </math-renderer>
+</p>
+```
+
+---
+
+## Writing Expressions as Blocks
+
+### Markdown
+
+```markdown
+**The Cauchy-Schwarz Inequality**\
+$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$
+```
+
+### Parsed HTML
+
+```html
+<p>
+  <strong>The Cauchy-Schwarz Inequality</strong><br>
+  <math-renderer>
+    <math xmlns="http://www.w3.org/1998/Math/MathML">
+      <msup>
+        <mrow>
+          <mo>(</mo>
+          <munderover>
+            <mo>∑</mo>
+            <mrow>
+              <mi>k</mi>
+              <mo>=</mo>
+              <mn>1</mn>
+            </mrow>
+            <mi>n</mi>
+          </munderover>
+          <msub>
+            <mi>a</mi>
+            <mi>k</mi>
+          </msub>
+          <msub>
+            <mi>b</mi>
+            <mi>k</mi>
+          </msub>
+          <mo>)</mo>
+        </mrow>
+        <mn>2</mn>
+      </msup>
+      <mo>≤</mo>
+      <mrow>
+        <mo>(</mo>
+        <munderover>
+          <mo>∑</mo>
+          <mrow>
+            <mi>k</mi>
+            <mo>=</mo>
+            <mn>1</mn>
+          </mrow>
+          <mi>n</mi>
+        </munderover>
+        <msubsup>
+          <mi>a</mi>
+          <mi>k</mi>
+          <mn>2</mn>
+        </msubsup>
+        <mo>)</mo>
+      </mrow>
+      <mrow>
+        <mo>(</mo>
+        <munderover>
+          <mo>∑</mo>
+          <mrow>
+            <mi>k</mi>
+            <mo>=</mo>
+            <mn>1</mn>
+          </mrow>
+          <mi>n</mi>
+        </munderover>
+        <msubsup>
+          <mi>b</mi>
+          <mi>k</mi>
+          <mn>2</mn>
+        </msubsup>
+        <mo>)</mo>
+      </mrow>
+    </math>
+  </math-renderer>
+</p>
+```
+
+### Markdown
+
+```markdown
+**The Cauchy-Schwarz Inequality**
+
+    ```math
+    \left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
+    ```
+```
+
+### Parsed HTML
+
+```html
+<p><strong>The Cauchy-Schwarz Inequality</strong></p>
+
+<math-renderer>
+  <math xmlns="http://www.w3.org/1998/Math/MathML">
+    <msup>
+      <mrow>
+        <mo>(</mo>
+        <munderover>
+          <mo>∑</mo>
+          <mrow>
+            <mi>k</mi>
+            <mo>=</mo>
+            <mn>1</mn>
+          </mrow>
+          <mi>n</mi>
+        </munderover>
+        <msub>
+          <mi>a</mi>
+          <mi>k</mi>
+        </msub>
+        <msub>
+          <mi>b</mi>
+          <mi>k</mi>
+        </msub>
+        <mo>)</mo>
+      </mrow>
+      <mn>2</mn>
+    </msup>
+    <mo>≤</mo>
+    <mrow>
+      <mo>(</mo>
+      <munderover>
+        <mo>∑</mo>
+        <mrow>
+          <mi>k</mi>
+          <mo>=</mo>
+          <mn>1</mn>
+        </mrow>
+        <mi>n</mi>
+      </munderover>
+      <msubsup>
+        <mi>a</mi>
+        <mi>k</mi>
+        <mn>2</mn>
+      </msubsup>
+      <mo>)</mo>
+    </mrow>
+    <mrow>
+      <mo>(</mo>
+      <munderover>
+        <mo>∑</mo>
+        <mrow>
+          <mi>k</mi>
+          <mo>=</mo>
+          <mn>1</mn>
+        </mrow>
+        <mi>n</mi>
+      </munderover>
+      <msubsup>
+        <mi>b</mi>
+        <mi>k</mi>
+        <mn>2</mn>
+      </msubsup>
+      <mo>)</mo>
+    </mrow>
+  </math>
+</math-renderer>
+```
+
+### Markdown
+
+```markdown
+The equation $a^2 + b^2 = c^2$ is the Pythagorean theorem.
+```
+
+### Parsed HTML
+
+```html
+<p>The equation
+ <math-renderer><math xmlns="http://www.w3.org/1998/Math/MathML">
+  <msup>
+    <mi>a</mi>
+    <mn>2</mn>
+  </msup>
+  <mo>+</mo>
+  <msup>
+    <mi>b</mi>
+    <mn>2</mn>
+  </msup>
+  <mo>=</mo>
+  <msup>
+    <mi>c</mi>
+    <mn>2</mn>
+  </msup>
+ </math></math-renderer> is the Pythagorean theorem.
+</p>
+```
+
+### Markdown
+
+```
+$$
+\int_0^\infty e^{-x} dx = 1
+$$
+```
+
+### Parsed HTML
+
+```html
+<p><math-renderer><math xmlns="http://www.w3.org/1998/Math/MathML">
+  <msubsup>
+    <mo>∫</mo>
+    <mn>0</mn>
+    <mi>∞</mi>
+  </msubsup>
+  <msup>
+    <mi>e</mi>
+    <mrow>
+      <mo>−</mo>
+      <mi>x</mi>
+    </mrow>
+  </msup>
+  <mi>d</mi>
+  <mi>x</mi>
+  <mo>=</mo>
+  <mn>1</mn>
+</math></math-renderer></p>
+```
+
+---
+
+## Dollar Sign Inline with Mathematical Expression
+
+### Markdown
+
+```markdown
+This expression uses `\$` to display a dollar sign: $`\sqrt{\$4}`$
+```
+
+### Parsed HTML
+
+```html
+<p>This expression uses
+ <code>\$</code> to display a dollar sign:
+ <math-renderer>
+  <math xmlns="http://www.w3.org/1998/Math/MathML">
+   <msqrt>
+    <mi>$</mi>
+    <mn>4</mn>
+   </msqrt>
+  </math>
+ </math-renderer>
+</p>
+```
+
+### Markdown
+
+```markdown
+To split <span>$</span>100 in half, we calculate $100/2$
+```
+
+### Parsed HTML
+
+```html
+<p>To split
+ <span>$</span>100 in half, we calculate
+ <math-renderer>
+  <math xmlns="http://www.w3.org/1998/Math/MathML">
+   <mn>100</mn>
+   <mrow data-mjx-texclass="ORD">
+    <mo>/</mo>
+   </mrow>
+   <mn>2</mn>
+  </math>
+ </math-renderer>
+</p>
+```

package/skills/markdown-to-html/references/writing-mathematical-expressions.md

@@ -0,0 +1,76 @@
+# Writing mathematical expressions
+
+Use Markdown to display mathematical expressions on GitHub.
+
+## About writing mathematical expressions
+
+To enable clear communication of mathematical expressions, GitHub supports LaTeX formatted math within Markdown. For more information, see [LaTeX/Mathematics](http://en.wikibooks.org/wiki/LaTeX/Mathematics) in Wikibooks.
+
+GitHub's math rendering capability uses MathJax; an open source, JavaScript-based display engine. MathJax supports a wide range of LaTeX macros, and several useful accessibility extensions. For more information, see [the MathJax documentation](http://docs.mathjax.org/en/latest/input/tex/index.html#tex-and-latex-support) and [the MathJax Accessibility Extensions Documentation](https://mathjax.github.io/MathJax-a11y/docs/#reader-guide).
+
+Mathematical expressions rendering is available in GitHub Issues, GitHub Discussions, pull requests, wikis, and Markdown files.
+
+## Writing inline expressions
+
+There are two options for delimiting a math expression inline with your text. You can either surround the expression with dollar symbols (`$`), or start the expression with <code>$\`</code> and end it with <code>\`$</code>. The latter syntax is useful when the expression you are writing contains characters that overlap with markdown syntax. For more information, see [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax).
+
+```text
+This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$
+```
+
+![Screenshot of rendered Markdown showing an inline mathematical expression: the square root of 3x minus 1 plus (1 plus x) squared.](https://docs.github.com/assets/images/help/writing/inline-math-markdown-rendering.png)
+
+```text
+This sentence uses $\` and \`$ delimiters to show math inline: $`\sqrt{3x-1}+(1+x)^2`$
+```
+
+![Screenshot of rendered Markdown showing an inline mathematical expression with backtick syntax: the square root of 3x minus 1 plus (1 plus x) squared.](https://docs.github.com/assets/images/help/writing/inline-backtick-math-markdown-rendering.png)
+
+## Writing expressions as blocks
+
+To add a math expression as a block, start a new line and delimit the expression with two dollar symbols `$$`.
+
+>  [!TIP] If you're writing in an .md file, you will need to use specific formatting to create a line break, such as ending the line with a backslash as shown in the example below. For more information on line breaks in Markdown, see [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#line-breaks).
+
+```text
+**The Cauchy-Schwarz Inequality**\
+$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$
+```
+
+![Screenshot of rendered Markdown showing a complex equation. Bold text reads "The Cauchy-Schwarz Inequality" above the formula for the inequality.](https://docs.github.com/assets/images/help/writing/math-expression-as-a-block-rendering.png)
+
+Alternatively, you can use the <code>\`\`\`math</code> code block syntax to display a math expression as a block. With this syntax, you don't need to use `$$` delimiters. The following will render the same as above:
+
+````text
+**The Cauchy-Schwarz Inequality**
+
+```math
+\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
+```
+````
+
+## Writing dollar signs in line with and within mathematical expressions
+
+To display a dollar sign as a character in the same line as a mathematical expression, you need to escape the non-delimiter `$` to ensure the line renders correctly.
+
+* Within a math expression, add a `\` symbol before the explicit `$`.
+
+  ```text
+  This expression uses `\$` to display a dollar sign: $`\sqrt{\$4}`$
+  ```
+
+  ![Screenshot of rendered Markdown showing how a backslash before a dollar sign displays the sign as part of a mathematical expression.](https://docs.github.com/assets/images/help/writing/dollar-sign-within-math-expression.png)
+
+* Outside a math expression, but on the same line, use span tags around the explicit `$`.
+
+  ```text
+  To split <span>$</span>100 in half, we calculate $100/2$
+  ```
+
+  ![Screenshot of rendered Markdown showing how span tags around a dollar sign display the sign as inline text not as part of a mathematical equation.](https://docs.github.com/assets/images/help/writing/dollar-sign-inline-math-expression.png)
+
+## Further reading
+
+* [The MathJax website](http://mathjax.org)
+* [Getting started with writing and formatting on GitHub](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github)
+* [GitHub Flavored Markdown Spec](https://github.github.com/gfm/)

package/skills/mcp-cli/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/mcp-cli/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: mcp-cli
+description: 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.
+---
+
+# MCP-CLI
+
+Access MCP servers through the command line. MCP enables interaction with external systems like GitHub, filesystems, databases, and APIs.
+
+## Commands
+
+| Command                            | Output                          |
+| ---------------------------------- | ------------------------------- |
+| `mcp-cli`                          | List all servers and tool names |
+| `mcp-cli <server>`                 | Show tools with parameters      |
+| `mcp-cli <server>/<tool>`          | Get tool JSON schema            |
+| `mcp-cli <server>/<tool> '<json>'` | Call tool with arguments        |
+| `mcp-cli grep "<glob>"`            | Search tools by name            |
+
+**Add `-d` to include descriptions** (e.g., `mcp-cli filesystem -d`)
+
+## Workflow
+
+1. **Discover**: `mcp-cli` → see available servers and tools
+2. **Explore**: `mcp-cli <server>` → see tools with parameters
+3. **Inspect**: `mcp-cli <server>/<tool>` → get full JSON input schema
+4. **Execute**: `mcp-cli <server>/<tool> '<json>'` → run with arguments
+
+## Examples
+
+```bash
+# List all servers and tool names
+mcp-cli
+
+# See all tools with parameters
+mcp-cli filesystem
+
+# With descriptions (more verbose)
+mcp-cli filesystem -d
+
+# Get JSON schema for specific tool
+mcp-cli filesystem/read_file
+
+# Call the tool
+mcp-cli filesystem/read_file '{"path": "./README.md"}'
+
+# Search for tools
+mcp-cli grep "*file*"
+
+# JSON output for parsing
+mcp-cli filesystem/read_file '{"path": "./README.md"}' --json
+
+# Complex JSON with quotes (use heredoc or stdin)
+mcp-cli server/tool <<EOF
+{"content": "Text with 'quotes' inside"}
+EOF
+
+# Or pipe from a file/command
+cat args.json | mcp-cli server/tool
+
+# Find all TypeScript files and read the first one
+mcp-cli filesystem/search_files '{"path": "src/", "pattern": "*.ts"}' --json | jq -r '.content[0].text' | head -1 | xargs -I {} sh -c 'mcp-cli filesystem/read_file "{\"path\": \"{}\"}"'
+```
+
+## Options
+
+| Flag         | Purpose                   |
+| ------------ | ------------------------- |
+| `-j, --json` | JSON output for scripting |
+| `-r, --raw`  | Raw text content          |
+| `-d`         | Include descriptions      |
+
+## Exit Codes
+
+- `0`: Success
+- `1`: Client error (bad args, missing config)
+- `2`: Server error (tool failed)
+- `3`: Network error

package/skills/mcp-cli/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/mcp-cli`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/mcp-copilot-studio-server-generator/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/mcp-copilot-studio-server-generator/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: mcp-copilot-studio-server-generator
+description: 'Generate a complete MCP server implementation optimized for Copilot Studio integration with proper schema constraints and streamable HTTP support'
+---
+
+# Power Platform MCP Connector Generator
+
+Generate a complete Power Platform custom connector with Model Context Protocol (MCP) integration for Microsoft Copilot Studio. This prompt creates all necessary files following Power Platform connector standards with MCP streamable HTTP support.
+
+## Instructions
+
+Create a complete MCP server implementation that:
+
+1. **Uses Copilot Studio MCP Pattern:**
+   - Implement `x-ms-agentic-protocol: mcp-streamable-1.0`
+   - Support JSON-RPC 2.0 communication protocol
+   - Provide streamable HTTP endpoint at `/mcp`
+   - Follow Power Platform connector structure
+
+2. **Schema Compliance Requirements:**
+   - **NO reference types** in tool inputs/outputs (filtered by Copilot Studio)
+   - **Single type values only** (not arrays of multiple types)
+   - **Avoid enum inputs** (interpreted as string, not enum)
+   - Use primitive types: string, number, integer, boolean, array, object
+   - Ensure all endpoints return full URIs
+
+3. **MCP Components to Include:**
+   - **Tools**: Functions for the language model to call (✅ Supported in Copilot Studio)
+   - **Resources**: File-like data outputs from tools (✅ Supported in Copilot Studio - must be tool outputs to be accessible)
+   - **Prompts**: Predefined templates for specific tasks (❌ Not yet supported in Copilot Studio)
+
+4. **Implementation Structure:**
+   ```
+   /apiDefinition.swagger.json  (Power Platform connector schema)
+   /apiProperties.json         (Connector metadata and configuration)
+   /script.csx                 (Custom code transformations and logic)
+   /server/                    (MCP server implementation)
+   /tools/                     (Individual MCP tools)
+   /resources/                 (MCP resource handlers)
+   ```
+
+## Context Variables
+
+- **Server Purpose**: [Describe what the MCP server should accomplish]
+- **Tools Needed**: [List of specific tools to implement]  
+- **Resources**: [Types of resources to provide]
+- **Authentication**: [Auth method: none, api-key, oauth2]
+- **Host Environment**: [Azure Function, Express.js, FastAPI, etc.]
+- **Target APIs**: [External APIs to integrate with]
+
+## Expected Output
+
+Generate:
+
+1. **apiDefinition.swagger.json** with:
+   - Proper `x-ms-agentic-protocol: mcp-streamable-1.0`
+   - MCP endpoint at POST `/mcp`
+   - Compliant schema definitions (no reference types)
+   - McpResponse and McpErrorResponse definitions
+
+2. **apiProperties.json** with:
+   - Connector metadata and branding
+   - Authentication configuration
+   - Policy templates if needed
+
+3. **script.csx** with:
+   - Custom C# code for request/response transformations
+   - MCP JSON-RPC message handling logic
+   - Data validation and processing functions
+   - Error handling and logging capabilities
+
+4. **MCP Server Code** with:
+   - JSON-RPC 2.0 request handler
+   - Tool registration and execution
+   - Resource management (as tool outputs)
+   - Proper error handling
+   - Copilot Studio compatibility checks
+
+5. **Individual Tools** that:
+   - Accept only primitive type inputs
+   - Return structured outputs
+   - Include resources as outputs when needed
+   - Provide clear descriptions for Copilot Studio
+
+6. **Deployment Configuration** for:
+   - Power Platform environment
+   - Copilot Studio agent integration
+   - Testing and validation
+
+## Validation Checklist
+
+Ensure generated code:
+- [ ] No reference types in schemas
+- [ ] All type fields are single types
+- [ ] Enum handling via string with validation
+- [ ] Resources available through tool outputs
+- [ ] Full URI endpoints
+- [ ] JSON-RPC 2.0 compliance
+- [ ] Proper x-ms-agentic-protocol header
+- [ ] McpResponse/McpErrorResponse schemas
+- [ ] Clear tool descriptions for Copilot Studio
+- [ ] Generative Orchestration compatible
+
+## Example Usage
+
+```yaml
+Server Purpose: Customer data management and analysis
+Tools Needed: 
+  - searchCustomers
+  - getCustomerDetails
+  - analyzeCustomerTrends
+Resources:
+  - Customer profiles
+  - Analysis reports
+Authentication: oauth2
+Host Environment: Azure Function
+Target APIs: CRM System REST API
+```

package/skills/mcp-copilot-studio-server-generator/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/mcp-copilot-studio-server-generator`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24