Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -642,7 +642,7 @@ toolset may expose only part of the catalog.
- [`issue-authoring`](pkg/skills/catalog/skills/issue-authoring/SKILL.md) — USE FOR: filing one clear bug report or feature request — checking it is not already reported, choosing its type and fields, breaking it into sub-issues, and giving it a title and body someone can act on. NOT FOR: working through an existing backlog, or discussing an open question with a community.
- [`issue-backlog-triage`](pkg/skills/catalog/skills/issue-backlog-triage/SKILL.md) — USE FOR: triaging a backlog of open GitHub issues — judging which are actionable, labelling and typing them, linking duplicates and parents, and closing what is dead. NOT FOR: writing one new issue, scheduling committed work, or reviewing pull requests.
- [`label-scheme-management`](pkg/skills/catalog/skills/label-scheme-management/SKILL.md) — USE FOR: curating the label vocabulary a repository uses — adding ones it lacks, auditing which are actually applied, renaming and recolouring them, merging overlapping ones, and tidying away the unused. NOT FOR: applying an existing label to an issue, or deciding which issues matter.
- [`notification-triage`](pkg/skills/catalog/skills/notification-triage/SKILL.md) — USE FOR: working through a GitHub notification inbox — deciding what needs a reply, what to unsubscribe from, and what to mark read or done. NOT FOR: triaging a repository issue backlog, or answering review threads on one specific pull request.
- [`notification-triage`](pkg/skills/catalog/skills/notification-triage/SKILL.md) — USE FOR: triaging a GitHub notification inbox or checking or changing a subscription to a specific issue, pull request, or discussion. NOT FOR: triaging a repository issue backlog, or answering code review threads.
- [`project-planning`](pkg/skills/catalog/skills/project-planning/SKILL.md) — USE FOR: planning and updating work on a GitHub Projects board — reading fields and views, adding issues or pull requests as items, setting status and iteration, and posting a status update. NOT FOR: triaging a repository issue backlog, or preparing a release.
- [`pull-request-authoring`](pkg/skills/catalog/skills/pull-request-authoring/SKILL.md) — USE FOR: taking a branch of work through to landed — opening the pull request, describing it, requesting reviewers, keeping it current with its base, and merging it once checks and approvals are in. NOT FOR: reviewing someone else's proposal, or acting on review comments left on yours.
- [`pull-request-code-review`](pkg/skills/catalog/skills/pull-request-code-review/SKILL.md) — USE FOR: examining someone else's pull request and delivering a verdict — reading the diff in context, leaving line-anchored comments as a batch, and approving or requesting changes. NOT FOR: replying to review comments left on your own change, or opening and merging one.
Expand Down Expand Up @@ -1175,6 +1175,13 @@ For negotiated supported protocol versions `2026-07-28` or newer, the consolidat
- **OAuth Challenge Scopes**: `notifications`
- `notificationID`: The ID of the notification (string, required)

- **get_subject_subscription** - Get subject subscription
- **OAuth Challenge Scopes**: `repo`
- `number`: Issue, pull request, or discussion number (integer, required)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `subjectType`: Type of the subject to subscribe to (string, required)

- **list_notifications** - List notifications
- **OAuth Challenge Scopes**: `notifications`
- `before`: Only show notifications updated before the given time (ISO 8601 format) (string, optional)
Expand All @@ -1196,6 +1203,14 @@ For negotiated supported protocol versions `2026-07-28` or newer, the consolidat
- `owner`: The account owner of the repository. (string, required)
- `repo`: The name of the repository. (string, required)

- **manage_subject_subscription** - Manage subject subscription
- **OAuth Challenge Scopes**: `repo`, `notifications`
- `number`: Issue, pull request, or discussion number (integer, required)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `state`: subscribed: receive all updates; unsubscribed: only participating or mentions; ignored: receive no notifications (string, required)
- `subjectType`: Type of the subject to subscribe to (string, required)

- **mark_all_notifications_read** - Mark all notifications as read
- **OAuth Challenge Scopes**: `notifications`
- `lastReadAt`: Describes the last point that notifications were checked (optional). Default: Now (string, optional)
Expand Down
43 changes: 43 additions & 0 deletions pkg/github/__toolsnaps__/get_subject_subscription.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
{
"annotations": {
"idempotentHint": false,
"readOnlyHint": true,
"title": "Get subject subscription"
},
"description": "Get the authenticated user's notification subscription state for a specific issue, pull request, or discussion by repository and number. Does not require an existing notification thread.",
"inputSchema": {
"properties": {
"number": {
"description": "Issue, pull request, or discussion number",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"owner": {
"description": "Repository owner",
"type": "string"
},
"repo": {
"description": "Repository name",
"type": "string"
},
"subjectType": {
"description": "Type of the subject to subscribe to",
"enum": [
"issue",
"pull_request",
"discussion"
],
"type": "string"
}
},
"required": [
"owner",
"repo",
"subjectType",
"number"
],
"type": "object"
},
"name": "get_subject_subscription"
}
44 changes: 44 additions & 0 deletions pkg/github/__toolsnaps__/get_subject_subscription_output.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
{
"inputSchema": null,
"name": "get_subject_subscription",
"outputSchema": {
"additionalProperties": false,
"properties": {
"can_subscribe": {
"type": "boolean"
},
"id": {
"type": "string"
},
"number": {
"maximum": 2147483647,
"minimum": -2147483648,
"type": "integer"
},
"state": {
"type": [
"null",
"string"
]
},
"subject_type": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"subject_type",
"number",
"url",
"state",
"can_subscribe"
],
"type": [
"null",
"object"
]
}
}
54 changes: 54 additions & 0 deletions pkg/github/__toolsnaps__/manage_subject_subscription.snap
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
{
"annotations": {
"destructiveHint": true,
"idempotentHint": true,
"readOnlyHint": false,
"title": "Manage subject subscription"
},
"description": "Subscribe, unsubscribe, or ignore a specific issue, pull request, or discussion for the authenticated user by repository and number. Does not require an existing notification thread and does not watch the whole repository. Use get_subject_subscription to check the current state.",
"inputSchema": {
"properties": {
"number": {
"description": "Issue, pull request, or discussion number",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"owner": {
"description": "Repository owner",
"type": "string"
},
"repo": {
"description": "Repository name",
"type": "string"
},
"state": {
"description": "subscribed: receive all updates; unsubscribed: only participating or mentions; ignored: receive no notifications",
"enum": [
"subscribed",
"unsubscribed",
"ignored"
],
"type": "string"
},
"subjectType": {
"description": "Type of the subject to subscribe to",
"enum": [
"issue",
"pull_request",
"discussion"
],
"type": "string"
}
},
"required": [
"owner",
"repo",
"subjectType",
"number",
"state"
],
"type": "object"
},
"name": "manage_subject_subscription"
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
{
"inputSchema": null,
"name": "manage_subject_subscription",
"outputSchema": {
"additionalProperties": false,
"properties": {
"can_subscribe": {
"type": "boolean"
},
"id": {
"type": "string"
},
"number": {
"maximum": 2147483647,
"minimum": -2147483648,
"type": "integer"
},
"state": {
"type": [
"null",
"string"
]
},
"subject_type": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"subject_type",
"number",
"url",
"state",
"can_subscribe"
],
"type": [
"null",
"object"
]
}
}
Loading