Forneça contexto específico do projeto para conversas carregando bases de conhecimento compartilhadas, documentação, código e instruções do GitHub Copilot Spaces.
- Estrelas no GitHub
- 41.038
- Arquivos
- 1
- Último commit
- 11 de nov. de 2026
- Licença
- MIT
- Ferramentas permitidas
- —
O que a skill copilot-spaces faz?
Forneça contexto específico do projeto para conversas carregando bases de conhecimento compartilhadas, documentação, código e instruções do GitHub Copilot Spaces.
Resumo gerado a partir do SKILL.md da skill.
Sobre a skill copilot-spaces
Desenvolvedores que precisam fundamentar conversas de IA em conhecimentos específicos de um projeto podem usar esta skill para carregar contexto compartilhado do GitHub Copilot Spaces. Ela permite que um agente acesse coleções curadas de repositórios, documentação e instruções personalizadas que representam o código e os padrões reais de uma equipe. Ao carregar um space, um agente pode responder perguntas sobre arquitetura, seguir convenções de codificação específicas ou executar fluxos de trabalho estruturados definidos pelo time.
Um agente deve carregar esta skill quando um usuário solicitar a busca ou o carregamento de um Copilot space específico. A skill fornece acesso de apenas leitura através das ferramentas mcp__github__list_copilot_spaces e mcp__github__get_copilot_space. Enquanto as ferramentas MCP cuidam da descoberta e leitura, operações completas de CRUD, como criar, atualizar ou excluir espaços, devem ser realizadas via gh api. Isso garante que o agente possa recuperar um contexto profundo de arquivos e issues anexados para fornecer respostas altamente relevantes e específicas do projeto.
O que um agente pode fazer com ela
- 1Descobrir espaços de projeto disponíveisUm agente pode identificar quais bases de conhecimento compartilhadas estão acessíveis a um usuário listando todos os espaços disponíveis.
- 2Carregar contexto específico do projetoUm desenvolvedor pode importar toda a documentação e instruções de código de um space nomeado para fundamentar uma conversa de IA.
- 3Executar fluxos de trabalho estruturados da equipeUm agente pode seguir processos passo a passo ou templates definidos dentro de um space para produzir resultados padronizados.
- 4Gerenciar configurações de space via APIUsuários podem atualizar programaticamente as instruções ou metadados de um space usando comandos do GitHub CLI.
Escrito a partir do SKILL.md da skill. Cada caso de uso é verificado com uma citação dele.
Como instalar a skill copilot-spaces
Cada comando copia a pasta da skill para o diretório de skills do cliente. Reinicie o cliente ou inicie uma nova sessão para carregá-la.Instalar a skill copilot-spaces no Claude Code
~/.claude/skills/copilot-spaces/SKILL.md
$ npx degit github/awesome-copilot/skills/copilot-spaces ~/.claude/skills/copilot-spacesInstalar a skill copilot-spaces no Claude Code (project)
.claude/skills/copilot-spaces/SKILL.md
$ npx degit github/awesome-copilot/skills/copilot-spaces .claude/skills/copilot-spacesInstalar a skill copilot-spaces no Codex
~/.agents/skills/copilot-spaces/SKILL.md
$ npx degit github/awesome-copilot/skills/copilot-spaces ~/.agents/skills/copilot-spacesInstalar a skill copilot-spaces no Gemini CLI
~/.gemini/skills/copilot-spaces/SKILL.md
$ npx degit github/awesome-copilot/skills/copilot-spaces ~/.gemini/skills/copilot-spacesInstalar a skill copilot-spaces no Claude.ai
npx degit github/awesome-copilot/skills/copilot-spaces copilot-spaces && zip -r copilot-spaces.zip copilot-spaces # claude.ai → Customize → Skills → + → Create skill → Upload a skill → copilot-spaces.zip
Verificações automatizadas
Executado em 15 de nov. de 2026Relatório completo →Passou nas nossas verificações automáticas. Não é uma auditoria de segurança: leia os scripts antes de deixar um agente executá-los. Como as verificações funcionam
- Repositório de origem vinculado e acessívelgithub/awesome-copilot/skills/copilot-spaces is public and reachablegithub.com/github/awesome-copilot/tree/HEAD/skills/copilot-s ↗Passou
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit 2026-11-11github.com/github/awesome-copilot/commits ↗Passou
- Sem baixar e executar nem roubo de credenciais nos scriptsNo scripts in the skill folderPassou
- Sem instruções ocultas no SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/github/awesome-copilot/blob/HEAD/skills/copilot-s ↗Passou
- Ferramentas pré-aprovadas são restritasNo pre-approved tools; the agent asks before using onegithub.com/github/awesome-copilot/blob/HEAD/skills/copilot-s ↗Passou
- O SKILL.md segue o formato Agent SkillsValid name and description; says when to use it; 206 linesgithub.com/github/awesome-copilot/blob/HEAD/skills/copilot-s ↗Passou
SKILL.md
Ver no GitHubCopilot Spaces
Use Copilot Spaces to bring curated, project-specific context into conversations. A Space is a shared collection of repositories, files, documentation, and instructions that grounds Copilot responses in your team's actual code and knowledge.
Available Tools
MCP Tools (Read-only)
| Tool | Purpose |
|---|---|
mcp__github__list_copilot_spaces |
List all spaces accessible to the current user |
mcp__github__get_copilot_space |
Load a space's full context by owner and name |
REST API via gh api (Full CRUD)
The Spaces REST API supports creating, updating, deleting spaces, and managing collaborators. The MCP server only exposes read operations, so use gh api for writes.
User Spaces:
| Method | Endpoint | Purpose |
|---|---|---|
POST |
/users/{username}/copilot-spaces |
Create a space |
GET |
/users/{username}/copilot-spaces |
List spaces |
GET |
/users/{username}/copilot-spaces/{number} |
Get a space |
PUT |
/users/{username}/copilot-spaces/{number} |
Update a space |
DELETE |
/users/{username}/copilot-spaces/{number} |
Delete a space |
Organization Spaces: Same pattern under /orgs/{org}/copilot-spaces/...
Collaborators: Add, list, update, and remove collaborators at .../collaborators
Scope requirements: PAT needs read:user for reads, user for writes. Add with gh auth refresh -h github.com -s user.
Note: This API is functional but not yet in the public REST API docs. It may require the copilot_spaces_api feature flag.
When to Use Spaces
- User mentions "Copilot space" or asks to "load a space"
- User wants answers grounded in specific project docs, code, or standards
- User asks "what spaces are available?" or "find a space for X"
- User needs onboarding context, architecture docs, or team-specific guidance
- User wants to follow a structured workflow defined in a Space (templates, checklists, multi-step processes)
Workflow
1. Discover Spaces
When a user asks what spaces are available or you need to find the right space:
Call mcp__github__list_copilot_spaces
This returns all spaces the user can access, each with a name and owner_login. Present relevant matches to the user.
To filter for a specific user's spaces, match owner_login against the username (e.g., "show me my spaces").
2. Load a Space
When a user names a specific space or you've identified the right one:
Call mcp__github__get_copilot_space with:
owner: "org-or-user" (the owner_login from the list)
name: "Space Name" (exact space name, case-sensitive)
This returns the space's full content: attached documentation, code context, custom instructions, and any other curated materials. Use this context to inform your responses.
3. Follow the Breadcrumbs
Space content often references external resources: GitHub issues, dashboards, repos, discussions, or other tools. Proactively fetch these using other MCP tools to gather complete context. For example:
- A space references an initiative tracking issue. Use
issue_readto get the latest comments. - A space links to a project board. Use project tools to check current status.
- A space mentions a repo's masterplan. Use
get_file_contentsto read it.
4. Answer or Execute
Once loaded, use the space content based on what it contains:
If the space contains reference material (docs, code, standards):
- Answer questions about the project's architecture, patterns, or standards
- Generate code that follows the team's conventions
- Debug issues using project-specific knowledge
If the space contains workflow instructions (templates, step-by-step processes):
- Follow the workflow as defined, step by step
- Gather data from the sources the workflow specifies
- Produce output in the format the workflow defines
- Show progress after each step so the user can steer
5. Manage Spaces (via gh api)
When a user wants to create, update, or delete a space, use gh api. First, find the space number from the list endpoint.
Update a space's instructions:
gh api users/{username}/copilot-spaces/{number} \
-X PUT \
-f general_instructions="New instructions here"
Update name, description, or instructions together:
gh api users/{username}/copilot-spaces/{number} \
-X PUT \
-f name="Updated Name" \
-f description="Updated description" \
-f general_instructions="Updated instructions"
Create a new space:
gh api users/{username}/copilot-spaces \
-X POST \
-f name="My New Space" \
-f general_instructions="Help me with..." \
-f visibility="private"
Attach resources (replaces entire resource list):
{
"resources_attributes": [
{ "resource_type": "free_text", "metadata": { "name": "Notes", "text": "Content here" } },
{ "resource_type": "github_issue", "metadata": { "repository_id": 12345, "number": 42 } },
{ "resource_type": "github_file", "metadata": { "repository_id": 12345, "file_path": "docs/guide.md" } }
]
}
Delete a space:
gh api users/{username}/copilot-spaces/{number} -X DELETE
Updatable fields: name, description, general_instructions, icon_type, icon_color, visibility ("private"/"public"), base_role ("no_access"/"reader"), resources_attributes
Examples
Example 1: User Asks for a Space
User: "Load the Accessibility copilot space"
Action:
- Call
mcp__github__get_copilot_spacewith owner"github", name"Accessibility" - Use the returned context to answer questions about accessibility standards, MAS grades, compliance processes, etc.
Example 2: User Wants to Find Spaces
User: "What copilot spaces are available for our team?"
Action:
- Call
mcp__github__list_copilot_spaces - Filter/present spaces relevant to the user's org or interests
- Offer to load any space they're interested in
Example 3: Context-Grounded Question
User: "Using the security space, what's our policy on secret scanning?"
Action:
- Call
mcp__github__get_copilot_spacewith the appropriate owner and name - Find the relevant policy in the space content
- Answer based on the actual internal documentation
Example 4: Space as a Workflow Engine
User: "Write my weekly update using the PM Weekly Updates space"
Action:
- Call
mcp__github__get_copilot_spaceto load the space. It contains a template format and step-by-step instructions. - Follow the space's workflow: pull data from attached initiative issues, gather metrics, draft each section.
- Fetch external resources referenced by the space (tracking issues, dashboards) using other MCP tools.
- Show the draft after each section so the user can review and fill in gaps.
- Produce the final output in the format the space defines.
Example 5: Update Space Instructions Programmatically
User: "Update my PM Weekly Updates space to include a new writing guideline"
Action:
- Call
mcp__github__list_copilot_spacesand find the space number (e.g., 19). - Call
mcp__github__get_copilot_spaceto read current instructions. - Modify the instructions text as requested.
- Push the update:
gh api users/labudis/copilot-spaces/19 -X PUT -f general_instructions="updated instructions..."
Tips
- Space names are case-sensitive. Use the exact name from
list_copilot_spaces. - Spaces can be owned by users or organizations. Always provide both
ownerandname. - Space content can be large (20KB+). If returned as a temp file, use grep or view_range to find relevant sections rather than reading everything at once.
- If a space isn't found, suggest listing available spaces to find the right name.
- Spaces auto-update as underlying repos change, so the context is always current.
- Some spaces contain custom instructions that should guide your behavior (coding standards, preferred patterns, workflows). Treat these as directives, not suggestions.
- Write operations (
gh apifor create/update/delete) require theuserPAT scope. If you get a 404 on write operations, rungh auth refresh -h github.com -s user. - Resource updates replace the entire array. To add a resource, include all existing resources plus the new one. To remove one, include
{ "id": 123, "_destroy": true }in the array.
Arquivos desta skill
1Perguntas sobre a skill copilot-spaces
Como instalo a skill copilot-spaces no Claude Code?
Execute npx degit github/awesome-copilot/skills/copilot-spaces ~/.claude/skills/copilot-spaces. O Claude Code carrega skills de ~/.claude/skills (todos os projetos) ou .claude/skills (um projeto) e usa uma skill quando a descrição dela corresponde à tarefa.
Quais clientes podem usar a skill copilot-spaces?
Qualquer cliente que leia o formato Agent Skills: Claude Code, Codex, Gemini CLI e claude.ai (envie como ZIP). Scripts da skill são executados apenas onde o cliente permite execução de código.
Posso criar ou excluir espaços do Copilot usando ferramentas MCP?
Não, o MCP server oferece apenas operações de leitura. Para criar, atualizar ou excluir espaços, você deve usar o GitHub CLI via REST API.
Quais informações estão contidas em um Copilot Space?
Um Space contém uma coleção compartilhada de repositórios, arquivos, documentação e instruções personalizadas para fundamentar as respostas no conhecimento do projeto.
Quais permissões são necessárias para escrever na API de Spaces?
Você precisa de um Personal Access Token (PAT) com o escopo 'user' para operações de escrita.