Azure/azure-functions-skills

Perfil de Azure

Última actividad de origen registrada: 30 de septiembre de 2026 a las 23:04

Catálogo de SkillsMP actualizado: 17 de octubre de 2026 a las 00:09

skills recopiladas: 27

Estrellas en GitHub: 18
Forks en GitHub: 10

README del repositorio

Archivo de origen del README: README.md

Leer el README original

Mostrar README completo

# Azure Functions Skills [![npm](https://img.shields.io/npm/v/@azure/functions-skills)](https://www.npmjs.com/package/@azure/functions-skills) **Azure Functions context for your coding agent.** The plugin provides skills, Azure MCP configuration, and telemetry hooks for GitHub Copilot, Claude Code, and Codex. ## What & why Azure Functions Skills equips your coding agent with Functions-specific knowledge — trigger/binding patterns, language anti-patterns, runtime versions, deployment best practices — so the agent gives accurate guidance instead of generic advice. It is **focused on Azure Functions**. For deployment of *any* Azure resource (Functions or otherwise), it delegates to [Azure Skills](https://github.com/microsoft/azure-skills) via the `azure-functions-deploy` skill. The two packages complement each other — see [docs/skills-vs-azure-skills.md](docs/skills-vs-azure-skills.md) for the role split. ## Prerequisites **Node.js 20+** is necessary for the companion CLI. Everything else (Azure CLI, Core Tools, language runtimes) is checked and guided by the `azure-functions-setup` skill when environment verification is needed. ## Quick Start ### 1. Install the plugin with your coding agent Choose your coding agent and follow its install steps: #### GitHub Copilot CLI Start an interactive Copilot session with `copilot`, then run: ```text /plugin marketplace add Azure/azure-functions-skills /plugin install azure-functions-skills@azure-functions-skills ``` #### GitHub Copilot app 1. Open **Settings** (the gear icon), then select **Plugins**. 2. Select **Install** to open the plugin installer, then add `Azure/azure-functions-skills` as a marketplace. 3. Select **azure-functions-skills**, review its contents, and confirm the installation. #### GitHub Copilot in VS Code (Preview) 1. Enable the `chat.plugins.enabled` setting. Your organization may manage this setting. 2. Add this marketplace to your user `settings.json`: ```json { "chat.plugins.marketplaces": [ "Azure/azure-functions-skills" ] } ``` 3. Open the Extensions view (`Ctrl+Shift+X` or `Cmd+Shift+X`), search for `@agentPlugins`, and install **azure-functions-skills**. VS Code also discovers plugins installed by GitHub Copilot CLI. See [Agent plugins in VS Code](https://code.visualstudio.com/docs/agent-customization/agent-plugins) for more options. #### Claude Code Start an interactive Claude Code session with `claude`, then run: ```text /plugin marketplace add Azure/azure-functions-skills /plugin install azure-functions-skills@azure-functions-skills ``` #### Codex CLI Add this repository as a plugin marketplace from your terminal: ```bash codex plugin marketplace add Azure/azure-functions-skills ``` Then start Codex, run `/plugins`, select **azure-functions-skills**, and choose **Install plugin**. > The [`@azure/functions-skills`](https://www.npmjs.com/package/@azure/functions-skills) npm package provides the companion CLI and the telemetry sender. Installing it does not install or launch a coding-agent plugin. ### 2. Verify your prerequisites Ask your coding agent to run the `azure-functions-setup` skill. It checks the required Azure Functions tools and language runtimes, then guides you through installing or configuring anything that is missing. ### 3. Ask for Azure Functions help Ask which Azure Functions workflow to use. `azure-functions-help` discovers the installed `azure-functions-*` skills and routes to the best match. > **More options?** See [CLI Reference](docs/cli-reference.md) for every command, flag, and headless example. ## Companion CLI The npm package includes a small CLI to list and apply Azure Functions templates: ```bash npx @azure/functions-skills template list --language typescript npx @azure/functions-skills template apply --template <id> --dir ./my-app ``` ## Telemetry **Automatic plugin telemetry is temporarily disabled.** The hooks return `{"continue":true}` without reading events, downloading packages, or sending data. The deployment skills do not run the deployment-observation collector or its ARM queries. This does not change normal skill use, deployment, or Application Insights monitoring in deployed applications. Update installed plugins and previously applied workspace assets to receive this change. Existing copies do not update when this source changes. The telemetry library and CLI commands remain available for explicit use. The following sections describe those retained features, not automatic collection in this release. Usage events accept allowlisted skill/tool names, relative allowlisted Azure Functions skill-file paths, client name, session id, and timestamp. They do not include file contents, prompts, raw tool arguments, credentials, or absolute paths. The sender uses the Azure Functions team's Application Insights resource, not Azure MCP. ### Deployment observation event The retained collector supports an `azure_deployment_observed` event for a successful `azd up` or standalone `azd provision`. The deployment skills do not invoke it while automatic telemetry is disabled. It carries only seven categorical properties: `skill`, `operation` (`deploy` or `provision`), `result` (constant `success`), `resourceTypes` (a sorted, de-duplicated list of Microsoft resource-provider types such as `microsoft.web/sites`), `deploymentKind` (`function-app` or `hosted-agent`), `agent` (normalized client, or `unknown`), and `skillsVersion` (or `unknown`). The mechanism only *observes* a successful deployment; it cannot prove a skill caused it. To confirm success and derive the resource-type breakdown, the collector reads the named Azure Resource Manager deployment's state using your existing Azure CLI sign-in. The azd environment name (which is the deployment name), subscription, resource group, and deployment IDs are sent to Azure Resource Manager only to perform that lookup. They are not included in the telemetry event and are not printed. The event contains no customer names, identifiers, secrets, paths, environment values, or correlation IDs. The same opt-out mechanisms apply unchanged (see below); when telemetry is disabled the collector performs no ARM queries and sends nothing. This is an adoption/observation trend, not exact accounting. Phase 1 limitations are intentional and disclosed: - The collector looks up the subscription-scope ARM deployment by the environment name and validates it against a bounded 30-minute recency window. The environment name is required for a usable observation, but a missing or invalid name is a valid skip, not an input error: the collector returns `skipped` before any Azure query. A deployment older than the window or a resource-group-scope deployment also records nothing. Selecting by name makes cross-deployment misattribution unlikely, but re-running after another deployment that reuses the same environment name still refers to the newest deployment of that name. - Duplicate collector calls are possible; there is no exactly-once delivery, no durable de-duplication, and no exact funnel or conversion rate. - The retained collector supports only the two canonical skills' `azd`/Bicep paths. Automatic collection is disabled. Application telemetry content is categorical, but HTTPS necessarily exposes the client's network address to the receiving service. This does not promise anonymous transport; the receiving Application Insights service's privacy policy and IP handling apply. To opt out, set either `AZURE_FUNCTIONS_SKILLS_COLLECT_TELEMETRY=false` or `AZURE_MCP_COLLECT_TELEMETRY=false` in the environment. ## Skills For contributor guidance on the product boundary between Azure Skills and Azure Functions Skills, see [Azure Skills and Azure Functions Skills Boundary](docs/azure-skills-boundary.md). | Skill | Purpose | | --- | --- | | [`azure-functions-help`](templates/skills/azure-functions-help/SKILL.md) | Discover and route to the best Azure Functions skill | | [`azure-functions-setup`](templates/skills/azure-functions-setup/SKILL.md) | Verify local prerequisites (Azure CLI, Core Tools, runtimes, Azure Skills) | | [`azure-functions-create`](templates/skills/azure-functions-create/SKILL.md) | Create new Functions projects or add functions via Azure MCP templates | | [`azure-functions-hosted-skills`](templates/skills/azure-functions-hosted-skills/SKILL.md) | Build cloud-hosted, event-driven intelligent capabilities with Markdown, Functions triggers, code, tools, HTTP, and MCP | | [`azure-functions-connector-create`](templates/skills/azure-functions-connector-create/SKILL.md) | Create and authorize least-privilege Connector Namespace connections for Hosted Skills | | [`azure-functions-connector-mcp`](templates/skills/azure-functions-connector-mcp/SKILL.md) | Generate and register connector MCP tools from authoritative operation metadata | | [`azure-functions-connector-validate`](templates/skills/azure-functions-connector-validate/SKILL.md) | Validate connector identity, MCP contracts, side effects, and Hosted Skill integration | | [`azure-functions-deploy`](templates/skills/azure-functions-deploy/SKILL.md) | Prepare, validate, and deploy via Azure Skills with Functions-specific guidance | | [`azure-functions-best-practices`](templates/skills/azure-functions-best-practices/SKILL.md) | Production-readiness review (config, security, reliability) | | [`azure-functions-diagnostics`](templates/skills/azure-functions-diagnostics/SKILL.md) | Investigate deployment, runtime, trigger, binding, logging issues | | [`azure-functions-health-status`](templates/skills/azure-functions-health-status/SKILL.md) | Collect current health, metrics, logs, Resource Health, Activity Log | | [`azure-functions-inventory`](templates/skills/azure-functions-inventory/SKILL.md) | Collect app specification and configuration inventory | | [`azure-functions-doctor`](templates/skills/azure-functions-doctor/SKILL.md) | Pre-deployment check of local code, configuration, and supply-chain risks | | [`azure-functions-common`](templates/skills/azure-functions-common/SKILL.md) | Shared language, trigger, binding, extension, routing references | | [`azure-functions-feedback`](templates/skills/azure-functions-feedback/SKILL.md) | Turn session findings into previewed issues or pull requests | The `azure-functions-help` skill provides the discovery and routing entry point. ## Contributing We welcome contributions. To add or improve a skill, edit the files under [`templates/skills/`](templates/skills/), then run `npm run build:plugin-payload` to regenerate the published plugin payload. The release process delivers the skill to all supported coding agents. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide. ## Security Report vulnerabilities to [secure@microsoft.com](mailto:secure@microsoft.com). See [SECURITY.md](SECURITY.md) for the threat model and our defense layers. ## License [MIT](LICENSE)

Cargando el README del repositorio…

Skills en este repositorio

Desarrolladores de software Administradores de redes y sistemas informáticos

2 categorías ocupacionales · 59% clasificado

skill

ocupación

descripción

actualizado