A collection of beginner-friendly custom GitHub Copilot agents to get you started with AI-assisted development.
m👀agents is a starter toolkit of custom agents designed for developers new to GitHub Copilot. It provides ready-to-use agents that enhance Copilot's capabilities for common tasks like creating documentation and code templates.
Whether you're exploring custom agents for the first time or building on existing skills, this collection demonstrates how to create and use specialized AI personas in your workflow.
Option 1: Clone for local experimentation
git clone https://github.com/m00sp/m00agents.git
cd m00agentsOption 2: Fork to your GitHub account
# Visit: https://github.com/m00sp/m00agents/fork
# Then clone your fork
git clone https://github.com/YOUR-USERNAME/m00agents.git
cd m00agentsCopy agents to your local Copilot configuration:
# Copy to user-level agents (available in all projects)
cp agents/*.agent.md ~/.copilot/agents/Or for repository-specific use:
# Copy to repository-level agents (available only in this project)
mkdir -p .github/agents
cp agents/*.agent.md .github/agents/# List available agents
copilot /agent
# Or specify an agent directly
copilot --agent=docs-creator --prompt "Create documentation for..."
copilot --agent=readme-creator --prompt "Generate a README..."This repository includes specialized agents organized by domain:
| Agent | Purpose |
|---|---|
| m👀readme-creator | Creates and improves README files with clear structure, installation guides, and project overview |
| docs-creator | Generates clear, user-friendly technical documentation |
| Agent | Purpose |
|---|---|
| C++ Expert | Provide expert C++ software engineering guidance using modern C++ and industry best practices |
| m👀Rust Expert for Beginners | Expert Rust guidance for beginners, emphasizing ownership, safety, and idiomatic patterns |
| Custom Agent Foundry | Expert at designing, creating and improving custom agents with optimal configurations |
| Agent | Purpose |
|---|---|
| Arch Linux Expert | Arch Linux specialist focused on pacman, rolling-release maintenance, and system administration |
| m👀Alpine Linux Expert | Alpine Linux specialist focused on apk, lightweight systems, and minimal system administration |
| m👀Artix Linux Expert | Artix Linux specialist focused on pacman, rolling-release maintenance, and OpenRC workflows |
| CentOS Linux Expert | CentOS (Stream/Legacy) specialist focused on RHEL-compatible administration and yum/dnf workflows |
| Debian Linux Expert | Debian specialist focused on stable system administration, apt-based package management |
| Fedora Linux Expert | Fedora (Red Hat family) specialist focused on dnf, SELinux, and systemd-based workflows |
| m👀Gentoo Linux Expert | Gentoo specialist focused on portage, source-based compilation, and USE flags |
| Agent | Purpose |
|---|---|
| Accessibility Expert | Expert assistant for web accessibility (WCAG 2.1/2.2), inclusive UX, and a11y testing |
| Agent | Purpose |
|---|---|
| Plan Mode - Strategic Planning & Architecture | Strategic planning and architecture assistant focused on thoughtful analysis before implementation |
| Planning mode | Generate an implementation plan for new features or refactoring existing code |
Each agent is tailored to help you quickly produce professional results with minimal setup.
- Quick Start Tutorial - Step-by-step guide to understanding and using Copilot agents
- Detailed Agent Guide - In-depth documentation about custom agents and how to create your own
- Agent Template - Reference template for building your own custom agents
Custom agents are specialized AI personas you can create to enhance Copilot for specific workflows. You can:
- Define them at the user level (all your projects)
- Define them at the repository level (one specific project)
- Define them at the organization level (for teams)
Learn more in the official GitHub Copilot documentation.
m00agents/
├── agents/ # Custom Copilot agents (.agent.md files)
├── skills/ # Skills for enhanced Copilot capabilities (new!)
├── docs/ # Guides and tutorials
├── assets/ # Icons and visual assets
├── instructions/ # Project guidelines
└── README.md # This file
What's New: The skills/ directory contains additional skill modules to extend Copilot's capabilities beyond the base agents.
This project was inspired by:
- 📖 How to write a great agents.md by Matt Nigh - Essential reading for agent creators
- ⭐ Awesome GitHub Copilot - Community collection of Copilot resources
The agents in this repository are examples created for learning and experimentation. GitHub does not verify, endorse, or guarantee their functionality or security. Always inspect agents and their documentation before use.