CopilotAtelier
5.0.0-preview0002
Portable GitHub Copilot customization library. Ships custom agents, auto-applied instructions, on-demand skills, prompt templates, and lifecycle hooks, and installs them into the well-known ~/.copilot discovery folders that VS Code, the GitHub Copilot CLI, and Claude Code read.
Minimum PowerShell version
5.1
See the version list below for details.
Installation Options
Owners
Copyright
(c) raandree. All rights reserved.
Package Details
Author(s)
- raandree
Tags
Copilot GitHubCopilot VSCode Agents Skills Prompts Instructions Hooks AI Windows Linux MacOS
Functions
Get-CopilotAtelierVersion Install-CopilotAtelier Update-CopilotAtelier
Dependencies
This module has no dependencies.
Release Notes
## [5.0.0-preview0002] - 2026-08-27
### Changed
- **Narrowed the role-file clause in the Pre-flight Instruction so its scope cannot be read backwards** (2026-08-27). Step 3 of [`com.github.copilot/rules/preflight.instructions.md`](com.github.copilot/rules/preflight.instructions.md) closed on "Create only the active Custom agent's required role files", which parses most naturally as *the files that role requires* — the agent's entire declared list — and that is the opposite of the intended rule. The authority is [`skills/memory-bank/SKILL.md`](skills/memory-bank/SKILL.md) initialization step 6: an agent's role list is an additive schema, and only the files the current durable workflow actually needs get created. The clause now says exactly that, and adds the negative case the old wording never carried — never scaffold another agent's schema, and never pre-create a declared file this task does not use. The failure mode it prevents is not cosmetic: an eagerly created role file is an empty template that a later turn routes to, reads, and treats as authoritative project knowledge. Both agents that declare a role schema already agreed with the corrected reading, so this aligns the shared contract with them rather than changing behaviour anywhere else.
- **Migrated the plugin package to Agent Plugins 1.0** (2026-08-26). [`plugin.json`](plugin.json) now declares `"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json"`, which is the field VS Code and the GitHub Copilot CLI use to select the format. The 1.0 manifest schema is *closed* and its component locations are *fixed*: skills are discovered from a lowercase `./skills` at the package root and nowhere else, and the `agents` and `skills` path fields the legacy Copilot format honoured are no longer manifest fields at all. Declaring the schema without moving anything would therefore not have failed loudly — an unknown top-level field is reported and ignored, so the package would have kept loading while silently contributing zero skills. That trap was already written down as a guard in [`tests/PluginManifest.Tests.ps1`](tests/PluginManifest.Tests.ps1), which refused to let the schema be declared while the folder was still `Skills/`; this change satisfies the guard rather than deleting it.
The repository layout moved to match the format, and the package is now the primary layout rather than a second view of the module payload. `Skills/` became `skills/` — the portable component location, and the one rename that also *fixes* a latent bug, because the deployed folder is `~/.copilot/skills` and every case-only mismatch was already broken on case-sensitive filesystems. Everything Copilot-specific moved into the client-extension namespace under the names the format gives it: `Agents/` → `com.github.copilot/agents/`, `Instructions/` → `com.github.copilot/rules/`, `Prompts/` → `com.github.copilot/commands/`, and `Hooks/` → `com.github.copilot/hooks/` with the mandated `hooks.json` filename. A client that does not own that namespace ignores it without rejecting the package, so the portable half stays portable. Hooks are a clear gain: the legacy manifest never carried them, so a plugin install previously had no guardrails at all — the never-push block and the Memory Bank probe reached module users only.
The `rules/` and `commands/` file formats are not documented by VS Code or the Copilot CLI, so whether `.instructions.md` and `.prompt.md` register from a plugin install is unverified. Moving them anyway is a one-sided bet: if a client rejects them they simply do not load *from the plugin*, while the module path keeps delivering them to the same deployed locations. There is no state in which it is worse than leaving them at the root, and one in which it is better.
Hook commands had to learn two roots. A plugin is installed outside the workspace, so a relative path cannot work, but the same file also ships to `~/.copilot/hooks` through the module — so each command now resolves `$env:PLUGIN_ROOT` when a plugin host sets it and falls back to the user profile otherwise. Both branches are asserted, and the existing spawn-without-a-shell test clears `PLUGIN_ROOT` explicitly so the user-profile branch is genuinely exercised rather than accidentally taken.
The deployment contract is preserved by translation rather than by layout. `Install-CopilotAtelier` still produces `~/.copilot/{agents,instructions,skills,prompts,hooks}`; because the source and deployed layouts are now deliberately different shapes, the installer carries an explicit deployed-name → source-path map — `com.github.copilot/rules` deploys as `instructions`, `com.github.copilot/commands` as `prompts`. Canonical target directories are lowercase to match their discovery links, and because a case-insensitive filesystem quietly reuses the old directory while a case-sensitive one keeps a second copy forever, the installer sweeps the capitalised names from a previous release using a case-sensitive comparison. Renaming the deployed directories to match the namespace was rejected: it would require pinning `chat.instructionsFilesLocations`, and a `chat.*FilesLocations` setting *replaces* the default location map rather than extending it — the same trap that silently disabled every hook location once already.
One consequence is recorded rather than hidden. Cross-type relative links are now correct in the package and repository view and wrong in the deployed view, because `rules` and `commands` deploy as `instructions` and `prompts`. That direction is deliberate — the package is what a human browses on github.com and what a plugin install materialises — and nothing functional rests on it, since both lifecycle Instructions declare `applyTo: "**"` and load regardless. Links into the repository-only `reference/` were already dead in the deployed tree, so this widens an accepted condition rather than introducing a new class of defect.
[`README.md`](README.md) and [`AGENTS.md`](AGENTS.md) follow. The *Folder Structure* section now shows the deployed tree and the package layout side by side instead of conflating them, and the *Agent plugin* install path was rewritten: it previously told the reader that "the plugin format does not carry `.instructions.md` files or hooks, so this path gives you agents and skills only", which the migration makes false in the one direction that matters — hooks are exactly the guardrails a plugin-only user was silently missing. It now also names the two things worth knowing before choosing that path: bundled hooks execute locally and should be reviewed, and `rules`/`commands` registration is unconfirmed.
FileList
- CopilotAtelier.nuspec
- CopilotAtelier.psm1
- CopilotAtelier.psd1
- skills\windows-gui-screenshot-capture\SKILL.md
- skills\pandoc-docx-export\SKILL.md
- skills\sampler-framework\references\ci-cd-pipelines.md
- skills\windows-gui-screenshot-capture\notes-evals.md
- skills\winrm-troubleshooting\SKILL.md
- skills\sampler-framework\references\community-files.md
- keybindings\keybindings.json
- skills\brand-logo-system\SKILL.md
- skills\winrm-troubleshooting\notes-evals.md
- skills\sampler-framework\references\bootstrap.md
- com.github.copilot\agents\career-coach.agent.md
- skills\mcp-builder\SKILL.md
- skills\citation-integrity\SKILL.md
- skills\sampler-framework\references\testing-patterns.md
- com.github.copilot\agents\tax-researcher.agent.md
- skills\doc-coauthoring\SKILL.md
- skills\memory-bank\SKILL.md
- skills\sampler-framework\references\dependency-resolution.md
- com.github.copilot\agents\training-writer.agent.md
- skills\agent-evals\SKILL.md
- skills\memory-bank\notes-evals.md
- skills\sampler-framework\references\build-yaml.md
- com.github.copilot\agents\software-architect.agent.md
- skills\marp-slide-overflow\SKILL.md
- com.github.copilot\hooks\scripts\Write-CompactionCheckpoint.ps1
- skills\sampler-framework\references\dependency-management.md
- com.github.copilot\agents\technical-writer.agent.md
- skills\microsoft-todo-tasks\SKILL.md
- com.github.copilot\hooks\scripts\Add-SessionContext.ps1
- skills\sampler-framework\references\commands-reference.md
- com.github.copilot\agents\troubleshooter.agent.md
- skills\create-outlook-draft\SKILL.md
- com.github.copilot\hooks\scripts\Block-RemoteMutation.ps1
- skills\sampler-framework\references\project-structure.md
- com.github.copilot\agents\README.md
- skills\datum-configuration\SKILL.md
- skills\skill-creator\references\scripts-and-evaluation.md
- skills\long-running-job-monitor\references\heartbeat-protocol.md
- com.github.copilot\agents\software-engineer.agent.md
- skills\devils-advocate-review\SKILL.md
- skills\skill-creator\references\authoring-patterns.md
- skills\long-running-job-monitor\references\out-of-band-verification.md
- com.github.copilot\agents\research-analyst.agent.md
- skills\sampler-framework\SKILL.md
- skills\gilb-requirements-engineering\references\evo-planning.md
- skills\long-running-job-monitor\scripts\Start-JobHeartbeat.ps1
- com.github.copilot\agents\devops-training-writer.agent.md
- skills\sampler-build-debug\SKILL.md
- skills\gilb-requirements-engineering\references\planguage-keywords.md
- skills\long-running-job-monitor\scripts\Start-JobMonitor.ps1
- com.github.copilot\agents\security-reviewer.agent.md
- skills\pswritehtml-reporting\SKILL.md
- skills\gilb-requirements-engineering\references\spec-quality-control.md
- skills\long-running-job-monitor\scripts\Start-DetachedPowerShell.ps1
- com.github.copilot\agents\legal-researcher.agent.md
- skills\long-running-job-monitor\SKILL.md
- skills\gilb-requirements-engineering\references\impact-estimation.md
- skills\evidence-package-assembly\scripts\Build-EvidencePackage.ps1
- com.github.copilot\agents\qc-inspector.agent.md
- skills\long-running-job-monitor\notes-evals.md
- skills\windows-gui-screenshot-capture\references\external-win32-executables.md
- skills\evidence-package-assembly\scripts\merge-and-verify.py
- com.github.copilot\hooks\hooks.json
- skills\code-review-and-quality\SKILL.md
- skills\windows-gui-screenshot-capture\references\engine-recipes.md
- skills\pester-patterns\references\migrating-pester-v4-to-v5.md
- com.github.copilot\hooks\README.md
- skills\code-review-and-quality\notes-evals.md
- skills\windows-gui-screenshot-capture\scripts\WindowCapture.ps1
- skills\pester-patterns\references\testing-powershell-constructs.md
- com.github.copilot\rules\powershell.instructions.md
- skills\send-outlook-email\SKILL.md
- skills\windows-gui-screenshot-capture\scripts\DialogCapture.ps1
- skills\pester-patterns\references\mocking-external-dependencies.md
- com.github.copilot\rules\azurepipelines.instructions.md
- skills\debugging-and-error-recovery\SKILL.md
- skills\brand-logo-system\scripts\Export-BrandLogoSet.ps1
- skills\pester-patterns\scripts\Find-PesterV4Pattern.ps1
- com.github.copilot\rules\preflight.instructions.md
- skills\debugging-and-error-recovery\notes-evals.md
- skills\agent-evals\assets\trigger-queries.sampler-build-debug.json
- skills\authenticated-web-extraction\bootstrap\package.json
- com.github.copilot\rules\markdown.instructions.md
- skills\evidence-package-assembly\SKILL.md
- skills\agent-evals\assets\trigger-queries.sampler-framework.json
- skills\automatedlab-proxmox\references\evidence-and-readiness.md
- com.github.copilot\rules\sampler.instructions.md
- skills\whisper-pyannote-transcription\SKILL.md
- skills\agent-evals\assets\evals.sample.json
- skills\automatedlab-proxmox\references\module-development.md
- com.github.copilot\rules\yaml.instructions.md
- skills\whisper-pyannote-transcription\transcribe.py
- skills\agent-evals\assets\trigger-queries.copilot-usage-stats.json
- skills\automatedlab-proxmox\references\windows-sysprep.md
- com.github.copilot\rules\postflight.instructions.md
- skills\whisper-pyannote-transcription\transcribe-segment.py
- skills\agent-evals\assets\trigger-queries.pester-patterns.json
- skills\automatedlab-deployment\references\lab-management.md
- com.github.copilot\rules\versioning.instructions.md
- skills\whisper-pyannote-transcription\diarize.py
- skills\agent-evals\assets\trigger-queries.brand-logo-system.json
- skills\automatedlab-deployment\references\troubleshooting.md
- com.github.copilot\rules\copilot-authoring.instructions.md
- skills\pester-patterns\SKILL.md
- skills\agent-evals\assets\trigger-queries.sampler-migration.json
- skills\automatedlab-deployment\references\post-deployment-operations.md
- com.github.copilot\rules\ubiquitous-language.instructions.md
- skills\pester-patterns\notes-evals.md
- skills\agent-evals\assets\trigger-queries.skill-creator.json
- skills\automatedlab-deployment\references\roles-and-services.md
- com.github.copilot\rules\pester.instructions.md
- skills\grammar-check\SKILL.md
- skills\agent-evals\assets\trigger-queries.test-driven-development.json
- skills\automatedlab-deployment\references\cmdlet-reference.md
- com.github.copilot\rules\powershell-execution-safety.instructions.md
- skills\test-driven-development\SKILL.md
- skills\agent-evals\assets\trigger-queries.sample.json
- skills\automatedlab-deployment\references\networking.md
- com.github.copilot\rules\json.instructions.md
- skills\test-driven-development\notes-evals.md
- skills\agent-evals\assets\evals.output.sample.json
- skills\automatedlab-deployment\references\vm-operations.md
- com.github.copilot\rules\csharp.instructions.md
- skills\outlook-email-export\SKILL.md
- skills\agent-evals\references\eval-artifacts.md
- skills\german-tax-research\references\vorlagen.md
- com.github.copilot\rules\git.instructions.md
- skills\agent-security-review\SKILL.md
- skills\agent-evals\scripts\run-trigger-evals.ps1
- skills\german-tax-research\references\vermietung-und-afa.md
- com.github.copilot\rules\changelog.instructions.md
- skills\german-legal-research\SKILL.md
- skills\agent-evals\scripts\run-evals.ps1
- skills\german-tax-research\references\belegaufforderung-antwort.md
- com.github.copilot\commands\session-handoff.prompt.md
- skills\authenticated-web-extraction\SKILL.md
- skills\marp-slide-overflow\references\speaker-note-guard.md
- skills\german-tax-research\references\kennzahlen.md
- com.github.copilot\commands\peer-review.prompt.md
- skills\mecm-dsc-deployment\SKILL.md
- skills\marp-slide-overflow\references\mermaid-prerender.md
- skills\german-tax-research\references\fristen-und-verfahren.md
- com.github.copilot\commands\audit-case-file.prompt.md
- skills\outlook-calendar-export\SKILL.md
- skills\marp-slide-overflow\references\png-verification.md
- skills\german-tax-research\references\werbungskosten-und-abzuege.md
- com.github.copilot\commands\code-review.prompt.md
- skills\xlsx-to-markdown\SKILL.md
- skills\marp-slide-overflow\references\overflow-detector.md
- skills\german-tax-research\scripts\Get-SteuerFrist.ps1
- com.github.copilot\commands\export-emails.prompt.md
- skills\dsc-troubleshooting\SKILL.md
- skills\datum-configuration\references\common-tasks.md
- skills\winrm-troubleshooting\references\post-restart-readiness.md
- com.github.copilot\commands\pr-description.prompt.md
- skills\subagent-dispatch\SKILL.md
- skills\datum-configuration\references\datum-yml-reference.md
- skills\winrm-troubleshooting\references\advanced-diagnostics.md
- com.github.copilot\commands\usage.prompt.md
- skills\automatedlab-proxmox\SKILL.md
- skills\datum-configuration\references\dscworkshop-reference.md
- skills\memory-bank\scripts\Test-MemoryBankRouting.ps1
- com.github.copilot\commands\deadline-action-handoff.prompt.md
- skills\automatedlab-proxmox\notes-evals.md
- skills\datum-configuration\references\projectdagger-patterns.md
- skills\memory-bank\scripts\Initialize-MemoryBank.ps1
- com.github.copilot\commands\lab-deploy.prompt.md
- skills\sampler-migration\SKILL.md
- skills\sampler-framework\references\custom-build-tasks.md
- skills\memory-bank\scripts\Invoke-MemoryBankRouteSelectionEval.ps1
- com.github.copilot\commands\brand-logo.prompt.md
- skills\copilot-usage-stats\SKILL.md
- skills\sampler-framework\references\troubleshooting.md
- skills\memory-bank\scripts\Test-MemoryBankHealth.ps1
- com.github.copilot\commands\refactor.prompt.md
- skills\automatedlab-deployment\SKILL.md
- skills\sampler-framework\references\gitversion.md
- skills\memory-bank\evals\routing-cases.json
- com.github.copilot\commands\module-scaffold.prompt.md
- skills\docx-to-markdown\SKILL.md
- skills\sampler-framework\references\vscode-integration.md
- skills\authenticated-web-extraction\bootstrap\tasks\check-logins.mjs
- com.github.copilot\commands\sync-project-emails.prompt.md
- skills\german-tax-research\SKILL.md
- skills\sampler-framework\references\module-manifest.md
- skills\authenticated-web-extraction\bootstrap\tasks\dump-cookies.mjs
- skills\skill-creator\SKILL.md
- skills\social-signal-sweep\SKILL.md
- skills\sampler-framework\references\multi-module.md
- skills\authenticated-web-extraction\bootstrap\scripts\open.mjs
- skills\gilb-requirements-engineering\SKILL.md
- skills\pdf-to-markdown\SKILL.md
- skills\sampler-framework\references\dsc-datum.md
- skills\authenticated-web-extraction\bootstrap\scripts\extract.mjs
- skills\grill-me\SKILL.md
Version History
| Version | Downloads | Last updated |
|---|---|---|
| 5.0.0-previe... | 3 | 8/27/2026 |
| 5.0.0-previe... (current version) | 3 | 8/27/2026 |
| 5.0.0-previe... | 4 | 8/26/2026 |
| 4.0.0 | 9 | 8/26/2026 |
| 4.0.0-previe... | 2 | 8/26/2026 |
| 4.0.0-previe... | 3 | 8/26/2026 |
| 4.0.0-previe... | 4 | 8/25/2026 |
| 4.0.0-previe... | 3 | 8/25/2026 |
| 4.0.0-previe... | 3 | 8/25/2026 |
| 4.0.0-previe... | 3 | 8/25/2026 |
| 4.0.0-previe... | 3 | 8/25/2026 |
| 4.0.0-previe... | 3 | 8/24/2026 |
| 4.0.0-previe... | 3 | 8/24/2026 |
| 4.0.0-previe... | 18 | 8/19/2026 |
| 4.0.0-previe... | 2 | 8/19/2026 |
| 4.0.0-previe... | 5 | 8/15/2026 |
| 4.0.0-previe... | 4 | 8/12/2026 |
| 4.0.0-previe... | 4 | 8/12/2026 |
| 3.2.0-previe... | 3 | 8/11/2026 |
| 3.1.1-previe... | 6 | 8/11/2026 |
| 3.1.0 | 29 | 8/7/2026 |
| 3.1.0-previe... | 3 | 8/7/2026 |
| 3.1.0-previe... | 3 | 8/5/2026 |
| 3.1.0-previe... | 3 | 8/5/2026 |
| 3.1.0-previe... | 7 | 8/4/2026 |
| 3.0.0 | 16 | 8/1/2026 |
| 3.0.0-previe... | 4 | 8/1/2026 |
| 3.0.0-previe... | 5 | 8/1/2026 |
| 3.0.0-previe... | 5 | 8/1/2026 |
| 2.0.0 | 7 | 7/29/2026 |
| 2.0.0-previe... | 3 | 7/29/2026 |