{"id":41027414,"url":"https://github.com/kasuken/github-copilot-superpowers","last_synced_at":"2026-02-19T08:03:18.143Z","repository":{"id":333705274,"uuid":"1138294886","full_name":"kasuken/github-copilot-superpowers","owner":"kasuken","description":"Opinionated, repo-local configuration for GitHub Copilot (Chat + Agent mode): instruction hierarchy, reusable prompt files, custom agent profiles, and MCP server config.","archived":false,"fork":false,"pushed_at":"2026-01-20T22:07:47.000Z","size":55,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-21T00:54:34.550Z","etag":null,"topics":["copilot","github"],"latest_commit_sha":null,"homepage":"","language":null,"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/kasuken.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":null,"dco":null,"cla":null}},"created_at":"2026-01-20T13:45:07.000Z","updated_at":"2026-01-20T22:07:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kasuken/github-copilot-superpowers","commit_stats":null,"previous_names":["kasuken/github-copilot-superpowers"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kasuken/github-copilot-superpowers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasuken%2Fgithub-copilot-superpowers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasuken%2Fgithub-copilot-superpowers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasuken%2Fgithub-copilot-superpowers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasuken%2Fgithub-copilot-superpowers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kasuken","download_url":"https://codeload.github.com/kasuken/github-copilot-superpowers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasuken%2Fgithub-copilot-superpowers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28661007,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"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":["copilot","github"],"created_at":"2026-01-22T10:01:33.100Z","updated_at":"2026-01-22T10:01:35.109Z","avatar_url":"https://github.com/kasuken.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# GitHub Copilot SuperPowers\n\nOpinionated, repo-local configuration for **GitHub Copilot (Chat + Agent mode)**: instruction hierarchy, reusable prompt files, custom agent profiles, and MCP server config.\n\n\u003cimg width=\"1536\" height=\"1024\" alt=\"GitHub Copilot SuperPowers\" src=\"https://github.com/user-attachments/assets/3414f8d4-5180-4926-8850-18378710a930\" /\u003e\n\n[Quickstart](#quickstart) • [What’s inside](#whats-inside) • [MCP servers](#mcp-servers) • [Repo layout](#repo-layout)\n\n\u003e [!NOTE]\n\u003e This repository is intentionally small and **highly opinionated**. It’s designed to be copied into other repos and adapted.\n\n## Why this exists\n\nGitHub Copilot gets significantly more useful when you make its “defaults” explicit: what quality bars to follow, when to stop and investigate, and how to keep edits scoped.\nThis repo packages those defaults in a form that’s easy to version, review, and reuse.\n\n## What’s inside\n\n- **Instruction system** under `.github/instructions/` (rules, workflow, quality gates, execution protocol)\n- **Reusable prompts** under `.github/prompts/` (ex: generate a README, generate `AGENTS.md`, repo story time, create release notes)\n- **Custom agents** under `.github/agents/` (ex: Critical Thinking, Mentor, Janitor)\n- **Agent \"skills\" playbooks** under `.github/skills/` (investigation mode, root-cause tracing, verification gates, uncertainty verification, minimalist development, task direction approval)\n- **VS Code workspace settings** under `.vscode/settings.json` (enables Copilot agent features, advanced reasoning, MCP integration)\n- **MCP configuration** under `.vscode/mcp.json` (Sequential Thinking, Context7, Memory, Serena)\n\n## Quickstart\n\n### Use this repo as a template\n\n1. Copy these folders into your target repository:\n\n   - `.github/`\n   - `.vscode/`\n\n2. Review and tailor the instruction files:\n\n   - Start with `.github/copilot-instructions.md`\n   - Then adjust rules in `.github/instructions/` to match your team’s tolerance for “guard rails”.\n\n\u003e [!IMPORTANT]\n\u003e The instruction set in `.github/instructions/` is designed to reduce flakiness and “agent drift”, but it can also feel strict.\n\u003e If you don’t want delegation-heavy workflows or you’re not using subagents, loosen or remove those constraints.\n\n### Use it in VS Code\n\n- Open the repository (or your repo that copied these files) in VS Code.\n- Ensure GitHub Copilot is enabled.\n- Keep `.vscode/settings.json` checked in so the workspace defaults travel with the repo.\n\n## Agent Skills\n\nAgent skills are optional playbooks that can be loaded on-demand to handle specific scenarios. Load a skill when you need specialized handling for complex tasks.\n\nLocated in `.github/skills/`, this repo includes 6 ready-to-use skills:\n\n| Skill | Purpose | When to use |\n|-------|---------|------------|\n| **investigation-mode** | Pause implementation after 2+ consecutive failures and switch to root-cause analysis before resuming | Repeated test failures or validation errors |\n| **root-cause-tracing** | Trace bugs backward through call stacks to find the original trigger, not just the symptom | Deep debugging of complex issues |\n| **task-direction-approval** | Explain failure root cause, present 2-3 solution options with trade-offs, and wait for explicit user choice | Before switching tech stacks or architectures |\n| **uncertainty-verification** | Verify exact commands, configuration keys, API details, and version-specific behavior via official docs—no assumptions | When providing version-dependent or time-sensitive guidance |\n| **verification-before-completion** | Run verification commands and confirm output before making any completion claims | Before marking tasks as complete or fixed |\n| **minimalist-surgical-development** | Prioritize the smallest diff first, prefer standard libraries, avoid unsolicited refactoring | Code changes and refactoring work |\n\n## Custom Agents\n\nCustom agents define specialized \"modes\" for focused collaboration. Select an agent profile when you want tailored behavior for your specific task.\n\nLocated in `.github/agents/`, this repo includes 4 custom agent profiles:\n\n| Agent | Role | Best for |\n|-------|------|----------|\n| **Critical Thinking** | Questions assumptions and encourages exploration of alternative approaches and edge cases | Architecture reviews, design decisions, risk analysis |\n| **Mentor** | Provides Socratic guidance through critical questioning without providing direct solutions | Learning, skill development, understanding complex systems |\n| **Janitor** | Focuses on cleanup, simplification, and technical debt remediation | Code cleanup, refactoring, removing dead code, performance optimization |\n| **Tech Debt Remediation Plan** | Generates comprehensive technical debt remediation plans with metrics and actionable steps | Technical debt analysis, code quality assessment, planning refactoring work |\n\n## MCP Servers\n\nThis repo includes a ready-to-use MCP configuration at `.vscode/mcp.json`.\n\nModel Context Protocol (MCP) servers extend Copilot's capabilities with specialized tools and information sources.\n\nConfigured servers:\n\n| Server | Purpose | Launch method |\n|--------|---------|-----------------|\n| **Sequential Thinking** | Structured multi-step reasoning with built-in revision support for complex problem-solving | `npx` |\n| **Context7** | Up-to-date library and framework documentation lookup—always retrieves current version docs | `npx` |\n| **Memory** | Lightweight knowledge graph for storing discovered patterns, architectural insights, and recurring solutions | `npx` |\n| **Serena** | Project-aware code intelligence: symbol operations, file search, refactoring, and codebase analysis | `uvx` (Python `uv` tooling) |\n\n### Prerequisites \u0026 Troubleshooting\n\n- **Node.js**: Required for `npx`-based servers (Sequential Thinking, Context7, Memory)\n- **Python `uv` tooling**: Required for Serena MCP server via `uvx`\n- **No MCP servers starting?** Verify Node.js is installed (`npm --version`) and `uv` is available (`uv --version`)\n\n## VS Code Settings\n\nLocated in `.vscode/settings.json`, the workspace includes optimized Copilot agent configuration.\n\n### Agent \u0026 Skill Activation\n\n| Setting | Purpose |\n|---------|---------|\n| `chat.agent.maxRequests` | Limits agent requests per session (set to 125) |\n| `chat.useAgentSkills` | Enables loading skills from `.github/skills/` for specialized task handling |\n| `chat.useAgentsMdFile` | Loads custom agent profiles from `.github/agents/*.agent.md` |\n| `chat.useNestedAgentsMdFiles` | Supports multi-level agent profile organization |\n| `chat.customAgentInSubagent.enabled` | Allows subagents to use custom agent profiles for complex delegation |\n\n### Advanced Reasoning \u0026 Code Quality\n\n| Setting | Purpose |\n|---------|---------|\n| `github.copilot.chat.responsesApiReasoningEffort` | Set to `\"high\"` for deeper problem analysis and fewer mistakes |\n| `github.copilot.chat.responsesApiReasoningSummary` | Set to `\"detailed\"` for thorough thinking explanations |\n| `inlineChat.enableV2` | Enables inline chat suggestions during code editing |\n| `github.copilot.nextEditSuggestions.enabled` | Provides contextual edit suggestions based on chat history |\n\n### Context \u0026 Search\n\n| Setting | Purpose |\n|---------|---------|\n| `github.copilot.chat.newWorkspace.useContext7` | Automatically enables Context7 MCP for docs lookup in new workspaces |\n| `github.copilot.chat.scopeSelection` | Limits context to the current selection for focused prompts |\n| `github.copilot.chat.codesearch.enabled` | Enables semantic code search in chat context |\n| `github.copilot.chat.alternateGptPrompt.enabled` | Provides alternative prompt rewriting suggestions |\n\n### MCP \u0026 CLI Integration\n\n| Setting | Purpose |\n|---------|---------|\n| `github.copilot.chat.useResponsesApi` | Enables reasoning and extended analysis capabilities |\n| `github.copilot.chat.cli.customAgents.enabled` | Allows custom agents to be used from the CLI |\n| `github.copilot.chat.cli.mcp.enabled` | Enables MCP servers in CLI mode for agent workflows |\n| `github.copilot.chat.githubMcpServer.enabled` | Activates GitHub MCP for repo operations (issues, PRs, code search) |\n| `github.copilot.chat.githubMcpServer.readonly` | Restricts GitHub MCP to read-only mode (set to `true` for safety) |\n\n### Analytics\n\n| Setting | Purpose |\n|---------|---------|\n| `editor.aiStats.enabled` | Tracks AI-assisted code writing metrics for insights |\n\n## Repo layout\n\n```\n.\n├─ .github/\n│  ├─ copilot-instructions.md\n│  ├─ agents/\n│  ├─ instructions/\n│  ├─ prompts/\n│  └─ skills/\n└─ .vscode/\n   ├─ mcp.json\n   └─ settings.json\n```\n\n## Notes\n\n\u003e [!CAUTION]\n\u003e GitHub-flavored admonitions (like the blocks in this README) don’t render everywhere and are intentionally limited in where they can be nested. If you copy/paste sections into places like `\u003cdetails\u003e` or nested lists, you may need to rewrite them as plain blockquotes.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkasuken%2Fgithub-copilot-superpowers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkasuken%2Fgithub-copilot-superpowers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkasuken%2Fgithub-copilot-superpowers/lists"}