From e0636e8165603587cc3101243617b8ff319c0549 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Thu, 26 Feb 2026 14:48:23 +1100 Subject: [PATCH] fix: resolve 27 broken links across Learning Hub articles MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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> --- .../learning-hub/automating-with-hooks.md | 8 +++---- .../before-after-customization-examples.md | 2 +- .../learning-hub/building-custom-agents.md | 14 ++++++------ .../copilot-configuration-basics.md | 10 ++++----- .../learning-hub/creating-effective-skills.md | 8 +++---- .../defining-custom-instructions.md | 12 +++++----- .../github-copilot-terminology-glossary.md | 20 ++++++++--------- .../installing-and-using-plugins.md | 16 +++++++------- .../understanding-copilot-context.md | 6 ++--- .../learning-hub/understanding-mcp-servers.md | 6 ++--- .../using-copilot-coding-agent.md | 22 +++++++++---------- 11 files changed, 62 insertions(+), 62 deletions(-) diff --git a/website/src/content/learning-hub/automating-with-hooks.md b/website/src/content/learning-hub/automating-with-hooks.md index 1536068c..79be9dd0 100644 --- a/website/src/content/learning-hub/automating-with-hooks.md +++ b/website/src/content/learning-hub/automating-with-hooks.md @@ -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 --- diff --git a/website/src/content/learning-hub/before-after-customization-examples.md b/website/src/content/learning-hub/before-after-customization-examples.md index e7b3dac7..2c4f534d 100644 --- a/website/src/content/learning-hub/before-after-customization-examples.md +++ b/website/src/content/learning-hub/before-after-customization-examples.md @@ -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. diff --git a/website/src/content/learning-hub/building-custom-agents.md b/website/src/content/learning-hub/building-custom-agents.md index 9d15ba74..077bace0 100644 --- a/website/src/content/learning-hub/building-custom-agents.md +++ b/website/src/content/learning-hub/building-custom-agents.md @@ -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 --- diff --git a/website/src/content/learning-hub/copilot-configuration-basics.md b/website/src/content/learning-hub/copilot-configuration-basics.md index dd936542..a870a902 100644 --- a/website/src/content/learning-hub/copilot-configuration-basics.md +++ b/website/src/content/learning-hub/copilot-configuration-basics.md @@ -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 diff --git a/website/src/content/learning-hub/creating-effective-skills.md b/website/src/content/learning-hub/creating-effective-skills.md index 509dc824..2c047702 100644 --- a/website/src/content/learning-hub/creating-effective-skills.md +++ b/website/src/content/learning-hub/creating-effective-skills.md @@ -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 --- diff --git a/website/src/content/learning-hub/defining-custom-instructions.md b/website/src/content/learning-hub/defining-custom-instructions.md index 99aa7d32..6b4465f2 100644 --- a/website/src/content/learning-hub/defining-custom-instructions.md +++ b/website/src/content/learning-hub/defining-custom-instructions.md @@ -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 diff --git a/website/src/content/learning-hub/github-copilot-terminology-glossary.md b/website/src/content/learning-hub/github-copilot-terminology-glossary.md index d04704bf..d6b542ef 100644 --- a/website/src/content/learning-hub/github-copilot-terminology-glossary.md +++ b/website/src/content/learning-hub/github-copilot-terminology-glossary.md @@ -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. diff --git a/website/src/content/learning-hub/installing-and-using-plugins.md b/website/src/content/learning-hub/installing-and-using-plugins.md index f4598a71..d66b2682 100644 --- a/website/src/content/learning-hub/installing-and-using-plugins.md +++ b/website/src/content/learning-hub/installing-and-using-plugins.md @@ -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 --- diff --git a/website/src/content/learning-hub/understanding-copilot-context.md b/website/src/content/learning-hub/understanding-copilot-context.md index 4f007e06..4f4cfb76 100644 --- a/website/src/content/learning-hub/understanding-copilot-context.md +++ b/website/src/content/learning-hub/understanding-copilot-context.md @@ -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 diff --git a/website/src/content/learning-hub/understanding-mcp-servers.md b/website/src/content/learning-hub/understanding-mcp-servers.md index d0f4ab1a..ef4b0277 100644 --- a/website/src/content/learning-hub/understanding-mcp-servers.md +++ b/website/src/content/learning-hub/understanding-mcp-servers.md @@ -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 --- diff --git a/website/src/content/learning-hub/using-copilot-coding-agent.md b/website/src/content/learning-hub/using-copilot-coding-agent.md index 264abafd..4a4f467a 100644 --- a/website/src/content/learning-hub/using-copilot-coding-agent.md +++ b/website/src/content/learning-hub/using-copilot-coding-agent.md @@ -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 ---