Awesome/awesome-copilot
1
0
Fork 0
mirror of https://github.com/github/awesome-copilot.git synced 2026-03-13 12:45:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix: resolve 27 broken links across Learning Hub articles

Browse Source 
- Fix double-path issue: ../learning-hub/X/ → ../X/ (9 links)
- Fix wrong depth for top-level pages: ../agents/ → ../../agents/ (4 links)
- Fix absolute paths missing base URL: /learning-hub/X/ → ../X/ (7 links)
- Fix dead file references: link to GitHub source instead (3 links)
- Verified 0 broken links remaining via Playwright crawl of all 12 articles

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
Aaron Powell
2026-02-26 14:48:23 +11:00
parent 0758c957c5
commit e0636e8165
11 changed files with 62 additions and 62 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
website/src/content/learning-hub/automating-with-hooks.md
View File

@@ -343,12 +343,12 @@ A: Yes. Hooks for the same event run in the order they appear in the array. If a
**Q: Do hooks work with the Copilot coding agent?**
A: Yes. Hooks are especially valuable with the coding agent because they provide deterministic guardrails for autonomous operations. See [Using the Copilot Coding Agent](../learning-hub/using-copilot-coding-agent/) for details.
A: Yes. Hooks are especially valuable with the coding agent because they provide deterministic guardrails for autonomous operations. See [Using the Copilot Coding Agent](../using-copilot-coding-agent/) for details.
## Next Steps
- **Explore Examples**: Browse the [Hooks Directory](../hooks/) for ready-to-use hook configurations
- **Build Agents**: [Building Custom Agents](../learning-hub/building-custom-agents/) — Create agents that complement hooks
- **Automate Further**: [Using the Copilot Coding Agent](../learning-hub/using-copilot-coding-agent/) — Run hooks in autonomous agent sessions
- **Explore Examples**: Browse the [Hooks Directory](../../hooks/) for ready-to-use hook configurations
- **Build Agents**: [Building Custom Agents](../building-custom-agents/) — Create agents that complement hooks
- **Automate Further**: [Using the Copilot Coding Agent](../using-copilot-coding-agent/) — Run hooks in autonomous agent sessions
---

2
website/src/content/learning-hub/before-after-customization-examples.md
View File

@@ -330,7 +330,7 @@ resource "azurerm_storage_account" "data" {
### After: With Terraform Custom Agent
Use a custom agent from the repository [`agents/terraform-azure-implement.agent.md`](../../agents/terraform-azure-implement.agent.md) (click through to see full definition).
Use a custom agent from the repository [`agents/terraform-azure-implement.agent.md`](https://github.com/github/awesome-copilot/blob/main/agents/terraform-azure-implement.agent.md) (click through to see full definition).
Now Copilot has access to a custom agent that enforces your organization's Terraform best practices for Azure.

14
website/src/content/learning-hub/building-custom-agents.md
View File

@@ -82,7 +82,7 @@ tools: ['codebase', 'terminal', 'github']
| `fetch` | Make HTTP requests to external APIs |
| `edit` | Modify files in the workspace |
For MCP server tools, reference them by server name (e.g., `postgres`, `docker`). See [Understanding MCP Servers](../learning-hub/understanding-mcp-servers/) for details.
For MCP server tools, reference them by server name (e.g., `postgres`, `docker`). See [Understanding MCP Servers](../understanding-mcp-servers/) for details.
### Agent Instructions
@@ -224,7 +224,7 @@ tools: ['codebase', 'terminal', 'postgres-mcp']
---
```
The agent can then query your database, analyze query plans, and suggest optimizations—all within the conversation. For setup details, see [Understanding MCP Servers](../learning-hub/understanding-mcp-servers/).
The agent can then query your database, analyze query plans, and suggest optimizations—all within the conversation. For setup details, see [Understanding MCP Servers](../understanding-mcp-servers/).
## Best Practices
@@ -273,7 +273,7 @@ A: Start with 2–3 agents for your most common workflows. Add more as patterns
**Q: Can I use an agent with the Copilot coding agent?**
A: Yes. When you assign an issue to Copilot, you can specify which agent should handle it. The agent's persona and tool access apply to the autonomous coding session. See [Using the Copilot Coding Agent](../learning-hub/using-copilot-coding-agent/) for details.
A: Yes. When you assign an issue to Copilot, you can specify which agent should handle it. The agent's persona and tool access apply to the autonomous coding session. See [Using the Copilot Coding Agent](../using-copilot-coding-agent/) for details.
**Q: Should agents include code examples?**
@@ -295,9 +295,9 @@ A: Yes, when defining output format or coding patterns. Show what you expect the
## Next Steps
- **Explore Repository Examples**: Browse the [Agents Directory](../agents/) for production agent definitions
- **Connect External Tools**: [Understanding MCP Servers](../learning-hub/understanding-mcp-servers/) — Give agents access to databases, APIs, and more
- **Automate with Coding Agent**: [Using the Copilot Coding Agent](../learning-hub/using-copilot-coding-agent/) — Run agents autonomously on issues
- **Add Reusable Tasks**: [Creating Effective Skills](../learning-hub/creating-effective-skills/) — Build tasks agents can discover and invoke
- **Explore Repository Examples**: Browse the [Agents Directory](../../agents/) for production agent definitions
- **Connect External Tools**: [Understanding MCP Servers](../understanding-mcp-servers/) — Give agents access to databases, APIs, and more
- **Automate with Coding Agent**: [Using the Copilot Coding Agent](../using-copilot-coding-agent/) — Run agents autonomously on issues
- **Add Reusable Tasks**: [Creating Effective Skills](../creating-effective-skills/) — Build tasks agents can discover and invoke
---

10
website/src/content/learning-hub/copilot-configuration-basics.md
View File

@@ -378,8 +378,8 @@ A: Use user-level settings in your IDE for personal preferences that should appl
Now that you understand Copilot configuration, explore how to create powerful customizations:
- **[What are Agents, Skills, and Instructions](../learning-hub/what-are-agents-skills-instructions/)** - Understand the customization types you can configure
- **[Understanding Copilot Context](../learning-hub/understanding-copilot-context/)** - Learn how configuration affects context usage
- **[Defining Custom Instructions](../learning-hub/defining-custom-instructions/)** - Create persistent context for your projects
- **[Creating Effective Skills](../learning-hub/creating-effective-skills/)** - Build reusable task folders with bundled assets
- **[Building Custom Agents](../learning-hub/building-custom-agents/)** - Develop specialized assistants
- **[What are Agents, Skills, and Instructions](../what-are-agents-skills-instructions/)** - Understand the customization types you can configure
- **[Understanding Copilot Context](../understanding-copilot-context/)** - Learn how configuration affects context usage
- **[Defining Custom Instructions](../defining-custom-instructions/)** - Create persistent context for your projects
- **[Creating Effective Skills](../creating-effective-skills/)** - Build reusable task folders with bundled assets
- **[Building Custom Agents](../building-custom-agents/)** - Develop specialized assistants

8
website/src/content/learning-hub/creating-effective-skills.md
View File

@@ -390,14 +390,14 @@ A: Yes, for clarity. Show examples of desired output format, patterns to follow,
Now that you understand effective skills, you can:
- **Explore Repository Examples**: Browse the [Skills Directory](../skills/) for production skills covering diverse workflows
- **Learn About Agents**: [Building Custom Agents](../learning-hub/building-custom-agents/) — When to upgrade from skills to full agents
- **Understand Instructions**: [Defining Custom Instructions](../learning-hub/defining-custom-instructions/) — Complement skills with automatic context
- **Explore Repository Examples**: Browse the [Skills Directory](../../skills/) for production skills covering diverse workflows
- **Learn About Agents**: [Building Custom Agents](../building-custom-agents/) — When to upgrade from skills to full agents
- **Understand Instructions**: [Defining Custom Instructions](../defining-custom-instructions/) — Complement skills with automatic context
- **Decision Framework**: Choosing the Right Customization _(coming soon)_ — When to use skills vs other types
**Suggested Reading Order**:
1. This article (creating effective skills)
2. [Building Custom Agents](../learning-hub/building-custom-agents/) — More sophisticated workflows
2. [Building Custom Agents](../building-custom-agents/) — More sophisticated workflows
3. Choosing the Right Customization _(coming soon)_ — Decision guidance
---

12
website/src/content/learning-hub/defining-custom-instructions.md
View File

@@ -306,12 +306,12 @@ A: No. Instructions are for persistent standards that apply repeatedly. Document
Now that you understand custom instructions, you can:
- **Explore Repository Examples**: Browse [Instructions Directory](../instructions/) - Over 120 real-world examples covering frameworks, languages, and domains
- **Learn About Skills**: [Creating Effective Skills](../learning-hub/creating-effective-skills/) - Discover when to use skills instead of instructions
- **Understand Agents**: [Building Custom Agents](../learning-hub/building-custom-agents/) - See how agents complement instructions for complex workflows
- **Configuration Basics**: [Copilot Configuration Basics](../learning-hub/copilot-configuration-basics/) - Learn how to organize and manage your customizations
- **Explore Repository Examples**: Browse [Instructions Directory](../../instructions/) - Over 120 real-world examples covering frameworks, languages, and domains
- **Learn About Skills**: [Creating Effective Skills](../creating-effective-skills/) - Discover when to use skills instead of instructions
- **Understand Agents**: [Building Custom Agents](../building-custom-agents/) - See how agents complement instructions for complex workflows
- **Configuration Basics**: [Copilot Configuration Basics](../copilot-configuration-basics/) - Learn how to organize and manage your customizations
**Suggested Reading Order**:
1. This article (defining custom instructions)
2. [Creating Effective Skills](../learning-hub/creating-effective-skills/) - Learn complementary customization type
3. [Building Custom Agents](../learning-hub/building-custom-agents/) - Decision framework for when to use each type
2. [Creating Effective Skills](../creating-effective-skills/) - Learn complementary customization type
3. [Building Custom Agents](../building-custom-agents/) - Decision framework for when to use each type

20
website/src/content/learning-hub/github-copilot-terminology-glossary.md
View File

@@ -30,7 +30,7 @@ A specialized configuration file (`*.agent.md`) that defines a GitHub Copilot pe
**When to use**: For recurring workflows that benefit from deep tooling integrations and persistent conversational context.
**Learn more**: [What are Agents, Skills, and Instructions](/learning-hub/what-are-agents-skills-instructions/)
**Learn more**: [What are Agents, Skills, and Instructions](../what-are-agents-skills-instructions/)
---
@@ -60,7 +60,7 @@ A curated grouping of related skills, instructions, and agents organized around
**Example**: The "Awesome Copilot" collection bundles meta-skills for discovering and generating GitHub Copilot customizations.
**Learn more**: [Collections README](../../docs/README.collections.md)
**Learn more**: [What are Agents, Skills, and Instructions](../what-are-agents-skills-instructions/)
---
@@ -126,7 +126,7 @@ A configuration file (`*.instructions.md`) that provides persistent background c
**When to use**: For long-lived guidance that applies across many sessions, like coding standards or compliance requirements.
**Learn more**: [What are Agents, Skills, and Instructions](/learning-hub/what-are-agents-skills-instructions/), [Defining Custom Instructions](/learning-hub/defining-custom-instructions/)
**Learn more**: [What are Agents, Skills, and Instructions](../what-are-agents-skills-instructions/), [Defining Custom Instructions](../defining-custom-instructions/)
---
@@ -146,7 +146,7 @@ The identity, tone, and behavioral characteristics defined for an [Agent](#agent
**Deprecated** — Prompts (`*.prompt.md`) were reusable chat templates that captured specific tasks or workflows, invoked using the `/` command in GitHub Copilot Chat. Prompts have been superseded by [Skills](#skill), which offer the same slash-command invocation plus agent discovery, bundled assets, and cross-platform portability.
If you have existing prompts, consider migrating them to skills. See [Creating Effective Skills](/learning-hub/creating-effective-skills/) for guidance.
If you have existing prompts, consider migrating them to skills. See [Creating Effective Skills](../creating-effective-skills/) for guidance.
**See**: [Skill](#skill)
@@ -165,7 +165,7 @@ A self-contained folder containing a `SKILL.md` file and optional bundled assets
**When to use**: For standardizing how Copilot responds to recurring tasks, especially when bundled resources improve quality.
**Learn more**: [What are Agents, Skills, and Instructions](/learning-hub/what-are-agents-skills-instructions/), [Creating Effective Skills](/learning-hub/creating-effective-skills/)
**Learn more**: [What are Agents, Skills, and Instructions](../what-are-agents-skills-instructions/), [Creating Effective Skills](../creating-effective-skills/)
---
@@ -177,7 +177,7 @@ A standardized protocol for connecting AI assistants like GitHub Copilot to exte
**Example**: An MCP server might provide access to your company's internal documentation, AWS resources, or a specific database system.
**Learn more**: [Model Context Protocol](https://modelcontextprotocol.io/) | [MCP Specification](https://spec.modelcontextprotocol.io/) | [Understanding MCP Servers](/learning-hub/understanding-mcp-servers/)
**Learn more**: [Model Context Protocol](https://modelcontextprotocol.io/) | [MCP Specification](https://spec.modelcontextprotocol.io/) | [Understanding MCP Servers](../understanding-mcp-servers/)
**Related terms**: [Tools](#tools), [Built-in Tool](#built-in-tool)
@@ -191,7 +191,7 @@ A shell command or script that runs automatically in response to lifecycle event
**When to use**: For deterministic automation that must happen reliably, like formatting code, running linters, or auditing prompts for compliance.
**Learn more**: [Automating with Hooks](/learning-hub/automating-with-hooks/)
**Learn more**: [Automating with Hooks](../automating-with-hooks/)
**Related terms**: [Agent](#agent), [Coding Agent](#coding-agent)
@@ -209,7 +209,7 @@ The autonomous GitHub Copilot agent that works on issues in a cloud environment
**When to use**: For well-defined tasks with clear acceptance criteria that can be completed autonomously.
**Learn more**: [Using the Copilot Coding Agent](/learning-hub/using-copilot-coding-agent/)
**Learn more**: [Using the Copilot Coding Agent](../using-copilot-coding-agent/)
**Related terms**: [Agent](#agent), [Hook](#hook)
@@ -223,7 +223,7 @@ An installable package that extends GitHub Copilot CLI with a bundled set of age
**When to use**: When you want to share a curated set of Copilot capabilities across multiple projects or team members, or when you want to install community-contributed tooling without manually copying files.
**Learn more**: [Installing and Using Plugins](/learning-hub/installing-and-using-plugins/)
**Learn more**: [Installing and Using Plugins](../installing-and-using-plugins/)
**Related terms**: [Agent](#agent), [Skill](#skill), [Hook](#hook)
@@ -247,4 +247,4 @@ tools: ['codebase', 'terminalCommand', 'github']
---
**Have a term you'd like to see added?** Contributions are welcome! See our [Contributing Guidelines](../../CONTRIBUTING.md) for how to suggest additions to this glossary.
**Have a term you'd like to see added?** Contributions are welcome! See our [Contributing Guidelines](https://github.com/github/awesome-copilot/blob/main/CONTRIBUTING.md) for how to suggest additions to this glossary.

16
website/src/content/learning-hub/installing-and-using-plugins.md
View File

@@ -119,7 +119,7 @@ Or from within an interactive Copilot session:
/plugin marketplace browse awesome-copilot
```
> **Tip**: You can also browse plugins on this site's [Plugins Directory](/plugins/) to see descriptions, included agents, and skills before installing.
> **Tip**: You can also browse plugins on this site's [Plugins Directory](../../plugins/) to see descriptions, included agents, and skills before installing.
### Adding More Marketplaces
@@ -188,7 +188,7 @@ This repository (`awesome-copilot`) serves as both a collection of individual re
### Install Individual Plugins
Browse the [Plugins Directory](/plugins/) and install specific plugins:
Browse the [Plugins Directory](../../plugins/) and install specific plugins:
```bash
copilot plugin install context-engineering@awesome-copilot
@@ -206,7 +206,7 @@ If you only need a single agent or skill (rather than a full plugin), you can st
- Copy a skill folder into `.github/skills/`
- Copy a hook configuration into `.github/hooks/`
See [Using the Copilot Coding Agent](../learning-hub/using-copilot-coding-agent/) for details on this approach.
See [Using the Copilot Coding Agent](../using-copilot-coding-agent/) for details on this approach.
## Best Practices
@@ -221,7 +221,7 @@ See [Using the Copilot Coding Agent](../learning-hub/using-copilot-coding-agent/
**Q: Do plugins work with the coding agent on GitHub.com?**
A: Plugins are specific to GitHub Copilot CLI and the VS Code extension (currently Insiders). For the coding agent on GitHub.com, add agents, skills, and hooks directly to your repository (via a plugin if you prefer!). See [Using the Copilot Coding Agent](../learning-hub/using-copilot-coding-agent/) for details.
A: Plugins are specific to GitHub Copilot CLI and the VS Code extension (currently Insiders). For the coding agent on GitHub.com, add agents, skills, and hooks directly to your repository (via a plugin if you prefer!). See [Using the Copilot Coding Agent](../using-copilot-coding-agent/) for details.
**Q: Can I use plugins and repository-level configuration together?**
@@ -241,9 +241,9 @@ A: The plugin's agents, skills, and hooks are removed from Copilot. Any work alr
## Next Steps
- **Browse Plugins**: Explore the [Plugins Directory](/plugins/) for installable plugin packages
- **Create Skills**: [Creating Effective Skills](../learning-hub/creating-effective-skills/) — Build skills that can be included in plugins
- **Build Agents**: [Building Custom Agents](../learning-hub/building-custom-agents/) — Create agents to package in plugins
- **Add Hooks**: [Automating with Hooks](../learning-hub/automating-with-hooks/) — Configure hooks for plugin automation
- **Browse Plugins**: Explore the [Plugins Directory](../../plugins/) for installable plugin packages
- **Create Skills**: [Creating Effective Skills](../creating-effective-skills/) — Build skills that can be included in plugins
- **Build Agents**: [Building Custom Agents](../building-custom-agents/) — Create agents to package in plugins
- **Add Hooks**: [Automating with Hooks](../automating-with-hooks/) — Configure hooks for plugin automation
---

6
website/src/content/learning-hub/understanding-copilot-context.md
View File

@@ -166,7 +166,7 @@ A: Yes, closing a file can remove it from Copilot's active context. However, fil
Now that you understand how context works in GitHub Copilot, explore these related topics:
- **[What are Agents, Skills, and Instructions](../learning-hub/what-are-agents-skills-instructions/)** - Learn about customization types that provide persistent context
- **[Copilot Configuration Basics](../learning-hub/copilot-configuration-basics/)** - Configure settings to optimize context usage
- **[Creating Effective Skills](../learning-hub/creating-effective-skills/)** - Use context effectively in your skills
- **[What are Agents, Skills, and Instructions](../what-are-agents-skills-instructions/)** - Learn about customization types that provide persistent context
- **[Copilot Configuration Basics](../copilot-configuration-basics/)** - Configure settings to optimize context usage
- **[Creating Effective Skills](../creating-effective-skills/)** - Use context effectively in your skills
- **Common Pitfalls and Solutions** _(coming soon)_ - Avoid context-related mistakes

6
website/src/content/learning-hub/understanding-mcp-servers.md
View File

@@ -186,7 +186,7 @@ If your team has internal tools or proprietary APIs, you can build custom MCP se
| **Resources** | Data the AI can read | Database schemas, API docs |
| **Prompts** | Pre-built conversation templates | Common troubleshooting flows |
MCP server SDKs are available in [Python](https://github.com/modelcontextprotocol/python-sdk), [TypeScript](https://github.com/modelcontextprotocol/typescript-sdk), and other languages. Browse the [Agents Directory](../agents/) for examples of agents built around MCP server expertise.
MCP server SDKs are available in [Python](https://github.com/modelcontextprotocol/python-sdk), [TypeScript](https://github.com/modelcontextprotocol/typescript-sdk), and other languages. Browse the [Agents Directory](../../agents/) for examples of agents built around MCP server expertise.
## Best Practices
@@ -216,8 +216,8 @@ A: There's no hard limit, but each server is a running process. Configure only t
## Next Steps
- **Build Agents**: [Building Custom Agents](../learning-hub/building-custom-agents/) — Create agents that leverage MCP tools
- **Explore Examples**: Browse the [Agents Directory](../agents/) for agents built around MCP server integrations
- **Build Agents**: [Building Custom Agents](../building-custom-agents/) — Create agents that leverage MCP tools
- **Explore Examples**: Browse the [Agents Directory](../../agents/) for agents built around MCP server integrations
- **Protocol Deep Dive**: [MCP Specification](https://spec.modelcontextprotocol.io/) — Learn the protocol details for building your own servers
---

22
website/src/content/learning-hub/using-copilot-coding-agent.md
View File

@@ -170,7 +170,7 @@ and write comprehensive unit and integration tests. Follow best practices for
the language and framework. Never modify production code unless asked.
```
> **Tip**: Browse the [Agents Directory](/agents/) on this site for ready-to-use agent profiles you can add to your repository.
> **Tip**: Browse the [Agents Directory](../../agents/) on this site for ready-to-use agent profiles you can add to your repository.
## Writing Effective Issues for the Coding Agent
@@ -307,7 +307,7 @@ When creating database migrations, follow this process:
| Can include scripts | No | Yes | No (but can reference skills) |
| Scope | File-pattern based | Task-based | Session-wide |
> **Tip**: Browse the [Skills Directory](/skills/) for ready-to-use skills you can add to your repository. Each skill includes a `SKILL.md` and any bundled assets needed.
> **Tip**: Browse the [Skills Directory](../../skills/) for ready-to-use skills you can add to your repository. Each skill includes a `SKILL.md` and any bundled assets needed.
## Leveraging Community Resources
@@ -315,19 +315,19 @@ This repository provides a curated collection of agents, skills, and hooks desig
### Adding Agents from This Repo
1. Browse the [Agents Directory](/agents/) for agents matching your needs
1. Browse the [Agents Directory](../../agents/) for agents matching your needs
2. Copy the `.agent.md` file into your repository's `.github/agents/` directory
3. The agent will be available in the dropdown when assigning work to the coding agent
### Adding Skills from This Repo
1. Browse the [Skills Directory](/skills/) for specialized skills
1. Browse the [Skills Directory](../../skills/) for specialized skills
2. Copy the entire skill folder into your repository's `.github/skills/` directory
3. The coding agent will automatically use the skill when it's relevant to a task
### Adding Hooks from This Repo
1. Browse the [Hooks Directory](/hooks/) for automation hooks
1. Browse the [Hooks Directory](../../hooks/) for automation hooks
2. Copy the `hooks.json` content into a file in `.github/hooks/` in your repository
3. Copy any referenced scripts alongside it
4. The hooks will run automatically during coding agent sessions
@@ -344,7 +344,7 @@ Hooks are especially valuable with the coding agent because they provide determi
- **`sessionStart`**: Log the start of autonomous sessions for governance
- **`sessionEnd`**: Send notifications when the agent finishes
See [Automating with Hooks](../learning-hub/automating-with-hooks/) for configuration details.
See [Automating with Hooks](../automating-with-hooks/) for configuration details.
## Best Practices
@@ -404,10 +404,10 @@ A: Yes. You can specify which agent to use when assigning work — the coding ag
## Next Steps
- **Set Up Your Environment**: Create `.github/copilot-setup-steps.yml` for your project
- **Create Skills**: [Creating Effective Skills](../learning-hub/creating-effective-skills/) — Build skills the coding agent can use automatically
- **Add Guardrails**: [Automating with Hooks](../learning-hub/automating-with-hooks/) — Ensure code quality in autonomous sessions
- **Build Custom Agents**: [Building Custom Agents](../learning-hub/building-custom-agents/) — Create specialized agents for the coding agent to use
- **Explore Configuration**: [Copilot Configuration Basics](../learning-hub/copilot-configuration-basics/) — Set up repository-level customizations
- **Browse Community Resources**: Explore the [Agents](/agents/), [Skills](/skills/), and [Hooks](/hooks/) directories for ready-to-use resources
- **Create Skills**: [Creating Effective Skills](../creating-effective-skills/) — Build skills the coding agent can use automatically
- **Add Guardrails**: [Automating with Hooks](../automating-with-hooks/) — Ensure code quality in autonomous sessions
- **Build Custom Agents**: [Building Custom Agents](../building-custom-agents/) — Create specialized agents for the coding agent to use
- **Explore Configuration**: [Copilot Configuration Basics](../copilot-configuration-basics/) — Set up repository-level customizations
- **Browse Community Resources**: Explore the [Agents](../../agents/), [Skills](../../skills/), and [Hooks](../../hooks/) directories for ready-to-use resources
---