feat(skills): add commit-message-storyteller skill

docs/README.skills.md

@@ -77,6 +77,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to
 | [code-tour](../skills/code-tour/SKILL.md) | Use this skill to create CodeTour .tour files — persona-targeted, step-by-step walkthroughs that link to real files and line numbers. Trigger for: "create a tour", "make a code tour", "generate a tour", "onboarding tour", "tour for this PR", "tour for this bug", "RCA tour", "architecture tour", "explain how X works", "vibe check", "PR review tour", "contributor guide", "help someone ramp up", or any request for a structured walkthrough through code. Supports 20 developer personas (new joiner, bug fixer, architect, PR reviewer, vibecoder, security reviewer, and more), all CodeTour step types (file/line, selection, pattern, uri, commands, view), and tour-level fields (ref, isPrimary, nextTour). Works with any repository in any language. | `references/codetour-schema.json`<br />`references/examples.md`<br />`scripts/generate_from_docs.py`<br />`scripts/validate_tour.py` |
 | [codeql](../skills/codeql/SKILL.md) | Comprehensive guide for setting up and configuring CodeQL code scanning via GitHub Actions workflows and the CodeQL CLI. This skill should be used when users need help with code scanning configuration, CodeQL workflow files, CodeQL CLI commands, SARIF output, security analysis setup, or troubleshooting CodeQL analysis. | `references/alert-management.md`<br />`references/cli-commands.md`<br />`references/compiled-languages.md`<br />`references/sarif-output.md`<br />`references/troubleshooting.md`<br />`references/workflow-configuration.md` |
 | [comment-code-generate-a-tutorial](../skills/comment-code-generate-a-tutorial/SKILL.md) | Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial. | None |
+| [commit-message-storyteller](../skills/commit-message-storyteller/SKILL.md) | Analyzes git diffs or staged changes and generates narrative commit messages that explain WHY a change was made, not just what changed — following Conventional Commits format. Use when asked to "write a commit message", "generate a commit", "describe my changes", "what should I commit this as", "commit this", "summarize my diff", or "help me commit". Works with git diff output, staged files, or plain descriptions of changes. | `conventional-commits-guide.md` |
 | [containerize-aspnet-framework](../skills/containerize-aspnet-framework/SKILL.md) | Containerize an ASP.NET .NET Framework project by creating Dockerfile and .dockerfile files customized for the project. | None |
 | [containerize-aspnetcore](../skills/containerize-aspnetcore/SKILL.md) | Containerize an ASP.NET Core project by creating Dockerfile and .dockerfile files customized for the project. | None |
 | [context-map](../skills/context-map/SKILL.md) | Generate a map of all files relevant to a task before making changes | None |

plugins/awesome-copilot/.github/plugin/plugin.json

@@ -18,8 +18,8 @@
     "./agents/meta-agentic-project-scaffold.md"
   ],
   "skills": [
-    "./skills/suggest-awesome-github-copilot-skills/",
+    "./skills/suggest-awesome-github-copilot-agents/",
     "./skills/suggest-awesome-github-copilot-instructions/",
-    "./skills/suggest-awesome-github-copilot-agents/"
+    "./skills/suggest-awesome-github-copilot-skills/"
   ]
 }

plugins/azure-cloud-development/.github/plugin/plugin.json

@@ -18,18 +18,18 @@
     "devops"
   ],
   "agents": [
+    "./agents/azure-logic-apps-expert.md",
     "./agents/azure-principal-architect.md",
     "./agents/azure-saas-architect.md",
-    "./agents/azure-logic-apps-expert.md",
     "./agents/azure-verified-modules-bicep.md",
     "./agents/azure-verified-modules-terraform.md",
-    "./agents/terraform-azure-planning.md",
-    "./agents/terraform-azure-implement.md"
+    "./agents/terraform-azure-implement.md",
+    "./agents/terraform-azure-planning.md"
   ],
   "skills": [
-    "./skills/azure-resource-health-diagnose/",
     "./skills/az-cost-optimize/",
-    "./skills/import-infrastructure-as-code/",
-    "./skills/azure-pricing/"
+    "./skills/azure-pricing/",
+    "./skills/azure-resource-health-diagnose/",
+    "./skills/import-infrastructure-as-code/"
   ]
 }

plugins/cast-imaging/.github/plugin/plugin.json

@@ -16,8 +16,8 @@
     "devops"
   ],
   "agents": [
-    "./agents/cast-imaging-software-discovery.md",
     "./agents/cast-imaging-impact-analysis.md",
+    "./agents/cast-imaging-software-discovery.md",
     "./agents/cast-imaging-structural-quality-advisor.md"
   ]
 }

plugins/context-engineering/.github/plugin/plugin.json

@@ -19,7 +19,7 @@
   ],
   "skills": [
     "./skills/context-map/",
-    "./skills/what-context-needed/",
-    "./skills/refactor-plan/"
+    "./skills/refactor-plan/",
+    "./skills/what-context-needed/"
   ]
 }

plugins/csharp-dotnet-development/.github/plugin/plugin.json

@@ -17,12 +17,12 @@
     "./agents/expert-dotnet-software-engineer.md"
   ],
   "skills": [
-    "./skills/csharp-async/",
     "./skills/aspnet-minimal-api-openapi/",
-    "./skills/csharp-xunit/",
-    "./skills/csharp-nunit/",
+    "./skills/csharp-async/",
     "./skills/csharp-mstest/",
+    "./skills/csharp-nunit/",
     "./skills/csharp-tunit/",
+    "./skills/csharp-xunit/",
     "./skills/dotnet-best-practices/",
     "./skills/dotnet-upgrade/"
   ]

plugins/database-data-management/.github/plugin/plugin.json

@@ -18,13 +18,13 @@
     "data-management"
   ],
   "agents": [
-    "./agents/postgresql-dba.md",
-    "./agents/ms-sql-dba.md"
+    "./agents/ms-sql-dba.md",
+    "./agents/postgresql-dba.md"
   ],
   "skills": [
-    "./skills/sql-optimization/",
-    "./skills/sql-code-review/",
+    "./skills/postgresql-code-review/",
     "./skills/postgresql-optimization/",
-    "./skills/postgresql-code-review/"
+    "./skills/sql-code-review/",
+    "./skills/sql-optimization/"
   ]
 }

plugins/dataverse-sdk-for-python/.github/plugin/plugin.json

@@ -14,9 +14,9 @@
     "sdk"
   ],
   "skills": [
-    "./skills/dataverse-python-quickstart/",
     "./skills/dataverse-python-advanced-patterns/",
     "./skills/dataverse-python-production-code/",
+    "./skills/dataverse-python-quickstart/",
     "./skills/dataverse-python-usecase-builder/"
   ]
 }

plugins/edge-ai-tasks/.github/plugin/plugin.json

@@ -15,7 +15,7 @@
     "implementation"
   ],
   "agents": [
-    "./agents/task-researcher.md",
-    "./agents/task-planner.md"
+    "./agents/task-planner.md",
+    "./agents/task-researcher.md"
   ]
 }

plugins/flowstudio-power-automate/.github/plugin/plugin.json

@@ -19,10 +19,10 @@
     "governance"
   ],
   "skills": [
-    "./skills/flowstudio-power-automate-mcp/",
-    "./skills/flowstudio-power-automate-debug/",
     "./skills/flowstudio-power-automate-build/",
-    "./skills/flowstudio-power-automate-monitoring/",
-    "./skills/flowstudio-power-automate-governance/"
+    "./skills/flowstudio-power-automate-debug/",
+    "./skills/flowstudio-power-automate-governance/",
+    "./skills/flowstudio-power-automate-mcp/",
+    "./skills/flowstudio-power-automate-monitoring/"
   ]
 }

plugins/frontend-web-dev/.github/plugin/plugin.json

@@ -19,8 +19,8 @@
     "vue"
   ],
   "agents": [
-    "./agents/expert-react-frontend-engineer.md",
-    "./agents/electron-angular-native.md"
+    "./agents/electron-angular-native.md",
+    "./agents/expert-react-frontend-engineer.md"
   ],
   "skills": [
     "./skills/playwright-explore-website/",

plugins/gem-team/.github/plugin/plugin.json

@@ -1,20 +1,20 @@
 {
   "agents": [
-    "./agents/gem-orchestrator.md",
-    "./agents/gem-researcher.md",
-    "./agents/gem-planner.md",
-    "./agents/gem-implementer.md",
     "./agents/gem-browser-tester.md",
-    "./agents/gem-devops.md",
-    "./agents/gem-reviewer.md",
-    "./agents/gem-documentation-writer.md",
-    "./agents/gem-debugger.md",
-    "./agents/gem-critic.md",
     "./agents/gem-code-simplifier.md",
+    "./agents/gem-critic.md",
+    "./agents/gem-debugger.md",
+    "./agents/gem-designer-mobile.md",
     "./agents/gem-designer.md",
+    "./agents/gem-devops.md",
+    "./agents/gem-documentation-writer.md",
     "./agents/gem-implementer-mobile.md",
-    "./agents/gem-designer-mobile.md",
-    "./agents/gem-mobile-tester.md"
+    "./agents/gem-implementer.md",
+    "./agents/gem-mobile-tester.md",
+    "./agents/gem-orchestrator.md",
+    "./agents/gem-planner.md",
+    "./agents/gem-researcher.md",
+    "./agents/gem-reviewer.md"
   ],
   "author": {
     "name": "Awesome Copilot Community"

plugins/java-development/.github/plugin/plugin.json

@@ -16,9 +16,9 @@
     "javadoc"
   ],
   "skills": [
+    "./skills/create-spring-boot-java-project/",
     "./skills/java-docs/",
     "./skills/java-junit/",
-    "./skills/java-springboot/",
-    "./skills/create-spring-boot-java-project/"
+    "./skills/java-springboot/"
   ]
 }

plugins/mcp-m365-copilot/.github/plugin/plugin.json

@@ -19,8 +19,8 @@
     "./agents/mcp-m365-agent-expert.md"
   ],
   "skills": [
-    "./skills/mcp-create-declarative-agent/",
     "./skills/mcp-create-adaptive-cards/",
+    "./skills/mcp-create-declarative-agent/",
     "./skills/mcp-deploy-manage-agents/"
   ]
 }

plugins/partners/.github/plugin/plugin.json

@@ -23,6 +23,7 @@
     "./agents/amplitude-experiment-implementation.md",
     "./agents/apify-integration-expert.md",
     "./agents/arm-migration.md",
+    "./agents/comet-opik.md",
     "./agents/diffblue-cover.md",
     "./agents/droid.md",
     "./agents/dynatrace-expert.md",
@@ -36,9 +37,8 @@
     "./agents/neon-migration-specialist.md",
     "./agents/neon-optimization-analyzer.md",
     "./agents/octopus-deploy-release-notes-mcp.md",
-    "./agents/stackhawk-security-onboarding.md",
-    "./agents/terraform.md",
     "./agents/pagerduty-incident-responder.md",
-    "./agents/comet-opik.md"
+    "./agents/stackhawk-security-onboarding.md",
+    "./agents/terraform.md"
   ]
 }

plugins/polyglot-test-agent/.github/plugin/plugin.json

@@ -20,14 +20,14 @@
     "go"
   ],
   "agents": [
-    "./agents/polyglot-test-generator.md",
-    "./agents/polyglot-test-researcher.md",
-    "./agents/polyglot-test-planner.md",
-    "./agents/polyglot-test-implementer.md",
     "./agents/polyglot-test-builder.md",
-    "./agents/polyglot-test-tester.md",
     "./agents/polyglot-test-fixer.md",
-    "./agents/polyglot-test-linter.md"
+    "./agents/polyglot-test-generator.md",
+    "./agents/polyglot-test-implementer.md",
+    "./agents/polyglot-test-linter.md",
+    "./agents/polyglot-test-planner.md",
+    "./agents/polyglot-test-researcher.md",
+    "./agents/polyglot-test-tester.md"
   ],
   "skills": [
     "./skills/polyglot-test-agent/"

plugins/power-platform-architect/.github/plugin/plugin.json

@@ -16,5 +16,7 @@
   },
   "repository": "https://github.com/github/awesome-copilot",
   "license": "MIT",
-  "skills": ["./skills/power-platform-architect/"]
+  "skills": [
+    "./skills/power-platform-architect/"
+  ]
 }

plugins/power-platform-mcp-connector-development/.github/plugin/plugin.json

@@ -18,7 +18,7 @@
     "./agents/power-platform-mcp-integration-expert.md"
   ],
   "skills": [
-    "./skills/power-platform-mcp-connector-suite/",
-    "./skills/mcp-copilot-studio-server-generator/"
+    "./skills/mcp-copilot-studio-server-generator/",
+    "./skills/power-platform-mcp-connector-suite/"
   ]
 }

plugins/project-planning/.github/plugin/plugin.json

@@ -18,22 +18,22 @@
     "technical-spike"
   ],
   "agents": [
-    "./agents/task-planner.md",
-    "./agents/task-researcher.md",
-    "./agents/planner.md",
+    "./agents/implementation-plan.md",
     "./agents/plan.md",
+    "./agents/planner.md",
     "./agents/prd.md",
-    "./agents/implementation-plan.md",
-    "./agents/research-technical-spike.md"
+    "./agents/research-technical-spike.md",
+    "./agents/task-planner.md",
+    "./agents/task-researcher.md"
   ],
   "skills": [
-    "./skills/breakdown-feature-implementation/",
-    "./skills/breakdown-feature-prd/",
     "./skills/breakdown-epic-arch/",
     "./skills/breakdown-epic-pm/",
-    "./skills/create-implementation-plan/",
-    "./skills/update-implementation-plan/",
+    "./skills/breakdown-feature-implementation/",
+    "./skills/breakdown-feature-prd/",
     "./skills/create-github-issues-feature-from-implementation-plan/",
-    "./skills/create-technical-spike/"
+    "./skills/create-implementation-plan/",
+    "./skills/create-technical-spike/",
+    "./skills/update-implementation-plan/"
   ]
 }

plugins/react18-upgrade/.github/plugin/plugin.json

@@ -16,12 +16,12 @@
   },
   "repository": "https://github.com/github/awesome-copilot",
   "license": "MIT",
-   "agents": [
+  "agents": [
     "./agents/react18-auditor.md",
+    "./agents/react18-batching-fixer.md",
+    "./agents/react18-class-surgeon.md",
     "./agents/react18-commander.md",
     "./agents/react18-dep-surgeon.md",
-    "./agents/react18-class-surgeon.md",
-    "./agents/react18-batching-fixer.md",
     "./agents/react18-test-guardian.md"
   ],
   "skills": [

plugins/roundup/.github/plugin/plugin.json

@@ -18,7 +18,7 @@
     "copilot-cli"
   ],
   "skills": [
-    "./skills/roundup-setup/",
-    "./skills/roundup/"
+    "./skills/roundup/",
+    "./skills/roundup-setup/"
   ]
 }

plugins/rug-agentic-workflow/.github/plugin/plugin.json

@@ -15,8 +15,8 @@
     "qa"
   ],
   "agents": [
+    "./agents/qa-subagent.md",
     "./agents/rug-orchestrator.md",
-    "./agents/swe-subagent.md",
-    "./agents/qa-subagent.md"
+    "./agents/swe-subagent.md"
   ]
 }

plugins/salesforce-development/.github/plugin/plugin.json

@@ -26,7 +26,7 @@
   ],
   "skills": [
     "./skills/salesforce-apex-quality/",
-    "./skills/salesforce-flow-design/",
-    "./skills/salesforce-component-standards/"
+    "./skills/salesforce-component-standards/",
+    "./skills/salesforce-flow-design/"
   ]
 }

plugins/software-engineering-team/.github/plugin/plugin.json

@@ -18,12 +18,12 @@
     "ai-ethics"
   ],
   "agents": [
-    "./agents/se-ux-ui-designer.md",
-    "./agents/se-technical-writer.md",
     "./agents/se-gitops-ci-specialist.md",
     "./agents/se-product-manager-advisor.md",
     "./agents/se-responsible-ai-code.md",
+    "./agents/se-security-reviewer.md",
     "./agents/se-system-architecture-reviewer.md",
-    "./agents/se-security-reviewer.md"
+    "./agents/se-technical-writer.md",
+    "./agents/se-ux-ui-designer.md"
   ]
 }

plugins/testing-automation/.github/plugin/plugin.json

@@ -18,16 +18,16 @@
     "nunit"
   ],
   "agents": [
-    "./agents/tdd-red.md",
+    "./agents/playwright-tester.md",
     "./agents/tdd-green.md",
-    "./agents/tdd-refactor.md",
-    "./agents/playwright-tester.md"
+    "./agents/tdd-red.md",
+    "./agents/tdd-refactor.md"
   ],
   "skills": [
-    "./skills/playwright-explore-website/",
-    "./skills/playwright-generate-test/",
+    "./skills/ai-prompt-engineering-safety-review/",
     "./skills/csharp-nunit/",
     "./skills/java-junit/",
-    "./skills/ai-prompt-engineering-safety-review/"
+    "./skills/playwright-explore-website/",
+    "./skills/playwright-generate-test/"
   ]
 }

plugins/typespec-m365-copilot/.github/plugin/plugin.json

@@ -16,8 +16,8 @@
     "microsoft-365"
   ],
   "skills": [
+    "./skills/typespec-api-operations/",
     "./skills/typespec-create-agent/",
-    "./skills/typespec-create-api-plugin/",
-    "./skills/typespec-api-operations/"
+    "./skills/typespec-create-api-plugin/"
   ]
 }