Clarify compiler-managed skill installation in .github/aw guidance

[Copilot]

The .github/aw guidance around skills mixed prompt-time skill usage with frontmatter-based skill installation. This updates the docs to make skills: the clear path for external skills and to show that the compiler handles installation wiring automatically.

• Clarify the skills: contract

  • Reframes skills: as the preferred mechanism for external skill installs.
  • States explicitly that authors should not add manual gh setup or gh skill install steps.
  • Distinguishes install-time skills: usage from prompt-time hint/fusion/inline skill patterns.

• Add concrete frontmatter examples

  • Replaces placeholder refs with real examples for:
    • shared activation auth
    • per-skill token auth
    • per-skill GitHub App auth
  • Keeps the SHA-pinning and auth constraints visible next to the examples.

• Align prompt examples with repo layout

  • Updates hint/fusion examples to reference both skills/ and .github/skills/.
  • Adjusts fused path examples to use .github/skills/... consistently.
  • Mirrors the same guidance in related context.md and experiments.md examples.

skills:
  - mattpocock/skills/tdd@801dca688564c529fa84f247f64472520d9ebe28
  - skill: mattpocock/skills/diagnosing-bugs@801dca688564c529fa84f247f64472520d9ebe28
    github-token: ${{ secrets.MATT_SKILLS_PAT || secrets.GITHUB_TOKEN }}
  - skill: mattpocock/skills/domain-modeling@801dca688564c529fa84f247f64472520d9ebe28
    github-app:
      client-id: ${{ vars.MATT_SKILLS_APP_CLIENT_ID }}
      private-key: ${{ secrets.MATT_SKILLS_APP_PRIVATE_KEY }}

[Copilot]

Pull request overview

Clarifies compiler-managed external skill installation and aligns skill discovery examples with repository layouts.

Changes:

• Documents skills: as the preferred external installation mechanism.
• Adds pinned examples for shared, token, and GitHub App authentication.
• Updates hint and fusion examples for .github/skills/.

Show a summary per file

File	Description
.github/aw/skills.md	Clarifies installation and prompt-time skill patterns.
.github/aw/experiments.md	Expands skill discovery paths.
.github/aw/context.md	Aligns conditional skill-hint guidance.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 3/3 changed files
• Comments generated: 0
• Review effort level: Medium

[github-actions]

🎉 This pull request is included in a new release.

Release: v0.83.1