{"id":51198994,"url":"https://github.com/defuj/copilot-agent-kit","last_synced_at":"2026-06-27T23:02:44.743Z","repository":{"id":361845619,"uuid":"1255575033","full_name":"defuj/copilot-agent-kit","owner":"defuj","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-01T14:27:20.000Z","size":259,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-01T15:10:40.050Z","etag":null,"topics":["agentic-ai","ai-agents","copilot","copilot-coding-agent"],"latest_commit_sha":null,"homepage":"https://defuj.github.io/copilot-agent-kit/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/defuj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-01T01:27:42.000Z","updated_at":"2026-06-01T14:55:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/defuj/copilot-agent-kit","commit_stats":null,"previous_names":["defuj/copilot-agent-kit"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/defuj/copilot-agent-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defuj%2Fcopilot-agent-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defuj%2Fcopilot-agent-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defuj%2Fcopilot-agent-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defuj%2Fcopilot-agent-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/defuj","download_url":"https://codeload.github.com/defuj/copilot-agent-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defuj%2Fcopilot-agent-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34870654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","ai-agents","copilot","copilot-coding-agent"],"created_at":"2026-06-27T23:02:44.022Z","updated_at":"2026-06-27T23:02:44.737Z","avatar_url":"https://github.com/defuj.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/defuj/copilot-agent-kit/main/assets/og-image.webp\" alt=\"Copilot Agent KIT Banner\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n# Agent Kit — Setup Guide\n\nComplete setup guide for the **Agent Kit** — a portable multi-stack AI agent system for GitHub Copilot. Includes 13 specialized agents, 62 skill playbooks, 36 slash commands, and 6 MCP servers.\n\n```bash\nnpx copilot-agent-kit init\n```\n\n---\n\n## Quick Install\n\n```bash\nnpx copilot-agent-kit init\n```\n\nThis copies the full agent configuration into your project's `.github/agents/`, `.github/hooks/`, and `.github/workflows/` directories. Safe for existing projects — no overwrite.\n\nGlobal install:\n\n```bash\nnpm install -g copilot-agent-kit\ncd /path/to/your-project\ncopilot-agent-kit init\n```\n\n---\n\n## Overview\n\nThink of Agent Kit as an AI development team you install into any GitHub Copilot project. An **IT Leader** orchestrates 12 specialized subagents — each one an expert in their stack. You describe what to build; the team handles the rest.\n\nThis repository contains a complete GitHub Copilot agent configuration with **13 Custom Agents** (1 primary orchestrator + 12 subagents) for software development teams.\n\n### Agent Config\n\n- Agent profiles: `.github/agents/`\n  - `it-leader.agent.md` — IT Leader \u0026 Technical Project Manager (primary)\n  - `frontend-nuxt.agent.md` — Frontend Developer (Nuxt/Vue) — `@frontend-nuxt`\n  - `frontend-react.agent.md` — Frontend Developer (React/Next.js) — `@frontend-react`\n  - `backend.agent.md` — Backend Developer (Node.js) — `@backend`\n  - `laravel.agent.md` — Backend Developer (Laravel) — `@laravel`\n  - `ci3.agent.md` — Fullstack Developer (CodeIgniter 3) — `@ci3`\n  - `designer.agent.md` — UI/UX Designer — `@designer`\n  - `reviewer.agent.md` — Code Reviewer / QA — `@reviewer`\n  - `database.agent.md` — Database Specialist — `@database`\n  - `devops.agent.md` — DevOps / Infrastructure — `@devops`\n  - `seo.agent.md` — SEO Specialist — `@seo`\n  - `android.agent.md` — Android Developer (Kotlin/Compose) — `@android`\n  - `flutter.agent.md` — Flutter Developer (Dart) — `@flutter`\n- Automation hooks: `.github/hooks/`\n- CI/CD workflows: `.github/workflows/`\n\nDesigned for:\n\n- **Frontend (Vue)**: Nuxt 4 + Nuxt UI + Vue 3 Composition API + TypeScript\n- **Frontend (React)**: React 19 + Next.js 15 (App Router) + TypeScript + shadcn/ui\n- **Backend**: Node.js + Express 5 + Prisma + PostgreSQL — or — Laravel 10+ / CodeIgniter 3\n- **Mobile**: Android (Kotlin + Jetpack Compose) — or — Flutter (Dart)\n\n## Installation\n\n### New Project (NPM Package — Recommended)\n\n```bash\ncd /path/to/your-project\nnpx copilot-agent-kit init\n```\n\nThis copies `.github/agents/`, `.github/hooks/`, and `.github/workflows/` into your project. Existing files are preserved.\n\n### What Gets Installed\n\n| File/Folder          | Content                         | Required |\n| -------------------- | ------------------------------- | -------- |\n| `.github/agents/`    | 13 agent profiles (`.agent.md`) | Yes      |\n| `.github/hooks/`     | Automation hooks                | Optional |\n| `.github/workflows/` | Copilot setup steps workflow    | Optional |\n\n### Manual Copy\n\n```bash\ncp -R .github/agents /path/to/your-project/.github/agents/\n```\n\n### Verify Setup\n\nAfter installation, go to [github.com/copilot/agents](https://github.com/copilot/agents) and select your repository. Click the agent selector to choose from 13 specialized agents.\n\n## Available Agents\n\n13 agents with **Leader → Subagent** architecture:\n\n| Agent                 | File                      | Role                                                 |\n| --------------------- | ------------------------- | ---------------------------------------------------- |\n| **IT Leader**         | `it-leader.agent.md`      | Requirements analysis, architecture, task delegation |\n| Frontend (Vue/Nuxt)   | `frontend-nuxt.agent.md`  | Vue/Nuxt implementation (components, Nuxt UI)        |\n| Frontend (React/Next) | `frontend-react.agent.md` | React/Next.js implementation (RSC, shadcn/ui)        |\n| Backend (Node.js)     | `backend.agent.md`        | Node.js API (Express, Prisma, DTO)                   |\n| Backend (Laravel)     | `laravel.agent.md`        | Laravel (Blade, Livewire, REST API)                  |\n| CodeIgniter 3         | `ci3.agent.md`            | CI3 MVC, REST API, JWT                               |\n| UI/UX Designer        | `designer.agent.md`       | Design system, Stitch, accessibility                 |\n| Code Reviewer / QA    | `reviewer.agent.md`       | Code quality, security audit, testing strategy       |\n| Database Specialist   | `database.agent.md`       | PostgreSQL schema, query optimization, migrations    |\n| DevOps / Infra        | `devops.agent.md`         | CI/CD, Docker, monitoring, infrastructure            |\n| SEO Specialist        | `seo.agent.md`            | Meta tags, structured data, Core Web Vitals          |\n| Android Developer     | `android.agent.md`        | Kotlin, Jetpack Compose, Gradle, Play Store          |\n| Flutter Developer     | `flutter.agent.md`        | Dart, Flutter SDK, Material 3, Firebase              |\n\n### Workflow\n\n```\nUser Request\n    │\n    ▼\n┌─────────────────┐\n│   IT Leader     │ ← Primary orchestrator\n│ (Primary)      │\n└────────┬────────┘\n         │\n    ┌────┴────┬──────┬──────┬──────┬──────┬──────┐\n    ▼         ▼      ▼      ▼      ▼      ▼      ▼\n┌────────┐ ┌──────┐ ┌───┐ ┌────┐ ┌────┐ ┌────┐ ┌──────┐\n│Frontend│ │Backend│ │Des│ │Rev │ │DB  │ │Dev │ │Mobile│\n│Nuxt/React│ │Node/La│ │ign│ │iew │ │Spec│ │Ops │ │And/Fl│\n└───┬────┘ └──┬───┘ └───┘ └────┘ └────┘ └────┘ └──┬───┘\n    │         │                                    │\n    └─────────┴────────────────────────────────────┘\n                      │\n                      ▼\n          ┌──────────────────────────┐\n          │   Integration Report      │\n          │ (IT Leader combines)     │\n          └──────────────────────────┘\n```\n\n### How It Works\n\n1. You describe what you need — a feature, a bug fix, a full app\n2. The **IT Leader** analyzes requirements, designs architecture, and breaks the work into tasks\n3. Tasks are delegated to the right subagents — frontend, backend, mobile, designer, reviewer\n4. The IT Leader integrates results and reports back with verification status\n\nFor small tasks, mention subagents directly with `@mention`:\n\n```text\n@frontend-nuxt Add a UButton \"Save\" in ProfileHeader.vue.\n@frontend-react Create a server component ProductList with API fetch.\n@backend Add endpoint POST /api/markets with DTO validation.\n@laravel Build a CRUD product page with Blade + Livewire.\n@ci3 Build a REST API for products with JWT auth.\n@designer Review UX flow for checkout page.\n@reviewer Audit security for the authentication module.\n@database Optimize query for market listing with pagination.\n@devops Setup CI/CD pipeline for Vercel deployment.\n@seo Implement meta tags and structured data for product pages.\n@android Build a login screen with Jetpack Compose + ViewModel.\n@flutter Build a product list screen with Bloc pattern.\n```\n\n## Skills\n\nSkills provide specialized instructions and workflows for specific tasks.\n\n### Skills per Agent\n\n| Agent                      | Key Skills                                                                                                                                                                                                                                     |\n| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| IT Leader                  | coding-standards, backend-patterns, frontend-patterns                                                                                                                                                                                          |\n| Frontend Developer (Vue)   | coding-standards, frontend-patterns, frontend-design, web-design-guidelines, nuxt-ui                                                                                                                                                           |\n| Frontend Developer (React) | coding-standards, frontend-patterns, frontend-design, web-design-guidelines, vercel-react-best-practices, vercel-composition-patterns                                                                                                          |\n| Backend Developer          | coding-standards, backend-patterns, postgres-patterns, security-review                                                                                                                                                                         |\n| UI/UX Designer             | frontend-design, web-design-guidelines, building-components, nuxt-ui                                                                                                                                                                           |\n| Code Reviewer / QA         | coding-standards, security-review, web-design-guidelines                                                                                                                                                                                       |\n| Database Specialist        | postgres-patterns, backend-patterns                                                                                                                                                                                                            |\n| DevOps / Infrastructure    | backend-patterns, coding-standards                                                                                                                                                                                                             |\n| SEO Specialist             | frontend-patterns, web-design-guidelines, nuxt-ui                                                                                                                                                                                              |\n| **Android Developer**      | coding-standards, android-jetpack-compose, edge-to-edge, navigation-3, firebase-basics, play-billing, camera1-to-camerax, r8-analyzer, migrate-xml-views-to-jetpack-compose, gpc-setup, gpc-release-flow, gpc-preflight, gpc-vitals-monitoring |\n| **Flutter Developer**      | coding-standards, flutter (patterns), 10 Flutter skills, 9 Dart skills, firebase-basics                                                                                                                                                        |\n\n### Skill Locations\n\nSkills are loaded from available locations. Quick verification:\n\n```bash\nls ~/.agents/skills\n```\n\nIf skills are not yet on your machine, copy them from this repo:\n\n```bash\n# Core skills\nmkdir -p ~/.agents/skills\ncp -R ./.agents/skills/coding-standards ~/.agents/skills/\ncp -R ./.agents/skills/frontend-patterns ~/.agents/skills/\ncp -R ./.agents/skills/frontend-design ~/.agents/skills/\ncp -R ./.agents/skills/web-design-guidelines ~/.agents/skills/\ncp -R ./.agents/skills/nuxt-ui ~/.agents/skills/\ncp -R ./.agents/skills/security-review ~/.agents/skills/\n```\n\n### Mobile Skills\n\n```bash\n# Flutter patterns \u0026 task skills\ncp -R ./.agents/skills/flutter ~/.agents/skills/\ncp -R ./.agents/skills/flutter-* ~/.agents/skills/\ncp -R ./.agents/skills/dart-* ~/.agents/skills/\ncp -R ./.agents/skills/jetpack-compose ~/.agents/skills/\ncp -R ./.agents/skills/firebase-basics ~/.agents/skills/\n```\n\n## MCP Configuration\n\nFor Nuxt, Nuxt UI, Playwright, and Postman MCP support, add this to your repo **Settings \u003e Copilot \u003e Cloud agent \u003e MCP configuration**:\n\n```json\n{\n  \"mcpServers\": {\n    \"nuxt\": {\n      \"type\": \"remote\",\n      \"url\": \"https://nuxt-mcp.vercel.app\",\n      \"tools\": [\"*\"]\n    },\n    \"nuxt-ui\": {\n      \"type\": \"remote\",\n      \"url\": \"https://nuxt-ui-mcp.vercel.app\",\n      \"tools\": [\"*\"]\n    },\n    \"playwright\": {\n      \"type\": \"local\",\n      \"command\": \"npx\",\n      \"args\": [\"@playwright/mcp\"],\n      \"tools\": [\"*\"]\n    },\n    \"postman\": {\n      \"type\": \"remote\",\n      \"url\": \"https://api.postman.com\",\n      \"tools\": [\"*\"]\n    }\n  }\n}\n```\n\nTo enable Figma MCP:\n\n```bash\nexport FIGMA_ACCESS_TOKEN=\"your-token\"\n```\n\nTo enable Google Stitch MCP:\n\n```bash\nexport STITCH_API_KEY=\"your-api-key\"\n```\n\n## Available Commands\n\n```bash\n# Planning \u0026 Architecture\n/plan [feature description]          # Detailed implementation plan\n/orchestrate [complex task]         # Multi-agent orchestration\n\n# Review \u0026 Quality\n/code-review [files]                 # Code quality review\n/security [files]                     # Security audit\n/refactor-clean [scope]              # Dead code cleanup\n\n# Testing\n/tdd [feature]                       # TDD workflow\n/e2e [user flow]                     # Generate \u0026 run E2E tests\n/test-coverage [scope]               # Analyze coverage\n\n# Build \u0026 Errors\n/build-fix [error message]           # Fix TypeScript/build errors\n\n# Documentation\n/update-docs [files]                 # Update documentation\n/update-codemaps                     # Update code references\n\n# Mobile\n/android-build [variant]              # Build Android (debug/release/bundle)\n/android-test [type]                  # Run Android tests (unit/instrumented)\n/flutter-build [target]               # Build Flutter (apk/appbundle/ios/web)\n/flutter-test [type]                  # Run Flutter tests with coverage\n/gpc-release [track]                  # Publish to Google Play\n```\n\n## Usage\n\n### Main Workflow (via IT Leader)\n\nThe IT Leader is the **primary agent** — auto-activated when a session starts. Give it your requirements:\n\n```text\nBuild a marketplace feature with listing, detail, and create pages.\nBackend API for CRUD markets with pagination and filters.\nSetup CI/CD pipeline and SEO optimization.\n```\n\nThe IT Leader will:\n\n1. Analyze requirements and define scope\n2. Design architecture (data flow, API contract, component structure)\n3. Break into tasks and delegate to the right subagents\n4. Integrate results and report status\n\n### Direct Subagent Calls (small tasks)\n\nFor small tasks, mention subagents directly:\n\n```text\n@frontend-nuxt Add a UButton \"Save\" in app/components/profile/ProfileHeader.vue.\nTask tiny, minimal diff, don't touch other files.\n```\n\n```text\n@frontend-nuxt Implement status filters on the markets page.\nUse the existing useApi pattern and report verification status.\n```\n\n```text\n@backend Add endpoint POST /api/markets with DTO validation.\n```\n\n```text\n@designer Create a design system for the product page with Nuxt UI.\n```\n\n```text\n@reviewer Audit security for the authentication module.\n```\n\n```text\n@database Optimize query for market listing with pagination.\n```\n\n```text\n@devops Setup CI/CD pipeline for Vercel deployment.\n```\n\n```text\n@seo Implement meta tags and structured data for product pages.\n```\n\n## Agent Output Standards\n\nAgents are configured to always report:\n\n- Changes made\n- Files touched\n- Verification status: `verified` / `partially_verified` / `not_verified`\n- Manual commands if full verification cannot be run\n\n## Operational Policies\n\n- No commits unless requested by the user\n- No PRs unless requested by the user\n- No pushes unless requested by the user\n- No touching files outside the request scope\n\n## Quick Reference\n\n- Agent profiles: `.github/agents/`\n- Automation hooks: `.github/hooks/`\n- CI/CD workflows: `.github/workflows/`\n\n| Agent               | Command           |\n| ------------------- | ----------------- |\n| IT Leader           | `@it-leader`      |\n| Nuxt Frontend       | `@frontend-nuxt`  |\n| React Frontend      | `@frontend-react` |\n| Node Backend        | `@backend`        |\n| Laravel Backend     | `@laravel`        |\n| CodeIgniter 3       | `@ci3`            |\n| UI/UX Designer      | `@designer`       |\n| Code Reviewer       | `@reviewer`       |\n| Database Specialist | `@database`       |\n| DevOps Engineer     | `@devops`         |\n| SEO Specialist      | `@seo`            |\n| Android Developer   | `@android`        |\n| Flutter Developer   | `@flutter`        |\n\n## Troubleshooting\n\n### 1) Agents not visible\n\n**Symptom:** Custom agents don't appear in the agent selector at [github.com/copilot/agents](https://github.com/copilot/agents).\n\n**Fix:**\n\n1. Ensure `.github/agents/` directory exists in your project with `.agent.md` files\n2. Go to [github.com/copilot/agents](https://github.com/copilot/agents) and select your repository\n3. If still not visible, run `npx copilot-agent-kit init --force` to reinstall\n\n### 2) Skills not found\n\n**Symptom:** skill name not visible when running `ls ~/.agents/skills`.\n\n**Fix:**\n\n```bash\necho $HOME\nls ~/.agents/skills\n```\n\nIf missing, copy skills to that directory.\n\n### 3) Skill exists but agent doesn't use it\n\n**Symptom:** agent doesn't load the expected skill.\n\n**Fix:**\n\nCall the skill explicitly in the prompt:\n\n```text\n@frontend Load skill `nuxt-ui` then implement this form.\n```\n\n### 4) MCP not available\n\n**Symptom:** Nuxt/Nuxt UI docs lookup fails.\n\n**Fix:**\n\n1. Ensure MCP servers are configured in repo **Settings \u003e Copilot \u003e Cloud agent \u003e MCP configuration**\n2. Ensure internet connection is active (remote MCP)\n3. For Figma MCP, set the token:\n\n```bash\nexport FIGMA_ACCESS_TOKEN=\"your-token\"\n```\n\n### 5) Agent output too verbose\n\n**Symptom:** changes spill over or explanations are too long.\n\n**Fix:** Add constraints directly in the prompt:\n\n```text\nTask tiny. Minimal diff. Change 1 file only. Brief answer.\n```\n\n### 6) Project conventions not followed\n\n**Symptom:** style/patterns don't match existing code.\n\n**Fix:**\n\n1. State conventions explicitly in the prompt (e.g., \"use useApi\", \"don't change naming\")\n2. Reference example files to follow\n3. Ask the agent to revise with a narrow scope on related files\n\n---\n\n## Copilot SDK Integration\n\nFor programmatic agent orchestration using the Copilot SDK:\n\n```typescript\nimport { CopilotClient } from \"@github/copilot-sdk\";\nimport { createAIAgentKitSession } from \"copilot-agent-kit/copilot/sdk/kit.js\";\n\nconst client = new CopilotClient();\nawait client.start();\n\nconst session = await createAIAgentKitSession(client);\n// 13 agents auto-configured with sub-agent orchestration\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdefuj%2Fcopilot-agent-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdefuj%2Fcopilot-agent-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdefuj%2Fcopilot-agent-kit/lists"}