Added vcpkg skill by AugP · Pull Request #2300 · github/awesome-copilot

AugP · 2026-07-15T16:25:27Z

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 adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
The file follows the required naming convention.
The content is clearly structured and follows the example 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

Added a skill to enhance Copilot's support for the vcpkg package manager. Skill was already demoed for the Pure Virtual C++ 2026 conference using Copilot CLI. Now I hope to share it with the community.

Type of Contribution

Additional Notes

About me: I am the product manager for vcpkg.

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

github-actions · 2026-07-15T16:26:02Z

🔒 PR Risk Scan Results

Scanned 5 changed file(s).

Severity	Count
🔴 High	0
🟠 Medium	1
ℹ️ Info	0

Severity	Rule	File	Line	Match
🟠	`package-exec-command`	`docs/README.skills.md`	31	\| [acreadiness-assess](../skills/acreadiness-assess/SKILL.md)<br />`gh skills install github/awesome-copilot acreadiness-assess` \| Run the AgentRC readiness assessment on the curre

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

github-actions · 2026-07-15T16:27:37Z

🔍 Vally Lint Results

✅ All checks passed

Scope	Checked
Skills	1
Agents	0
Total	1

Severity	Count
❌ Errors	0
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
ℹ️	npm warn EBADENGINE Unsupported engine {
ℹ️	npm warn EBADENGINE package: 'commander@15.0.0',
ℹ️	npm warn EBADENGINE required: { node: '>=22.12.0' },
ℹ️	npm warn EBADENGINE current: { node: 'v20.20.2', npm: '10.8.2' }
ℹ️	npm warn EBADENGINE }
ℹ️	npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
ℹ️	✅ vcpkg (2/2 checks passed)
ℹ️	✓ [spec-compliance] All 1 skill(s) are spec-compliant.
ℹ️	✓ spec-compliance: All spec checks passed.
ℹ️	✓ [valid-refs] All file references across 1 skill(s) are valid.

Full linter output

### Linting skills/vcpkg
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE   package: 'commander@15.0.0',
npm warn EBADENGINE   required: { node: '>=22.12.0' },
npm warn EBADENGINE   current: { node: 'v20.20.2', npm: '10.8.2' }
npm warn EBADENGINE }
npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
✅ vcpkg (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [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 passed

Copilot

Pull request overview

Adds a vcpkg skill covering dependency management, versioning, integration, and cross-platform builds.

Changes:

Adds core vcpkg guidance.
Adds registries, CI/CD, and troubleshooting references.
Adds the skill to the generated documentation index.

Show a summary per file

File	Description
`skills/vcpkg/SKILL.md`	Defines the core skill guidance.
`skills/vcpkg/references/ci.md`	Documents CI/CD and caching.
`skills/vcpkg/references/registries.md`	Covers registries and overlays.
`skills/vcpkg/references/troubleshooting.md`	Covers diagnostics and maintenance.
`docs/README.skills.md`	Indexes the new skill.

Review details

Files reviewed: 5/5 changed files
Comments generated: 23
Review effort level: Medium

@@ -0,0 +1,283 @@
+---
+name: vcpkg
+description: Guide for setting up vcpkg in C++ projects, managing dependency versions, and cross-compiling. Covers manifest initialization, CMake and Visual Studio integration, classic-to-manifest migration, version pinning, baselines, overrides, triplets, and cross-compilation. Use when a user is working with vcpkg project setup, installation, version management, or cross-platform builds. For specialized tasks, additional references cover custom registries and overlay ports (references/registries.md), CI/CD and binary caching (references/ci.md), and troubleshooting and dependency lifecycle (references/troubleshooting.md).


+
+If the user is working inside **Visual Studio** (not VS Code), prefer using the **in-box copy of vcpkg that ships with Visual Studio** rather than a standalone vcpkg clone, unless the user indicates they want to use a different installation. The VS-bundled vcpkg:
+- Is located under the Visual Studio installation directory (e.g., `C:\Program Files\Microsoft Visual Studio\<version>\<edition>\VC\vcpkg\`)
+- Is automatically integrated with MSBuild — no need to run `vcpkg integrate install`


+{
+  "name": "my-project",
+  "version": "1.0.0",
+  "dependencies": []


+find_package(fmt CONFIG REQUIRED)
+target_link_libraries(my-app PRIVATE fmt::fmt)


+
+1. List what's currently installed: `vcpkg list`
+2. Create `vcpkg.json` with those dependencies
+3. Delete global installs: `vcpkg remove --outdated --recurse`


+**Azure Blob Storage:**
+```
+set VCPKG_BINARY_SOURCES=clear;x-azblob,https://myaccount.blob.core.windows.net/vcpkg-cache,<sas-token>,readwrite


+- Is located under the Visual Studio installation directory (e.g., `C:\Program Files\Microsoft Visual Studio\<version>\<edition>\VC\vcpkg\`)
+- Is automatically integrated with MSBuild — no need to run `vcpkg integrate install`
+- Stays up-to-date with Visual Studio updates
+- Works out of the box with CMake projects opened via "Open Folder" or CMake presets


+vcpkg_install_copyright(FILE_LIST "${SOURCE_PATH}/LICENSE")
+```
+
+Use it: `vcpkg install telemetry-sdk --overlay-ports=./my-overlays`


+
+### Adding vcpkg to an Existing Visual Studio Solution
+
+1. Run `vcpkg integrate install` (one-time, system-wide)


+- `build-<triplet>-out.log` — Build (compile) output
+- `install-<triplet>-out.log` — Install step output
+- `config-<triplet>-err.log` — CMake configure errors
+- `build-<triplet>-err.log` — Build errors
+- `package-<triplet>-out.log` — Packaging output


AugP · 2026-07-15T22:32:49Z

Will make a few changes and re-open when done.

AugP added 2 commits July 15, 2026 09:16

Added vcpkg skill

e3fa321

vcpkg skill automated README update

8fc9543

AugP requested a review from aaronpowell as a code owner July 15, 2026 16:25

Copilot AI review requested due to automatic review settings July 15, 2026 16:25

github-actions Bot added new-submission PR adds at least one new contribution skills PR touches skills labels Jul 15, 2026

Copilot started reviewing on behalf of AugP July 15, 2026 16:25 View session

Copilot AI reviewed Jul 15, 2026

View reviewed changes

AugP marked this pull request as draft July 15, 2026 22:32

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Added vcpkg skill#2300

Added vcpkg skill#2300
AugP wants to merge 2 commits into
github:mainfrom
AugP:vcpkg-skill

AugP commented Jul 15, 2026

Uh oh!

github-actions Bot commented Jul 15, 2026

Uh oh!

github-actions Bot commented Jul 15, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

AugP commented Jul 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		find_package(fmt CONFIG REQUIRED)
		target_link_libraries(my-app PRIVATE fmt::fmt)


		### Adding vcpkg to an Existing Visual Studio Solution

		1. Run `vcpkg integrate install` (one-time, system-wide)

Uh oh!

Conversation

AugP commented Jul 15, 2026

Pull Request Checklist

Description

Type of Contribution

Additional Notes

About me: I am the product manager for vcpkg.

Uh oh!

github-actions Bot commented Jul 15, 2026

🔒 PR Risk Scan Results

Uh oh!

github-actions Bot commented Jul 15, 2026

🔍 Vally Lint Results

Summary

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Review details

Uh oh!

AugP commented Jul 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants