Skip to content

Repo sync #42754

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

Merged
docs-bot merged 3 commits into from
Feb 3, 2026
Merged

Repo sync #42754

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
eaf5671
Readability experiment "Preparing to use custom agents in your organi…
jclement136 Feb 3, 2026
dc9c764
Readability experiment "Reduce security debt" (#59429)
jclement136 Feb 3, 2026
4fd1aa8
Bump @isaacs/brace-expansion from 5.0.0 to 5.0.1 in the npm_and_yarn …
dependabot[bot] Feb 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
26 changes: 13 additions & 13 deletions ...how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Preparing to use custom agents in your organization
intro: 'Configure the repository that will contain {% data variables.copilot.custom_agents_short %} for your organization.'
intro: 'Configure the repository that stores {% data variables.copilot.custom_agents_short %} for your organization.'
permissions: Organization owners
versions:
feature: copilot
Expand All @@ -17,22 +17,22 @@ category:

## Prerequisites

Before following this article, you should understand what {% data variables.copilot.copilot_custom_agents %} are and how they work. See [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents).
You should understand what {% data variables.copilot.copilot_custom_agents %} are and how they work. See [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents).

> [!NOTE]
> If your organization is part of an enterprise, enterprise owners can configure a ruleset that restricts {% data variables.copilot.custom_agents_short %}. Contact your enterprise owners to check whether you can create and manage organization-level {% data variables.copilot.custom_agents_short %}.

## Preparing your organization for {% data variables.copilot.custom_agents_short %}

> [!NOTE]
> If your organization is part of an enterprise, your enterprise owners can configure a ruleset that restricts the creation and management of organization-level {% data variables.copilot.custom_agents_short %}. To understand the availability of {% data variables.copilot.custom_agents_short %} in your organization, contact your enterprise owners.

1. Start creating your {% data variables.copilot.copilot_custom_agent_short %} repository using [{% data variables.product.github %}'s template repository](https://github.com/docs/custom-agents-template?ref_product=copilot&ref_type=engagement&ref_style=text). The template repository contains a starter README and the necessary file structure to speed up your configuration.
1. Select the **Choose an owner** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle-down" %} dropdown menu, then click your organization.
1. Name the repository `.github-private`, then write a brief description.
1. Select the visibility dropdown menu, then choose one of the following options:
* To grant **read access to all members** of your organization or enterprise, click {% octicon "organization" aria-hidden="true" aria-label="organization" %} **Internal**.
* To **manually grant access after creation**, or if internal visibility is not an option, click {% octicon "lock" aria-hidden="true" aria-label="lock" %} **Private**.
1. Create your {% data variables.copilot.copilot_custom_agent_short %} repository using [{% data variables.product.github %}'s template repository](https://github.com/docs/custom-agents-template?ref_product=copilot&ref_type=engagement&ref_style=text). The template includes a README and the file structure you need.
1. In the **Choose an owner** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle-down" %} dropdown menu, choose your organization.
1. Name the repository `.github-private` and write a brief description.
1. In the visibility dropdown menu, choose one of the following options:
* Click {% octicon "organization" aria-hidden="true" aria-label="organization" %} **Internal** to grant read access to all members of your organization or enterprise.
* Click {% octicon "lock" aria-hidden="true" aria-label="lock" %} **Private** to manually grant access after creation or if internal visibility is not an option.
{% data reusables.repositories.create-repo %}
1. Update the template README as needed. Consider including creation guidelines for {% data variables.copilot.custom_agents_short %} or compliance considerations specific to your organization.
1. Update the template README. Include any creation guidelines for {% data variables.copilot.custom_agents_short %} or compliance considerations specific to your organization.

## Next steps

To implement {% data variables.copilot.custom_agents_short %} in your organization, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents).
To trial {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents).
Loading