From aaa273ebfb393ba5cbffb87fb40a1693e2e97f2b Mon Sep 17 00:00:00 2001 From: James Montemagno Date: Sun, 30 Aug 2026 12:15:49 -0700 Subject: [PATCH 1/3] Document efficient repository cloning Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- CONTRIBUTING.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 73557ffee0..438975bd38 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -9,6 +9,27 @@ This repository contains shared building blocks for coding agents: Because these artifacts can affect many users and workflows, we prioritize correctness, clarity, and long term maintainability over speed. +## Cloning efficiently + +This repository has generated dashboard branches with substantial history. For a +contributor clone that retains the `main` branch history, use: + +```bash +git clone --filter=blob:none --single-branch https://github.com/dotnet/skills.git +``` + +`--single-branch` excludes the disconnected generated branches, while +`--filter=blob:none` downloads file contents on demand. + +For CI or read-only use that needs only the latest `main` snapshot, use: + +```bash +git clone --depth=1 --single-branch https://github.com/dotnet/skills.git +``` + +The shallow option omits older `main` history, so it is not recommended when that +history is needed for development. + ## Code ownership Every plugin, skill, and agent must have designated owners in the `.github/CODEOWNERS` file. When you add a new skill or agent, add a matching CODEOWNERS entry. Ownership must be either: From 9880189dce5d8769015dc51e69fba3b546b5a948 Mon Sep 17 00:00:00 2001 From: James Montemagno Date: Mon, 31 Aug 2026 11:02:29 -0700 Subject: [PATCH 2/3] Clarify shallow clone branch Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 438975bd38..2ca1f159cb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -24,7 +24,7 @@ git clone --filter=blob:none --single-branch https://github.com/dotnet/skills.gi For CI or read-only use that needs only the latest `main` snapshot, use: ```bash -git clone --depth=1 --single-branch https://github.com/dotnet/skills.git +git clone --branch main --depth=1 --single-branch https://github.com/dotnet/skills.git ``` The shallow option omits older `main` history, so it is not recommended when that From df2fb6f7a69f32344381930f362fe507bd5167ad Mon Sep 17 00:00:00 2001 From: James Montemagno Date: Mon, 31 Aug 2026 13:33:08 -0700 Subject: [PATCH 3/3] Address efficient clone review feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- CONTRIBUTING.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2ca1f159cb..fd478d7824 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -15,11 +15,12 @@ This repository has generated dashboard branches with substantial history. For a contributor clone that retains the `main` branch history, use: ```bash -git clone --filter=blob:none --single-branch https://github.com/dotnet/skills.git +git clone --branch main --filter=blob:none --single-branch https://github.com/dotnet/skills.git ``` `--single-branch` excludes the disconnected generated branches, while -`--filter=blob:none` downloads file contents on demand. +`--filter=blob:none` avoids downloading historical file contents until needed; +files required for the initial checkout are still downloaded. For CI or read-only use that needs only the latest `main` snapshot, use: