Brave Copilot

What is Brave Copilot?

Brave Copilot is AFRY's inner-source repository of skills, custom agents, and instructions for GitHub Copilot (and other AI agents). It packages AFRY-specific domain knowledge - brand standards, Azure patterns, DevOps workflows, presentation templates, vibe coding pipelines - into reusable files that any AFRY employee can plug into their VS Code setup.

Instead of every team rediscovering how to do the same things, Brave Copilot is the shared library that grows as colleagues contribute.

The repository lives at: github.com/afry-innersource/brave-copilot

Two types of content

Brave Copilot contains two kinds of customisation files:

Type File format How to invoke What it does
Skills SKILL.md in a named folder Mention the skill name in a prompt Gives Copilot a detailed script for a specific task
Custom agents .agent.md Pick from the agents dropdown Defines a named Copilot persona with restricted tools and instructions

Skills and agents (and MCP tools) work together - an agent can invoke skills and tools as part of its workflow.

Available skills

Skill What it does
afry-brand-style-guide Applies AFRY's official colours, typography, and layout rules to any artefact - presentations, web UIs, documents
powerpoint-sketch-writer Drafts a presentation as numbered markdown slide files - a planning step before building the real deck
powerpoint-deck-builder Builds a real AFRY-branded .pptx from a markdown sketch using the PowerPoint MCP server - requires the PowerPoint MCP server (see section 13)
vibe-create-web-app Scaffolds a React + Vite + Tailwind CSS web app - requiresNode.js (see section 5)
vibe-add-pwa Makes an existing Vite app installable as a PWA (phone, tablet, desktop)
vibe-add-backend Adds an Azure Functions API backend to a Vite app - requiresNode.js and Azure CLI
vibe-add-llm Provisions Azure OpenAI and wires up a /api/chat streaming endpoint - requires Azure CLI
vibe-add-auth-for-swa Adds AFRY-only Entra ID sign-in to a deployed Azure Static Web App - requiresAzure CLI and an App Registration
vibe-deploy-app Detects your project type and deploys it to Azure (orchestrator) - requiresAzure CLI and GitHub CLI
vibe-add-remote-store Provisions Cosmos DB and wires it into the Functions backend - requiresAzure CLI
vibe-add-entity Generates a TypeScript type, repository, and API endpoint for a new data entity
vibe-add-data-access Changes who can read or write an entity: user-only, public, or group-shared
vibe-add-local-store Adds browser-side storage (localStorage or IndexedDB) - no Azure required

The vibe coding skills are designed to work as a chain - create → add backend → add auth → add data → deploy. Each step extends the previous one. Before running any vibe coding skill, make sure the software listed in section 5 is installed.

Available agents

research - Deep-research agent. You give it a topic; it proposes research perspectives, confirms with you, then runs parallel web searches (using the Foundation websearch MCP tool) and assembles a structured report. A final review pass checks the report for gaps and unsupported claims.

To use it, select research from the agents dropdown and describe what you want to research. The agent handles the rest - you can follow along as it works.

How to install

Prerequisites

You need Git installed before you can clone the repository. Git installation is covered in section 5. Individual skills may also require additional software such as Node.js, Azure CLI, or specific MCP servers - check the notes in the skills table above and section 13 for MCP setup.

Skills and agents must be placed inside your home directory (C:\Users\YourName\ on Windows, ~/ on Mac/Linux). VS Code does not pick them up from other locations.

Step 1 - Clone the repository into your home directory

  1. Open VS Code
  2. Press Ctrl+Shift+P to open the Command Palette
  3. Type Git: Clone and select it
  4. Enter the repository URL: 
    https://github.com/afry-innersource/brave-copilot.git
  5. When asked where to clone, choose a folder inside your home directory - for example C:\Users\YourName\repos\ - and confirm

VS Code will clone the repository and offer to open it. You can close it afterwards; you do not need to keep it open to use the skills.

Step 2 - Register the skills folder in VS Code

As described in section 10, open VS Code Settings (Ctrl+,), search for skills, and add the path to the cloned skills/ folder:

  • Under Chat: Agent Skills Locations, add the path to brave-copilot/skills
  • Under Chat: Prompt Files Locations, add the same path

For example: C:\Users\YourName\repos\brave-copilot\skills

Step 3 - Copy the agents to your home folder

Copy the .agent.md files from the cloned agents/ folder into:

C:\Users\YourName\.copilot\agents\

Create the .copilot\agents\ folder if it does not exist yet. VS Code looks in this location automatically for user-scoped agents.

Verify

Type / in the Copilot chat input - the Brave Copilot skills should appear as slash commands. Open the agents dropdown and check that research is listed.

Using a skill

Once installed, invoke a skill by mentioning its name in a prompt:

"Using the afry-brand-style-guide skill, apply AFRY styling to this HTML page."

"Run the vibe-create-web-app skill to scaffold a new app for tracking team decisions."

You can also type / followed by the skill name to use it as a slash command.

Contributing

Brave Copilot is an inner-source repository - any AFRY employee can contribute a skill.

  1. Fork the repository
  2. Create a folder under skills/ with your skill name (e.g. skills/my-skill/)
  3. Write a SKILL.md with YAML frontmatter (name, description) and your instruction body
  4. Open a pull request with a short description of what the skill enables

The skill does not need to be perfect on the first attempt. A useful rough skill is more valuable than no skill at all. Copilot can even help you write the SKILL.md file - after a successful interaction, type /create-skill in the chat input and Copilot will draft the skill file from the conversation.

Community

Brave Copilot is a living library. AFRY teams across disciplines are building their own skill collections:

  • Data and AI Platform - MCP server automation, pipeline orchestration, Azure search and index configuration
  • Finance - Sprint reports, Azure DevOps work item creation, team status summaries
  • Vibe Coding - The full create → deploy → auth → data → LLM chain

If your team has a workflow that you have taught Copilot once, it probably belongs in Brave Copilot so the rest of AFRY can benefit too.