diff --git a/docs/README.skills.md b/docs/README.skills.md
index 24fd5baefd..1d0b612acd 100644
--- a/docs/README.skills.md
+++ b/docs/README.skills.md
@@ -96,7 +96,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to
| [breakdown-test](../skills/breakdown-test/SKILL.md)
`gh skills install github/awesome-copilot breakdown-test` | Test Planning and Quality Assurance prompt that generates comprehensive test strategies, task breakdowns, and quality validation plans for GitHub projects. | None |
| [bug-receipt](../skills/bug-receipt/SKILL.md)
`gh skills install github/awesome-copilot bug-receipt` | Close defects and incidents with a BUG RECEIPT and VERIFIED, PARTIAL, or BLOCKED status after diagnosis, repair, or recovery. | `assets/receipt.template.json`
`references/receipt-contract.md`
`references/receipt.schema.json`
`scripts/validate-receipt.mjs` |
| [bug-reproduction-brief](../skills/bug-reproduction-brief/SKILL.md)
`gh skills install github/awesome-copilot bug-reproduction-brief` | Turn a vague, intermittent, or environment-specific bug report into a minimal evidence-backed reproduction before proposing a fix. | None |
-| [build-evidence-map](../skills/build-evidence-map/SKILL.md)
`gh skills install github/awesome-copilot build-evidence-map` | 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. | `references/evidence-ladder.md`
`references/map-schema.md`
`scripts/contract.mjs`
`scripts/validate.mjs` |
+| [build-evidence-map](../skills/build-evidence-map/SKILL.md)
`gh skills install github/awesome-copilot build-evidence-map` | 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. | `references/evidence-ladder.md`
`references/map-schema.md`
`scripts/contract.mjs`
`scripts/validate.mjs` |
| [centos-linux-triage](../skills/centos-linux-triage/SKILL.md)
`gh skills install github/awesome-copilot centos-linux-triage` | Triage and resolve CentOS issues using RHEL-compatible tooling, SELinux-aware practices, and firewalld. | None |
| [chrome-devtools](../skills/chrome-devtools/SKILL.md)
`gh skills install github/awesome-copilot chrome-devtools` | Expert-level browser automation, debugging, and performance analysis using Chrome DevTools MCP. Use for interacting with web pages, capturing screenshots, analyzing network traffic, and profiling performance. | None |
| [cli-mastery](../skills/cli-mastery/SKILL.md)
`gh skills install github/awesome-copilot cli-mastery` | Interactive training for the GitHub Copilot CLI. Guided lessons, quizzes, scenario challenges, and a full reference covering slash commands, shortcuts, modes, agents, skills, MCP, and configuration. Say "cliexpert" to start. | `references/final-exam.md`
`references/module-1-slash-commands.md`
`references/module-2-keyboard-shortcuts.md`
`references/module-3-modes.md`
`references/module-4-agents.md`
`references/module-5-skills.md`
`references/module-6-mcp.md`
`references/module-7-advanced.md`
`references/module-8-configuration.md`
`references/scenarios.md` |
diff --git a/skills/build-evidence-map/SKILL.md b/skills/build-evidence-map/SKILL.md
index 3d0ff9385a..bdda0f50f0 100644
--- a/skills/build-evidence-map/SKILL.md
+++ b/skills/build-evidence-map/SKILL.md
@@ -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
diff --git a/skills/dotnet-best-practices/SKILL.md b/skills/dotnet-best-practices/SKILL.md
index 183d3beb11..eb641ffbdb 100644
--- a/skills/dotnet-best-practices/SKILL.md
+++ b/skills/dotnet-best-practices/SKILL.md
@@ -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
diff --git a/skills/harness-engineering/SKILL.md b/skills/harness-engineering/SKILL.md
index 7dcaad853e..c6bc4b67f4 100644
--- a/skills/harness-engineering/SKILL.md
+++ b/skills/harness-engineering/SKILL.md
@@ -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
@@ -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`,
@@ -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` |