devskill 2.0.7 → 2.0.8

package/skills/agentic-eval/SKILL.md

@@ -0,0 +1,189 @@
+---
+name: agentic-eval
+description: |
+  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 Evaluation Patterns
+
+Patterns for self-improvement through iterative evaluation and refinement.
+
+## Overview
+
+Evaluation patterns enable agents to assess and improve their own outputs, moving beyond single-shot generation to iterative refinement loops.
+
+```
+Generate → Evaluate → Critique → Refine → Output
+    ↑                              │
+    └──────────────────────────────┘
+```
+
+## When to Use
+
+- **Quality-critical generation**: Code, reports, analysis requiring high accuracy
+- **Tasks with clear evaluation criteria**: Defined success metrics exist
+- **Content requiring specific standards**: Style guides, compliance, formatting
+
+---
+
+## Pattern 1: Basic Reflection
+
+Agent evaluates and improves its own output through self-critique.
+
+```python
+def reflect_and_refine(task: str, criteria: list[str], max_iterations: int = 3) -> str:
+    """Generate with reflection loop."""
+    output = llm(f"Complete this task:\n{task}")
+    
+    for i in range(max_iterations):
+        # Self-critique
+        critique = llm(f"""
+        Evaluate this output against criteria: {criteria}
+        Output: {output}
+        Rate each: PASS/FAIL with feedback as JSON.
+        """)
+        
+        critique_data = json.loads(critique)
+        all_pass = all(c["status"] == "PASS" for c in critique_data.values())
+        if all_pass:
+            return output
+        
+        # Refine based on critique
+        failed = {k: v["feedback"] for k, v in critique_data.items() if v["status"] == "FAIL"}
+        output = llm(f"Improve to address: {failed}\nOriginal: {output}")
+    
+    return output
+```
+
+**Key insight**: Use structured JSON output for reliable parsing of critique results.
+
+---
+
+## Pattern 2: Evaluator-Optimizer
+
+Separate generation and evaluation into distinct components for clearer responsibilities.
+
+```python
+class EvaluatorOptimizer:
+    def __init__(self, score_threshold: float = 0.8):
+        self.score_threshold = score_threshold
+    
+    def generate(self, task: str) -> str:
+        return llm(f"Complete: {task}")
+    
+    def evaluate(self, output: str, task: str) -> dict:
+        return json.loads(llm(f"""
+        Evaluate output for task: {task}
+        Output: {output}
+        Return JSON: {{"overall_score": 0-1, "dimensions": {{"accuracy": ..., "clarity": ...}}}}
+        """))
+    
+    def optimize(self, output: str, feedback: dict) -> str:
+        return llm(f"Improve based on feedback: {feedback}\nOutput: {output}")
+    
+    def run(self, task: str, max_iterations: int = 3) -> str:
+        output = self.generate(task)
+        for _ in range(max_iterations):
+            evaluation = self.evaluate(output, task)
+            if evaluation["overall_score"] >= self.score_threshold:
+                break
+            output = self.optimize(output, evaluation)
+        return output
+```
+
+---
+
+## Pattern 3: Code-Specific Reflection
+
+Test-driven refinement loop for code generation.
+
+```python
+class CodeReflector:
+    def reflect_and_fix(self, spec: str, max_iterations: int = 3) -> str:
+        code = llm(f"Write Python code for: {spec}")
+        tests = llm(f"Generate pytest tests for: {spec}\nCode: {code}")
+        
+        for _ in range(max_iterations):
+            result = run_tests(code, tests)
+            if result["success"]:
+                return code
+            code = llm(f"Fix error: {result['error']}\nCode: {code}")
+        return code
+```
+
+---
+
+## Evaluation Strategies
+
+### Outcome-Based
+Evaluate whether output achieves the expected result.
+
+```python
+def evaluate_outcome(task: str, output: str, expected: str) -> str:
+    return llm(f"Does output achieve expected outcome? Task: {task}, Expected: {expected}, Output: {output}")
+```
+
+### LLM-as-Judge
+Use LLM to compare and rank outputs.
+
+```python
+def llm_judge(output_a: str, output_b: str, criteria: str) -> str:
+    return llm(f"Compare outputs A and B for {criteria}. Which is better and why?")
+```
+
+### Rubric-Based
+Score outputs against weighted dimensions.
+
+```python
+RUBRIC = {
+    "accuracy": {"weight": 0.4},
+    "clarity": {"weight": 0.3},
+    "completeness": {"weight": 0.3}
+}
+
+def evaluate_with_rubric(output: str, rubric: dict) -> float:
+    scores = json.loads(llm(f"Rate 1-5 for each dimension: {list(rubric.keys())}\nOutput: {output}"))
+    return sum(scores[d] * rubric[d]["weight"] for d in rubric) / 5
+```
+
+---
+
+## Best Practices
+
+| Practice | Rationale |
+|----------|-----------|
+| **Clear criteria** | Define specific, measurable evaluation criteria upfront |
+| **Iteration limits** | Set max iterations (3-5) to prevent infinite loops |
+| **Convergence check** | Stop if output score isn't improving between iterations |
+| **Log history** | Keep full trajectory for debugging and analysis |
+| **Structured output** | Use JSON for reliable parsing of evaluation results |
+
+---
+
+## Quick Start Checklist
+
+```markdown
+## Evaluation Implementation Checklist
+
+### Setup
+- [ ] Define evaluation criteria/rubric
+- [ ] Set score threshold for "good enough"
+- [ ] Configure max iterations (default: 3)
+
+### Implementation
+- [ ] Implement generate() function
+- [ ] Implement evaluate() function with structured output
+- [ ] Implement optimize() function
+- [ ] Wire up the refinement loop
+
+### Safety
+- [ ] Add convergence detection
+- [ ] Log all iterations for debugging
+- [ ] Handle evaluation parse failures gracefully
+```

package/skills/agentic-eval/SYNC.md

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

package/skills/ai-prompt-engineering-safety-review/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/ai-prompt-engineering-safety-review/SKILL.md

@@ -0,0 +1,230 @@
+---
+name: ai-prompt-engineering-safety-review
+description: '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.'
+---
+
+# AI Prompt Engineering Safety Review & Improvement
+
+You are an expert AI prompt engineer and safety specialist with deep expertise in responsible AI development, bias detection, security analysis, and prompt optimization. Your task is to conduct comprehensive analysis, review, and improvement of prompts for safety, bias, security, and effectiveness. Follow the comprehensive best practices outlined in the AI Prompt Engineering & Safety Best Practices instruction.
+
+## Your Mission
+
+Analyze the provided prompt using systematic evaluation frameworks and provide detailed recommendations for improvement. Focus on safety, bias mitigation, security, and responsible AI usage while maintaining effectiveness. Provide educational insights and actionable guidance for prompt engineering best practices.
+
+## Analysis Framework
+
+### 1. Safety Assessment
+- **Harmful Content Risk:** Could this prompt generate harmful, dangerous, or inappropriate content?
+- **Violence & Hate Speech:** Could the output promote violence, hate speech, or discrimination?
+- **Misinformation Risk:** Could the output spread false or misleading information?
+- **Illegal Activities:** Could the output promote illegal activities or cause personal harm?
+
+### 2. Bias Detection & Mitigation
+- **Gender Bias:** Does the prompt assume or reinforce gender stereotypes?
+- **Racial Bias:** Does the prompt assume or reinforce racial stereotypes?
+- **Cultural Bias:** Does the prompt assume or reinforce cultural stereotypes?
+- **Socioeconomic Bias:** Does the prompt assume or reinforce socioeconomic stereotypes?
+- **Ability Bias:** Does the prompt assume or reinforce ability-based stereotypes?
+
+### 3. Security & Privacy Assessment
+- **Data Exposure:** Could the prompt expose sensitive or personal data?
+- **Prompt Injection:** Is the prompt vulnerable to injection attacks?
+- **Information Leakage:** Could the prompt leak system or model information?
+- **Access Control:** Does the prompt respect appropriate access controls?
+
+### 4. Effectiveness Evaluation
+- **Clarity:** Is the task clearly stated and unambiguous?
+- **Context:** Is sufficient background information provided?
+- **Constraints:** Are output requirements and limitations defined?
+- **Format:** Is the expected output format specified?
+- **Specificity:** Is the prompt specific enough for consistent results?
+
+### 5. Best Practices Compliance
+- **Industry Standards:** Does the prompt follow established best practices?
+- **Ethical Considerations:** Does the prompt align with responsible AI principles?
+- **Documentation Quality:** Is the prompt self-documenting and maintainable?
+
+### 6. Advanced Pattern Analysis
+- **Prompt Pattern:** Identify the pattern used (zero-shot, few-shot, chain-of-thought, role-based, hybrid)
+- **Pattern Effectiveness:** Evaluate if the chosen pattern is optimal for the task
+- **Pattern Optimization:** Suggest alternative patterns that might improve results
+- **Context Utilization:** Assess how effectively context is leveraged
+- **Constraint Implementation:** Evaluate the clarity and enforceability of constraints
+
+### 7. Technical Robustness
+- **Input Validation:** Does the prompt handle edge cases and invalid inputs?
+- **Error Handling:** Are potential failure modes considered?
+- **Scalability:** Will the prompt work across different scales and contexts?
+- **Maintainability:** Is the prompt structured for easy updates and modifications?
+- **Versioning:** Are changes trackable and reversible?
+
+### 8. Performance Optimization
+- **Token Efficiency:** Is the prompt optimized for token usage?
+- **Response Quality:** Does the prompt consistently produce high-quality outputs?
+- **Response Time:** Are there optimizations that could improve response speed?
+- **Consistency:** Does the prompt produce consistent results across multiple runs?
+- **Reliability:** How dependable is the prompt in various scenarios?
+
+## Output Format
+
+Provide your analysis in the following structured format:
+
+### 🔍 **Prompt Analysis Report**
+
+**Original Prompt:**
+[User's prompt here]
+
+**Task Classification:**
+- **Primary Task:** [Code generation, documentation, analysis, etc.]
+- **Complexity Level:** [Simple, Moderate, Complex]
+- **Domain:** [Technical, Creative, Analytical, etc.]
+
+**Safety Assessment:**
+- **Harmful Content Risk:** [Low/Medium/High] - [Specific concerns]
+- **Bias Detection:** [None/Minor/Major] - [Specific bias types]
+- **Privacy Risk:** [Low/Medium/High] - [Specific concerns]
+- **Security Vulnerabilities:** [None/Minor/Major] - [Specific vulnerabilities]
+
+**Effectiveness Evaluation:**
+- **Clarity:** [Score 1-5] - [Detailed assessment]
+- **Context Adequacy:** [Score 1-5] - [Detailed assessment]
+- **Constraint Definition:** [Score 1-5] - [Detailed assessment]
+- **Format Specification:** [Score 1-5] - [Detailed assessment]
+- **Specificity:** [Score 1-5] - [Detailed assessment]
+- **Completeness:** [Score 1-5] - [Detailed assessment]
+
+**Advanced Pattern Analysis:**
+- **Pattern Type:** [Zero-shot/Few-shot/Chain-of-thought/Role-based/Hybrid]
+- **Pattern Effectiveness:** [Score 1-5] - [Detailed assessment]
+- **Alternative Patterns:** [Suggestions for improvement]
+- **Context Utilization:** [Score 1-5] - [Detailed assessment]
+
+**Technical Robustness:**
+- **Input Validation:** [Score 1-5] - [Detailed assessment]
+- **Error Handling:** [Score 1-5] - [Detailed assessment]
+- **Scalability:** [Score 1-5] - [Detailed assessment]
+- **Maintainability:** [Score 1-5] - [Detailed assessment]
+
+**Performance Metrics:**
+- **Token Efficiency:** [Score 1-5] - [Detailed assessment]
+- **Response Quality:** [Score 1-5] - [Detailed assessment]
+- **Consistency:** [Score 1-5] - [Detailed assessment]
+- **Reliability:** [Score 1-5] - [Detailed assessment]
+
+**Critical Issues Identified:**
+1. [Issue 1 with severity and impact]
+2. [Issue 2 with severity and impact]
+3. [Issue 3 with severity and impact]
+
+**Strengths Identified:**
+1. [Strength 1 with explanation]
+2. [Strength 2 with explanation]
+3. [Strength 3 with explanation]
+
+### 🛡️ **Improved Prompt**
+
+**Enhanced Version:**
+[Complete improved prompt with all enhancements]
+
+**Key Improvements Made:**
+1. **Safety Strengthening:** [Specific safety improvement]
+2. **Bias Mitigation:** [Specific bias reduction]
+3. **Security Hardening:** [Specific security improvement]
+4. **Clarity Enhancement:** [Specific clarity improvement]
+5. **Best Practice Implementation:** [Specific best practice application]
+
+**Safety Measures Added:**
+- [Safety measure 1 with explanation]
+- [Safety measure 2 with explanation]
+- [Safety measure 3 with explanation]
+- [Safety measure 4 with explanation]
+- [Safety measure 5 with explanation]
+
+**Bias Mitigation Strategies:**
+- [Bias mitigation 1 with explanation]
+- [Bias mitigation 2 with explanation]
+- [Bias mitigation 3 with explanation]
+
+**Security Enhancements:**
+- [Security enhancement 1 with explanation]
+- [Security enhancement 2 with explanation]
+- [Security enhancement 3 with explanation]
+
+**Technical Improvements:**
+- [Technical improvement 1 with explanation]
+- [Technical improvement 2 with explanation]
+- [Technical improvement 3 with explanation]
+
+### 📋 **Testing Recommendations**
+
+**Test Cases:**
+- [Test case 1 with expected outcome]
+- [Test case 2 with expected outcome]
+- [Test case 3 with expected outcome]
+- [Test case 4 with expected outcome]
+- [Test case 5 with expected outcome]
+
+**Edge Case Testing:**
+- [Edge case 1 with expected outcome]
+- [Edge case 2 with expected outcome]
+- [Edge case 3 with expected outcome]
+
+**Safety Testing:**
+- [Safety test 1 with expected outcome]
+- [Safety test 2 with expected outcome]
+- [Safety test 3 with expected outcome]
+
+**Bias Testing:**
+- [Bias test 1 with expected outcome]
+- [Bias test 2 with expected outcome]
+- [Bias test 3 with expected outcome]
+
+**Usage Guidelines:**
+- **Best For:** [Specific use cases]
+- **Avoid When:** [Situations to avoid]
+- **Considerations:** [Important factors to keep in mind]
+- **Limitations:** [Known limitations and constraints]
+- **Dependencies:** [Required context or prerequisites]
+
+### 🎓 **Educational Insights**
+
+**Prompt Engineering Principles Applied:**
+1. **Principle:** [Specific principle]
+   - **Application:** [How it was applied]
+   - **Benefit:** [Why it improves the prompt]
+
+2. **Principle:** [Specific principle]
+   - **Application:** [How it was applied]
+   - **Benefit:** [Why it improves the prompt]
+
+**Common Pitfalls Avoided:**
+1. **Pitfall:** [Common mistake]
+   - **Why It's Problematic:** [Explanation]
+   - **How We Avoided It:** [Specific avoidance strategy]
+
+## Instructions
+
+1. **Analyze the provided prompt** using all assessment criteria above
+2. **Provide detailed explanations** for each evaluation metric
+3. **Generate an improved version** that addresses all identified issues
+4. **Include specific safety measures** and bias mitigation strategies
+5. **Offer testing recommendations** to validate the improvements
+6. **Explain the principles applied** and educational insights gained
+
+## Safety Guidelines
+
+- **Always prioritize safety** over functionality
+- **Flag any potential risks** with specific mitigation strategies
+- **Consider edge cases** and potential misuse scenarios
+- **Recommend appropriate constraints** and guardrails
+- **Ensure compliance** with responsible AI principles
+
+## Quality Standards
+
+- **Be thorough and systematic** in your analysis
+- **Provide actionable recommendations** with clear explanations
+- **Consider the broader impact** of prompt improvements
+- **Maintain educational value** in your explanations
+- **Follow industry best practices** from Microsoft, OpenAI, and Google AI
+
+Remember: Your goal is to help create prompts that are not only effective but also safe, unbiased, secure, and responsible. Every improvement should enhance both functionality and safety.

package/skills/ai-prompt-engineering-safety-review/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/ai-prompt-engineering-safety-review`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/appinsights-instrumentation/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/appinsights-instrumentation/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright 2025 (c) Microsoft Corporation.
+
+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/appinsights-instrumentation/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: appinsights-instrumentation
+description: 'Instrument a webapp to send useful telemetry data to Azure App Insights'
+---
+
+# AppInsights instrumentation
+
+This skill enables sending telemetry data of a webapp to Azure App Insights for better observability of the app's health.
+
+## When to use this skill
+
+Use this skill when the user wants to enable telemetry for their webapp.
+
+## Prerequisites
+
+The app in the workspace must be one of these kinds
+
+- An ASP.NET Core app hosted in Azure
+- A Node.js app hosted in Azure
+
+## Guidelines
+
+### Collect context information
+
+Find out the (programming language, application framework, hosting) tuple of the application the user is trying to add telemetry support in. This determines how the application can be instrumented. Read the source code to make an educated guess. Confirm with the user on anything you don't know. You must always ask the user where the application is hosted (e.g. on a personal computer, in an Azure App Service as code, in an Azure App Service as container, in an Azure Container App, etc.). 
+
+### Prefer auto-instrument if possible
+
+If the app is a C# ASP.NET Core app hosted in Azure App Service, use [AUTO guide](references/AUTO.md) to help user auto-instrument the app.
+
+### Manually instrument
+
+Manually instrument the app by creating the AppInsights resource and update the app's code. 
+
+#### Create AppInsights resource
+
+Use one of the following options that fits the environment.
+
+- Add AppInsights to existing Bicep template. See [examples/appinsights.bicep](examples/appinsights.bicep) for what to add. This is the best option if there are existing Bicep template files in the workspace.
+- Use Azure CLI. See [scripts/appinsights.ps1](scripts/appinsights.ps1) for what Azure CLI command to execute to create the App Insights resource.
+
+No matter which option you choose, recommend the user to create the App Insights resource in a meaningful resource group that makes managing resources easier. A good candidate will be the same resource group that contains the resources for the hosted app in Azure.
+
+#### Modify application code
+
+- If the app is an ASP.NET Core app, see [ASPNETCORE guide](references/ASPNETCORE.md) for how to modify the C# code.
+- If the app is a Node.js app, see [NODEJS guide](references/NODEJS.md) for how to modify the JavaScript/TypeScript code.
+- If the app is a Python app, see [PYTHON guide](references/PYTHON.md) for how to modify the Python code.

package/skills/appinsights-instrumentation/SYNC.md

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

package/skills/appinsights-instrumentation/examples/appinsights.bicep

@@ -0,0 +1,30 @@
+@description('Location for all resources')
+param location string = resourceGroup().location
+
+@description('Name for new Application Insights')
+param name string
+
+// Create Log Analytics Workspace
+resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2022-10-01' = {
+  name: '${name}-workspace'
+  location: location
+  properties: {
+    sku: {
+      name: 'PerGB2018'
+    }
+    retentionInDays: 30
+  }
+}
+
+// Create Application Insights
+resource applicationInsights 'Microsoft.Insights/components@2020-02-02' = {
+  name: name
+  location: location
+  kind: 'web'
+  properties: {
+    Application_Type: 'web'
+    WorkspaceResourceId: logAnalyticsWorkspace.id
+  }
+}
+
+output connectionString string = applicationInsights.properties.ConnectionString

package/skills/appinsights-instrumentation/references/ASPNETCORE.md

@@ -0,0 +1,29 @@
+## Modify code
+
+Make these necessary changes to the app.
+
+- Install client library
+```
+dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore
+```
+
+- Configure the app to use Azure Monitor
+An ASP.NET Core app typically has a Program.cs file that "builds" the app. Find this file and apply these changes.
+  - Add `using Azure.Monitor.OpenTelemetry.AspNetCore;` at the top
+  - Before calling `builder.Build()`, add this line `builder.Services.AddOpenTelemetry().UseAzureMonitor();`.
+
+> Note: since we modified the code of the app, the app needs to be deployed to take effect.
+
+## Configure App Insights connection string
+
+The App Insights resource has a connection string. Add the connection string as an environment variable of the running app. You can use Azure CLI to query the connection string of the App Insights resource. See [scripts/appinsights.ps1](scripts/appinsights.ps1) for what Azure CLI command to execute for querying the connection string.
+
+After getting the connection string, set this environment variable with its value.
+
+```
+"APPLICATIONINSIGHTS_CONNECTION_STRING={your_application_insights_connection_string}"
+```
+
+If the app has IaC template such as Bicep or terraform files representing its cloud instance, this environment variable should be added to the IaC template to be applied in each deployment. Otherwise, use Azure CLI to manually apply the environment variable to the cloud instance of the app. See [scripts/appinsights.ps1](scripts/appinsights.ps1) for what Azure CLI command to execute for setting this environment variable.
+
+> Important: Don't modify appsettings.json. It was a deprecated way to configure App Insights. The environment variable is the new recommended way.

package/skills/appinsights-instrumentation/references/AUTO.md

@@ -0,0 +1,13 @@
+# Auto-instrument app
+
+Use Azure Portal to auto-instrument a webapp hosted in Azure App Service for App Insights without making any code changes. Only the following types of app can be auto-instrumented. See [supported environments and resource providers](https://learn.microsoft.com/azure/azure-monitor/app/codeless-overview#supported-environments-languages-and-resource-providers).
+
+- ASP.NET Core app hosted in Azure App Service
+- Node.js app hosted in Azure App Service
+
+Construct a url to bring the user to the Application Insights blade in Azure Portal for the App Service App.
+```
+https://portal.azure.com/#resource/subscriptions/{subscription_id}/resourceGroups/{resource_group_name}/providers/Microsoft.Web/sites/{app_service_name}/monitoringSettings
+```
+
+Use the context or ask the user to get the subscription_id, resource_group_name, and the app_service_name hosting the webapp.

package/skills/appinsights-instrumentation/references/NODEJS.md

@@ -0,0 +1,28 @@
+## Modify code
+
+Make these necessary changes to the app.
+
+- Install client library
+```
+npm install @azure/monitor-opentelemetry
+```
+
+- Configure the app to use Azure Monitor
+A Node.js app typically has an entry file that is listed as the "main" property in package.json. Find this file and apply these changes in it.
+  - Require the client library at the top. `const { useAzureMonitor } = require("@azure/monitor-opentelemetry");`
+  - Call the setup method. `useAzureMonitor();`
+
+> Note: The setup method should be called as early as possible but it must be after the environment variables are configured since it needs the App Insights connection string from the environment variable. For example, if the app uses dotenv to load environment variables, the setup method should be called after it but before anything else.
+> Note: since we modified the code of the app, it needs to be deployed to take effect.
+
+## Configure App Insights connection string
+
+The App Insights resource has a connection string. Add the connection string as an environment variable of the running app. You can use Azure CLI to query the connection string of the App Insights resource. See [scripts/appinsights.ps1] for what Azure CLI command to execute for querying the connection string.
+
+After getting the connection string, set this environment variable with its value.
+
+```
+"APPLICATIONINSIGHTS_CONNECTION_STRING={your_application_insights_connection_string}"
+```
+
+If the app has IaC template such as Bicep or terraform files representing its cloud instance, this environment variable should be added to the IaC template to be applied in each deployment. Otherwise, use Azure CLI to manually apply the environment variable to the cloud instance of the app. See what Azure CLI command to execute for setting this environment variable.