Configuring your GitHub App for your Copilot extension

In the upper-right corner of any page on GitHub, click your profile photo.

Navigate to your account settings.

• For an app owned by a personal account, click Settings.
• For an app owned by an organization:
  1. Click Your organizations.
  2. To the right of the organization, click Settings.
• For an app owned by an enterprise:
  1. If you use Enterprise Managed Users, click Your enterprise to go directly to the enterprise account settings.
  2. If you use personal accounts, click Your enterprises and then to the right of the enterprise, click Settings.

Navigate to the GitHub App settings.

• For an app owned by a personal account or organization:
  1. In the left sidebar, click Developer settings, then click GitHub Apps.
• For an app owned by an enterprise:
  1. In the left sidebar, under "Settings", click GitHub Apps.

To the right of the GitHub App you want to configure for your Copilot Extension, click Edit.

In the "Identifying and authorizing users" section, under "Callback URL", enter your callback endpoint URL, then click Save changes.

In the left sidebar, click Permissions & events.

To expand the "Account permissions" section, click anywhere in the section.

In the "GitHub Copilot Chat" row, select the Access: dropdown menu, then click Read-only.

To enable the application to receive editor content (for example the currently opened file), in the "Copilot Editor Context" row, select the Access: dropdown menu, then click Read-only.

Click Save changes.

In the left sidebar, click Copilot.

Read the GitHub Marketplace Developer Agreement and the GitHub Pre-release License Terms, then accept the terms for creating a Copilot Extension.

In the "App type" section, select the dropdown menu, then click Skillset.

Your pre-authorization URL is a link on your website that starts the authorization process for your extension. Users will be redirected to this URL when they decide to authorize your extension. If you are using a pre-authorization URL, under "Pre-authorization URL," enter the URL, then click Save changes.

For each skill you want to add (maximum 5):

1. Click Add new skill.
2. Enter a clear Name for the skill (e.g., "Generate Lorem Ipsum Data").
3. Write a detailed Inference description to help Copilot understand when to use this skill.
4. Add your API endpoint URL that will receive the POST requests.
5. In the Parameter field, add the JSON schema defining the expected request format.
6. Click Add Definition to save your skill.

Click Save to save your skillset.

In your GitHub App settings, in the left sidebar, click Install App, then, next to the account you want to install your app on, click Install.

In the top right of any page on GitHub, click the GitHub Copilot icon next to the search bar.

The GitHub Copilot Chat panel is displayed. To resize the panel, click and drag the top or left edge.

If the panel contains a previous conversation you had with Copilot, click the "New conversation" icon (a plus sign) at the top right of the panel.

Invoke your extension by typing @EXTENSION-NAME, replacing any spaces in the extension name with -, then press Enter.

If this is your first time using the extension, you will be prompted to authenticate. Follow the steps on screen to authenticate your extension.

Ask your extension a question in the chat window. For example, What is the software development lifecycle?.