Skip to content

docs: align Copilot SDK branding - #5988

Merged
aaronpowell merged 1 commit into
mainfrom
aaronpowell-microsoft-copilot-sdk-docs
Nov 2, 2026
Merged

aaronpowell merged 1 commit into
mainfrom
aaronpowell-microsoft-copilot-sdk-docs

Conversation

@aaronpowell

Copy link
Copy Markdown
Contributor

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution updates existing SDK instructions, skill, plugin, cookbook, and glossary content in their existing locations.
  • The files follow the repository naming conventions.
  • The content is clearly structured and follows the existing format.
  • I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the main branch for this pull request.

Description

The GitHub Copilot SDK is transitioning to the Microsoft Copilot SDK, and our published skill, plugin, cookbook, and language guidance should reflect the announced name and expanded positioning. This updates user-facing names and transition notes across the SDK content while retaining the currently published package identifiers, imports, and repository URLs because the official announcement says no immediate changes are required.

The cookbook metadata and generated catalogues are updated, and the Learning Hub glossary now distinguishes the SDK from Agent Host. References to old package or repository names remain only where needed for accurate setup and migration context.


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • New canvas extension.
  • Update to existing instruction, prompt, agent, plugin, skill, workflow, or canvas extension.
  • Other (please specify):

Additional Notes

Validation results:

  • npm start - passed; generated README/catalogues are up to date.
  • npm run build - passed.
  • npm run plugin:validate - passed.
  • npm run skill:validate - passed.
  • git diff --check - passed.
  • npm run website:build - did not complete: Astro build fails during filesystem cleanup with The property 'options.recursive' is no longer supported under Node.js 26.7.0. Website data generation completed before the Astro build failed.

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI auto review requested due to automatic review settings October 30, 2026 01:19
@aaronpowell
aaronpowell requested review from a team as code owners October 30, 2026 01:19
@github-actions github-actions Bot added instructions PR touches instructions plugin PR touches plugins skills PR touches skills website-update PR touches website content or code labels Oct 30, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 24 changed file(s).

Severity Count
🔴 High 1
🟠 Medium 18
ℹ️ Info 0
Severity Rule File Line Match
🟠 package-exec-command cookbook/copilot-sdk/README.md 89 npx tsx &lt;filename&gt;.ts
🟠 package-exec-command cookbook/copilot-sdk/dotnet/recipe/README.md 145 Or let Node Package Manager install it on-demand. The recipe will attempt to launch `npx @​​playwright/mcp` automatically. Run the recipe as normal:
🔴 remote-shell-execution cookbook/copilot-sdk/java/recipe/README.md 17 curl -Ls https://sh.jbang.dev | bash -s - app setup
🟠 package-exec-command cookbook/copilot-sdk/java/recipe/README.md 186 Install Node.js so `npx` is available. The recipe launches
🟠 package-exec-command cookbook/copilot-sdk/java/recipe/README.md 187 ```npx @​​playwright/mcp@​​latest` on demand; a global MCP installation is not required.``
🟠 unpinned-version-indicator cookbook/copilot-sdk/java/recipe/README.md 187 ```npx @​​playwright/mcp@​​latest` on demand; a global MCP installation is not required.``
🟠 package-exec-command cookbook/copilot-sdk/nodejs/recipe/README.md 27 npx tsx &lt;filename&gt;.ts
🟠 package-exec-command cookbook/copilot-sdk/nodejs/recipe/README.md 34 | Error Handling | `npm run error-handling` | `npx tsx error-handling.ts` | Demonstrates error handling patterns |
🟠 package-exec-command cookbook/copilot-sdk/nodejs/recipe/README.md 35 | Multiple Sessions | `npm run multiple-sessions` | `npx tsx multiple-sessions.ts` | Manages multiple independent conversations |
🟠 package-exec-command cookbook/copilot-sdk/nodejs/recipe/README.md 36 | Managing Local Files | `npm run managing-local-files` | `npx tsx managing-local-files.ts` | Organizes files using AI grouping |
🟠 package-exec-command cookbook/copilot-sdk/nodejs/recipe/README.md 37 | PR Visualization | `npm run pr-visualization` | `npx tsx pr-visualization.ts` | Generates PR age charts |
🟠 package-exec-command cookbook/copilot-sdk/nodejs/recipe/README.md 38 | Persisting Sessions | `npm run persisting-sessions` | `npx tsx persisting-sessions.ts` | Save and resume sessions across restarts |
🟠 package-exec-command cookbook/copilot-sdk/nodejs/recipe/README.md 45 npx tsx pr-visualization.ts --repo github/copilot-sdk
🟠 package-exec-command cookbook/copilot-sdk/nodejs/recipe/README.md 52 npx tsx managing-local-files.ts
🟠 unpinned-version-indicator cookbook/copilot-sdk/nodejs/recipe/package.json 15 "@​​github/copilot-sdk": "*"
🟠 unpinned-version-indicator cookbook/copilot-sdk/nodejs/recipe/package.json 18 "@​​types/node": "^22.19.7",
🟠 unpinned-version-indicator cookbook/copilot-sdk/nodejs/recipe/package.json 19 "tsx": "^4.19.2",
🟠 unpinned-version-indicator cookbook/copilot-sdk/nodejs/recipe/package.json 20 "typescript": "^5.7.2"
🟠 package-exec-command skills/copilot-sdk/SKILL.md 77 ``Run: `npx tsx index.ts```

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

@github-actions

github-actions Bot commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

🚦 Submission status: 👀 Ready for review

Risk tier: merge-risk:medium — New or substantially changed resource without privileged execution
Required to merge: passing submission-gate checks plus 1 approval from reviewers with write access.

Why this tier
  • Changes 142 lines (low-risk limit is 40)

Automated checks

Check Status Details
Line endings ✅ Passed Passed · logs
Spelling ✅ Passed Passed · logs
Generated README consistency ✅ Passed Passed · logs
Plugin and extension validation ✅ Passed Passed · logs
Plugin structure ✅ Passed Passed · logs
Skill validation ✅ Passed Passed · logs
Skill lint (vally) ✅ Passed Passed · logs
Risk scan ✅ Passed Passed · logs
Contributor reputation ✅ Passed Passed · logs
Duplicate resource scan ✅ Passed Passed · logs
PR quality signal ✅ Passed Passed · logs
Canvas/plugin smoke test ✅ Passed Passed · logs

Review

  • Approvals: 0/1
  • Assigned reviewer: not assigned yet — comment /request-review to ask for one
  • Review target date: not set
  • Still needed: 1 more approval(s)
  • No staffed reviewer pool owns these files yet; any reviewer with write access counts as the domain reviewer.

Commands

Command Who What it does
/rerun-checks PR author, maintainers Re-runs failed or incomplete checks and re-evaluates this gate
/request-review PR author, maintainers Asks the review rotation to assign a reviewer (adds needs-reviewer)

Updated for 84f3767 · gate run · This comment is maintained automatically — see submission gate docs.

@github-actions

Copy link
Copy Markdown
Contributor

🟡 Contributor Reputation Check: MEDIUM risk

Check Risk
Profile MEDIUM
Credential audit NONE

Maintainers: please review this contributor before merging.
See the workflow run for full details.
Automated check powered by AGT.

@github-actions github-actions Bot added needs-review:MEDIUM Contributor reputation check flagged MEDIUM risk skill-check-error Skill validator reported errors labels Oct 30, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🔍 Vally Lint Results

⛔ Findings need attention

Scope Checked
Skills 1
Agents 0
Total 1
Severity Count
❌ Errors 1
⚠️ Warnings 0
ℹ️ Advisories 0

Summary

Level Finding
❌ copilot-sdk (1/2 checks passed, 1 failed)
Full linter output
### Linting skills/copilot-sdk
❌ copilot-sdk (1/2 checks passed, 1 failed)
    ✗ [spec-compliance] 1 of 1 skill(s) have spec violations.
        ✗ spec-compliance: Spec checks failed.
            ✗ File length (910 lines) exceeds limit (500).
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 failed

Note: Vally lint returned a non-zero exit code. Please review the findings above before merge.

@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Oct 30, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

The glossary change lacks completed Astro build verification, so a maintainer must rerun it with the repository-supported Node.js runtime before approval.

No open issues 🎉

What changed in this PR

Updates Copilot SDK documentation and metadata to reflect the transition from GitHub Copilot SDK to Microsoft Copilot SDK while preserving current package identifiers, imports, namespaces, and repository URLs.

Changes:

  • Rebrands SDK skills, plugins, instructions, cookbook content, and glossary entries.
  • Adds transition guidance and links to the official announcement.
  • Regenerates catalogue, marketplace, and cookbook metadata.
File Description
website/​src/​content/​docs/​learning-hub/​github-copilot-terminology-glossary.md Adds the Microsoft Copilot SDK glossary entry and updates Agent Host terminology.
skills/​copilot-sdk/​SKILL.md Updates the skill branding and transition guidance.
plugins/​copilot-sdk/​README.md Updates plugin branding and migration notes.
plugins/​copilot-sdk/​plugin.json Updates plugin description metadata.
instructions/​copilot-sdk-python.instructions.md Updates Python instruction branding and transition guidance.
instructions/​copilot-sdk-nodejs.instructions.md Updates Node.js instruction branding and transition guidance.
instructions/​copilot-sdk-java.instructions.md Updates Java instruction branding and transition guidance.
instructions/​copilot-sdk-go.instructions.md Updates Go instruction branding and transition guidance.
instructions/​copilot-sdk-csharp.instructions.md Updates C# instruction branding and transition guidance.
docs/​README.skills.md Regenerates the skill catalogue description.
docs/​README.plugins.md Regenerates the plugin catalogue description.
docs/​README.instructions.md Regenerates instruction names and descriptions.
cookbook/​README.md Updates the cookbook SDK section and official links.
cookbook/​copilot-sdk/​README.md Updates shared SDK cookbook branding and transition guidance.
cookbook/​copilot-sdk/​python/​recipe/​README.md Updates Python recipe documentation labeling.
cookbook/​copilot-sdk/​python/​README.md Updates Python cookbook branding and transition context.
cookbook/​copilot-sdk/​nodejs/​recipe/​README.md Updates Node.js recipe documentation labeling.
cookbook/​copilot-sdk/​nodejs/​recipe/​package.json Updates the runnable recipe package description.
cookbook/​copilot-sdk/​nodejs/​README.md Updates Node.js cookbook branding and transition context.
cookbook/​copilot-sdk/​java/​recipe/​README.md Updates Java prerequisites and documentation labeling.
cookbook/​copilot-sdk/​java/​README.md Updates Java cookbook branding and published-identifier guidance.
cookbook/​copilot-sdk/​go/​recipe/​README.md Updates Go prerequisites and documentation labeling.
cookbook/​copilot-sdk/​go/​README.md Updates Go cookbook branding and transition context.
cookbook/​copilot-sdk/​dotnet/​recipe/​README.md Clarifies the currently published .NET package identifier.
cookbook/​copilot-sdk/​dotnet/​README.md Updates .NET cookbook branding and transition context.
cookbook/​cookbook.yml Updates cookbook and external sample metadata.
.github/​plugin/​marketplace.json Regenerates the marketplace plugin description.

Review effort: Lite (auto)

@aaronpowell
aaronpowell merged commit 90e8fc5 into main Nov 2, 2026
38 of 39 checks passed
@aaronpowell
aaronpowell deleted the aaronpowell-microsoft-copilot-sdk-docs branch November 2, 2026 03:40

This branch was successfully deployed

1 active deployment
github-pages — 84f37678 Deployed Oct 30, 2026 by aaronpowell via deploy #1218
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

instructions PR touches instructions merge-risk:medium needs-review:MEDIUM Contributor reputation check flagged MEDIUM risk plugin PR touches plugins ready-for-review Submission passed intake validation and is ready for maintainer review skill-check-error Skill validator reported errors skills PR touches skills website-update PR touches website content or code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants