Skip to content

Fix Copilot-only coupling in three Agent Skills #4453

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
MerverliPy wants to merge 4 commits into from
Closed

Fix Copilot-only coupling in three Agent Skills #4453

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
a3556e9
build-evidence-map: describe the skill without assuming the host agent
MerverliPy Oct 3, 2026
c834891
dotnet-best-practices: replace the ${selection} prompt variable
MerverliPy Oct 3, 2026
4b4580d
harness-engineering: make the harness-surface table agent-neutral
MerverliPy Oct 3, 2026
f5502f3
docs: regenerate the skills catalogue after the build-evidence-map edit
MerverliPy Oct 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion skills/build-evidence-map/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: build-evidence-map
description: 'Build an auditable evidence map for a contested technical choice, research synthesis, proposal review, or consequential decision. Use when Copilot must preserve supporting, contradicting, qualifying, and missing evidence with exact source regions instead of collapsing disagreement into prose.'
description: 'Build an auditable evidence map for a contested technical choice, research synthesis, proposal review, or consequential decision. Use when an agent must preserve supporting, contradicting, qualifying, and missing evidence with exact source regions instead of collapsing disagreement into prose.'
---

# Build Evidence Map
Expand Down
2 changes: 1 addition & 1 deletion skills/dotnet-best-practices/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: 'Ensure .NET/C# code meets best practices for the solution/project.

# .NET/C# Best Practices

Your task is to ensure .NET/C# code in ${selection} meets the best practices specific to this solution/project. This includes:
Your task is to ensure the .NET/C# code in the scope you were asked about meets the best practices specific to this solution/project. This includes:

## Documentation & Structure

Expand Down
8 changes: 5 additions & 3 deletions skills/harness-engineering/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Harness = Instructions + Constraints + Feedback + Memory + Evaluation + Governan

Use this skill when the user asks to:

- make a repository more reliable for GitHub Copilot or other coding agents
- make a repository more reliable for coding agents (GitHub Copilot, pi, Claude Code, or others)
- add durable agent instructions, repository rules, or guardrails
- prevent repeated AI coding-agent mistakes
- record known failure paths and the checks that prevent recurrence
Expand Down Expand Up @@ -50,6 +50,7 @@ Read these files and folders when they exist:
- `AGENTS.md`
- `.github/copilot-instructions.md`
- `.github/instructions/`
- `.pi/skills/` or `.agents/skills/`
- `.github/workflows/`
- `CONTRIBUTING.md`
- package manifests such as `package.json`, `pyproject.toml`, `go.mod`,
Expand Down Expand Up @@ -83,8 +84,9 @@ Pick only the surfaces that fit the target repository:

| Need | Preferred artifact |
| --- | --- |
| Always-on agent behavior | `AGENTS.md` or `.github/copilot-instructions.md` |
| File-scoped guidance | `.github/instructions/*.instructions.md` |
| Always-on agent behavior | `AGENTS.md` (with `.github/copilot-instructions.md` as a Copilot-only mirror) |
| File-scoped guidance | nested `AGENTS.md`, or `.github/instructions/*.instructions.md` for Copilot |
| Reusable agent workflows | a skill folder with `SKILL.md` |
| Recurring project checks | `scripts/check_*.py`, shell scripts, or package scripts |
| CI enforcement | existing workflow files or a small new workflow |
| Known failures | `docs/failures/*.md` |
Expand Down
Loading