Skip to content

Add copilot-spaces skill#889

Merged
aaronpowell merged 3 commits intogithub:stagedfrom
labudis:labudis/copilot-spaces-skill
Mar 5, 2026
Merged

Add copilot-spaces skill#889
aaronpowell merged 3 commits intogithub:stagedfrom
labudis:labudis/copilot-spaces-skill

Conversation

@labudis
Copy link
Copy Markdown
Contributor

@labudis labudis commented Mar 5, 2026

What

New skill that teaches agents how to use Copilot Spaces to bring curated, project-specific context into conversations.

Why

Copilot Spaces are a powerful way to ground agent responses in team-specific documentation, code, and instructions, but there's no skill guiding agents on when and how to use them. This skill fills that gap.

What's Included

  • SKILL.md covering:
    • Available MCP tools (list_copilot_spaces, get_copilot_space)
    • When to use spaces (triggers on "Copilot space" mentions, context loading requests, etc.)
    • Discovery and loading workflow
    • Three worked examples (load by name, discover available, context-grounded question)
    • Tips (case sensitivity, owner/name pairing, custom instructions handling)

Testing

  • All 208 skills validate ✅
  • npm run build passes

New skill that teaches agents to use Copilot Spaces MCP tools
(list_copilot_spaces, get_copilot_space) to discover and load
curated project context into conversations. Covers discovery
workflow, loading spaces by owner/name, and using space content
to ground responses in team-specific docs, code, and standards.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 5, 2026 11:36
@labudis labudis requested a review from aaronpowell as a code owner March 5, 2026 11:36
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new skill documenting how agents can use Copilot Spaces (via GitHub MCP tools) to load curated, project-specific context into conversations.

Changes:

  • Introduces skills/copilot-spaces/SKILL.md describing when/how to discover and load Copilot Spaces, with examples and tips.
  • Registers the new skill in docs/README.skills.md.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
skills/copilot-spaces/SKILL.md New skill documentation covering Copilot Spaces discovery/loading workflow and usage examples.
docs/README.skills.md Adds the copilot-spaces entry to the skills index table.

Comment thread skills/copilot-spaces/SKILL.md Outdated
labudis and others added 2 commits March 5, 2026 12:24
- Add 'Spaces as workflow engines' pattern for multi-step processes
- Add 'Follow the breadcrumbs' step for fetching referenced resources
- Document read-only API limitation (no create/update/delete)
- Add filtering tip for list_copilot_spaces by owner
- Add large output handling guidance (20KB+ spaces)
- Add Example 4: Space as a workflow engine
- Strengthen tips with actionable guidance

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Document full CRUD API endpoints (create, update, delete, collaborators)
- Add 'Managing Spaces' workflow section with gh api examples
- Add Example 5: updating Space instructions programmatically
- Fix incorrect 'read-only' claim - MCP is read-only, REST API is full CRUD
- Add scope requirements (user scope for writes)
- Add resource management tips (array replacement, _destroy)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#codeowner

@aaronpowell aaronpowell merged commit 13970c3 into github:staged Mar 5, 2026
3 checks passed
@aaronpowell
Copy link
Copy Markdown
Contributor

#codeowner

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Mar 9, 2026

CODEOWNERS Update Status

I've prepared the CODEOWNERS update for PR #889, but encountered a limitation with pushing the branch to create the pull request.

Changes Prepared

The following entry would be added to the CODEOWNERS file:

# Added via #codeowner from PR #889
/skills/copilot-spaces/ `@labudis`

Manual Alternative

A maintainer can manually update the CODEOWNERS file by adding the above entry at the end of the file to assign @labudis as the owner of the /skills/copilot-spaces/ directory contributed in this PR.

Generated by Codeowner Update Agent for issue #889

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants