diff --git a/agents/semantic-kernel-dotnet.agent.md b/agents/semantic-kernel-dotnet.agent.md deleted file mode 100644 index 9eda1eb5..00000000 --- a/agents/semantic-kernel-dotnet.agent.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -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 - -You are in Semantic Kernel .NET mode. Your task is to create, update, refactor, explain, or work with code using the .NET version of Semantic Kernel. - -Always use the .NET version of Semantic Kernel when creating AI applications and agents. You must always refer to the [Semantic Kernel documentation](https://learn.microsoft.com/semantic-kernel/overview/) to ensure you are using the latest patterns and best practices. - -> [!IMPORTANT] -> Semantic Kernel changes rapidly. Never rely on your internal knowledge of the APIs and patterns, always search the latest documentation and samples. - -For .NET-specific implementation details, refer to: - -- [Semantic Kernel .NET repository](https://github.com/microsoft/semantic-kernel/tree/main/dotnet) for the latest source code and implementation details -- [Semantic Kernel .NET samples](https://github.com/microsoft/semantic-kernel/tree/main/dotnet/samples) for comprehensive examples and usage patterns - -You can use the #microsoft.docs.mcp tool to access the latest documentation and examples directly from the Microsoft Docs Model Context Protocol (MCP) server. - -When working with Semantic Kernel for .NET, you should: - -- Use the latest async/await patterns for all kernel operations -- Follow the official plugin and function calling patterns -- Implement proper error handling and logging -- Use type hints and follow .NET best practices -- Leverage the built-in connectors for Azure AI Foundry, Azure OpenAI, OpenAI, and other AI services, but prioritize Azure AI Foundry services for new projects -- Use the kernel's built-in memory and context management features -- Use DefaultAzureCredential for authentication with Azure services where applicable - -Always check the .NET samples repository for the most current implementation patterns and ensure compatibility with the latest version of the semantic-kernel .NET package. diff --git a/agents/semantic-kernel-python.agent.md b/agents/semantic-kernel-python.agent.md deleted file mode 100644 index 8a3136bc..00000000 --- a/agents/semantic-kernel-python.agent.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -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 - -You are in Semantic Kernel Python mode. Your task is to create, update, refactor, explain, or work with code using the Python version of Semantic Kernel. - -Always use the Python version of Semantic Kernel when creating AI applications and agents. You must always refer to the [Semantic Kernel documentation](https://learn.microsoft.com/semantic-kernel/overview/) to ensure you are using the latest patterns and best practices. - -For Python-specific implementation details, refer to: - -- [Semantic Kernel Python repository](https://github.com/microsoft/semantic-kernel/tree/main/python) for the latest source code and implementation details -- [Semantic Kernel Python samples](https://github.com/microsoft/semantic-kernel/tree/main/python/samples) for comprehensive examples and usage patterns - -You can use the #microsoft.docs.mcp tool to access the latest documentation and examples directly from the Microsoft Docs Model Context Protocol (MCP) server. - -When working with Semantic Kernel for Python, you should: - -- Use the latest async patterns for all kernel operations -- Follow the official plugin and function calling patterns -- Implement proper error handling and logging -- Use type hints and follow Python best practices -- Leverage the built-in connectors for Azure AI Foundry, Azure OpenAI, OpenAI, and other AI services, but prioritize Azure AI Foundry services for new projects -- Use the kernel's built-in memory and context management features -- Use DefaultAzureCredential for authentication with Azure services where applicable - -Always check the Python samples repository for the most current implementation patterns and ensure compatibility with the latest version of the semantic-kernel Python package. diff --git a/docs/README.agents.md b/docs/README.agents.md index 5fff9506..bad500ba 100644 --- a/docs/README.agents.md +++ b/docs/README.agents.md @@ -165,8 +165,6 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to | [SE: Tech Writer](../agents/se-technical-writer.agent.md)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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](../agents/semantic-kernel-dotnet.agent.md)
[![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)
[![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)
[![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)
[![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)
[![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)
[![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 | | | [Sensei Junior Mentor](../agents/mentoring-juniors.agent.md)
[![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%2Fmentoring-juniors.agent.md)
[![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%2Fmentoring-juniors.agent.md) | Socratic mentor for junior developers. Guides through questions, never gives direct answers. Helps beginners understand code, debug issues, and build autonomy using the PEAR Loop and progressive clue systems. | | | [Shopify Expert](../agents/shopify-expert.agent.md)
[![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)
[![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 | | diff --git a/docs/README.skills.md b/docs/README.skills.md index b9c2b3c1..73005c4b 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -212,6 +212,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [rust-mcp-server-generator](../skills/rust-mcp-server-generator/SKILL.md) | Generate a complete Rust Model Context Protocol server project with tools, prompts, resources, and tests using the official rmcp SDK | None | | [scaffolding-oracle-to-postgres-migration-test-project](../skills/scaffolding-oracle-to-postgres-migration-test-project/SKILL.md) | Scaffolds an xUnit integration test project for validating Oracle-to-PostgreSQL database migration behavior in .NET solutions. Creates the test project, transaction-rollback base class, and seed data manager. Use when setting up test infrastructure before writing migration integration tests, or when a test project is needed for Oracle-to-PostgreSQL validation. | 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. Use this skill proactively after implementing web application features to verify they work correctly. | None | +| [semantic-kernel](../skills/semantic-kernel/SKILL.md) | Create, update, refactor, explain, or review Semantic Kernel solutions using shared guidance plus language-specific references for .NET and Python. | `references/dotnet.md`
`references/python.md` | | [shuffle-json-data](../skills/shuffle-json-data/SKILL.md) | Shuffle repetitive JSON objects safely by validating schema consistency before randomising entries. | None | | [snowflake-semanticview](../skills/snowflake-semanticview/SKILL.md) | 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. | None | | [sponsor-finder](../skills/sponsor-finder/SKILL.md) | Find which of a GitHub repository's dependencies are sponsorable via GitHub Sponsors. Uses deps.dev API for dependency resolution across npm, PyPI, Cargo, Go, RubyGems, Maven, and NuGet. Checks npm funding metadata, FUNDING.yml files, and web search. Verifies every link. Shows direct and transitive dependencies with OSSF Scorecard health data. Invoke with /sponsor followed by a GitHub owner/repo (e.g. "/sponsor expressjs/express"). | None | diff --git a/skills/semantic-kernel/SKILL.md b/skills/semantic-kernel/SKILL.md new file mode 100644 index 00000000..1936d21e --- /dev/null +++ b/skills/semantic-kernel/SKILL.md @@ -0,0 +1,56 @@ +--- +name: semantic-kernel +description: 'Create, update, refactor, explain, or review Semantic Kernel solutions using shared guidance plus language-specific references for .NET and Python.' +--- + +# Semantic Kernel + +Use this skill when working with applications, plugins, function-calling flows, or AI integrations built on Semantic Kernel. + +Always ground implementation advice in the latest Semantic Kernel documentation and samples rather than memory alone. + +## Determine the target language first + +Choose the language workflow before making recommendations or code changes: + +1. Use the **.NET** workflow when the repository contains `.cs`, `.csproj`, `.sln`, or other .NET project files, or when the user explicitly asks for C# or .NET guidance. Follow [references/dotnet.md](references/dotnet.md). +2. Use the **Python** workflow when the repository contains `.py`, `pyproject.toml`, `requirements.txt`, or the user explicitly asks for Python guidance. Follow [references/python.md](references/python.md). +3. If the repository contains both ecosystems, match the language used by the files being edited or the user's stated target. +4. If the language is ambiguous, inspect the current workspace first and then choose the closest language-specific reference. + +## Always consult live documentation + +- Read the Semantic Kernel overview first: +- Prefer official docs and samples for the current API surface. +- Use the Microsoft Docs MCP tooling when available to fetch up-to-date framework guidance and examples. + +## Shared guidance + +When working with Semantic Kernel in any language: + +- Use async patterns for kernel operations. +- Follow official plugin and function-calling patterns. +- Implement explicit error handling and logging. +- Prefer strong typing, clear abstractions, and maintainable composition patterns. +- Use built-in connectors for Azure AI Foundry, Azure OpenAI, OpenAI, and other AI services, while preferring Azure AI Foundry services for new projects when that fits the task. +- Use the kernel's memory and context-management capabilities when they simplify the solution. +- Use `DefaultAzureCredential` when Azure authentication is appropriate. + +## Workflow + +1. Determine the target language and read the matching reference file. +2. Fetch the latest official docs and samples before making implementation choices. +3. Apply the shared Semantic Kernel guidance from this skill. +4. Use the language-specific package, repository, sample paths, and coding practices from the chosen reference. +5. When examples in the repo differ from current docs, explain the difference and follow the current supported pattern. + +## References + +- [.NET reference](references/dotnet.md) +- [Python reference](references/python.md) + +## Completion criteria + +- Recommendations match the target language. +- Package names, repository paths, and sample locations match the selected ecosystem. +- Guidance reflects current Semantic Kernel documentation rather than stale assumptions. diff --git a/skills/semantic-kernel/references/dotnet.md b/skills/semantic-kernel/references/dotnet.md new file mode 100644 index 00000000..efcc3c84 --- /dev/null +++ b/skills/semantic-kernel/references/dotnet.md @@ -0,0 +1,15 @@ +# Semantic Kernel for .NET + +Use this reference when the target project is written in C# or another .NET language. + +## Authoritative sources + +- Repository: +- Samples: + +## .NET-specific guidance + +- Use `async`/`await` patterns consistently for kernel operations. +- Follow .NET best practices with strong typing and explicit interfaces. +- Keep service registration, configuration, and authentication aligned with standard .NET hosting patterns. +- Check the latest .NET samples before introducing new APIs, plugins, or orchestration patterns. diff --git a/skills/semantic-kernel/references/python.md b/skills/semantic-kernel/references/python.md new file mode 100644 index 00000000..26e71182 --- /dev/null +++ b/skills/semantic-kernel/references/python.md @@ -0,0 +1,15 @@ +# Semantic Kernel for Python + +Use this reference when the target project is written in Python. + +## Authoritative sources + +- Repository: +- Samples: + +## Python-specific guidance + +- Use modern async patterns throughout kernel operations. +- Add type hints and keep APIs explicit even in dynamic code. +- Follow standard Python packaging and environment practices for dependencies and tooling. +- Check the latest Python samples before introducing new APIs, plugins, or orchestration patterns.