Merged
Conversation
Contributor
Screenshot ChangesBase: Changed (1)
|
| Before | After |
|---|---|
 |
 |
jrieken
approved these changes
Apr 10, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the Copilot /init skill prompt to improve clarity and tighten the workflow guidance for generating/updating agent customization files (follow-up to the earlier generalization work in #309020).
Changes:
- Clarifies the optional argument behavior and reinforces “customizations only” scope.
- Improves wording/grammar around the invocation and completion instructions.
- Updates workflow guidance text (including referencing the
agent-customizationskill).
Show a summary per file
| File | Description |
|---|---|
| extensions/copilot/assets/prompts/skills/init/SKILL.md | Refines /init skill instructions and workflow wording for creating/updating customization files. |
Copilot's findings
- Files reviewed: 1/1 changed files
- Comments generated: 2
|
|
||
| 3. **Generate or merge** | ||
| - New file: Prefern AGENTS.md over `.github/copilot-instructions.md`. If the user already has one of these files, update it instead of creating a new one. If both exist, update both. | ||
| - New file: Prefer AGENTS.md over `.github/copilot-instructions.md`. If the user already has one of these files, update it instead of creating a new one. |
There was a problem hiding this comment.
Step 3 now omits guidance for the case where both AGENTS.md and .github/copilot-instructions.md are present. Without explicitly saying to update both (or explaining which one is authoritative), the /init workflow becomes ambiguous and may lead to only one file being updated, causing divergence.
Suggested change
| - New file: Prefer AGENTS.md over `.github/copilot-instructions.md`. If the user already has one of these files, update it instead of creating a new one. | |
| - Agent instructions file: If neither file exists, create `AGENTS.md` rather than `.github/copilot-instructions.md`. If exactly one of these files exists, update the existing file instead of creating a new one. If both `AGENTS.md` and `.github/copilot-instructions.md` exist, treat `AGENTS.md` as the authoritative file and update both files to keep them aligned. |
| Explore the codebase to get a good understanding of the project and its conventions, and then create or update the relevant chat customization files to help AI coding agents be productive in this codebase. | ||
|
|
||
| When complete, give the user table of the added or modified chat customization files, along with a short explanation why this file is useful for the AI coding agents. | ||
| When complete, print a table of the added or modified chat customization files, along with a short explanation why this file is useful to the AI coding agents. |
There was a problem hiding this comment.
Minor grammar: “a short explanation why this file is useful…” reads awkwardly; consider “a short explanation of why this file is useful…”.
Suggested change
| When complete, print a table of the added or modified chat customization files, along with a short explanation why this file is useful to the AI coding agents. | |
| When complete, print a table of the added or modified chat customization files, along with a short explanation of why this file is useful to the AI coding agents. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Followup on #309020