About

Imported from shipshitdev/skills (skills/github-inbox/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill github-inbox. Copyright stays with the author.

GitHub Inbox

Name: github-inbox
Author: shipshitdev

Turn scattered GitHub work into a small priority queue.

Authorized Scope

Apply this engine only within the user's requested task and existing explicit authorization. Loading or delegating to it grants no additional authority. Preserve report-only restrictions and the caller's target, host, provider, and cost limits. Existing approval satisfies a gate only for the same actions and scope; obtain approval before expanding them. Forward these limits to delegates.

Contract

Inputs:

Optional repository, owner, or project filter
Optional limit and priority rules

Outputs:

Prioritized GitHub inbox summary
Recommended next actions
Commands for follow-up inspection

Creates/Modifies:

None in report mode
May label, comment, assign, close, or move items only after approval

External Side Effects:

Reads GitHub issues, PRs, reviews, checks, and project membership
Writes GitHub issue/PR/project state only after approval

Confirmation Required:

Before editing labels, assignees, comments, project fields, or issue state
Before rerunning workflows
Before merging or closing anything

Delegates To:

github-fix-ci for failing PR checks
github-address-comments for existing review comments
github-review-suggestions when a PR needs inline review feedback
project-board when the board configuration needs inspection
board-sync when existing item values or delivery evidence need reconciliation

Workflow

Resolve <skill-dir> to this skill's installed directory through the active catalog before running a helper. Do not assume a repository checkout or a provider-specific environment variable.

Verify auth:

gh auth status -h github.com
gh api user --jq .login

Generate the inbox:

node <skill-dir>/scripts/github-inbox-report.mjs

Common filters:

node <skill-dir>/scripts/github-inbox-report.mjs --owner shipshitdev
node <skill-dir>/scripts/github-inbox-report.mjs --repo shipshitdev/shipcode
node <skill-dir>/scripts/github-inbox-report.mjs --project shipshitdev/1
node <skill-dir>/scripts/github-inbox-report.mjs --limit 50

Triage order:
- Review requests
- Authored PRs with failing checks
- Assigned P0/P1 or blocking issues
- Mentions needing a response
- Stale assigned issues
- Project-board items missing status or priority
For each item, choose one next action:
- Inspect
- Fix
- Reply
- Defer
- Reassign
- Close

Ask before applying any writes. When writing, use the smallest command:

gh issue edit <number> --add-label "priority:P1"
gh issue comment <number> --body-file <file>
gh pr review <number> --comment --body-file <file>

Rules

Prefer a short queue over a complete dump.
Keep review requests above authored work unless production is blocked.
Treat failing checks as actionable only after reading the failure.
Do not close or defer user-facing issues without leaving a reason.
If GitHub search results are noisy, narrow by --repo, --owner, or --project before making recommendations.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-github-inbox/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-github-inbox.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-github-inbox",
  "kind": "skill",
  "name": "github-inbox",
  "description": "Collect and triage a GitHub work inbox from assigned issues, review requests, mentions, authored PRs with failing checks, and optional project filters. Use when checking what needs attention across GitHub or prioritizing GitHub tasks.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "github",
      "inbox",
      "triage",
      "issues",
      "pull-requests",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Collect and triage a GitHub work inbox from assigned issues, review requests, mentions, authored PRs with failing checks, and optional project filters. Use when checking what needs attention across GitHub or prioritizing GitHub tasks."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/github-inbox/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/github-inbox/SKILL.md",
      "key": "shipshitdev/skills/skills/github-inbox/SKILL.md"
    },
    "compatibility": "Requires GitHub CLI gh access. The bundled inbox report script runs with Node.js or Bun.",
    "allowed_tools": [
      "Bash(gh",
      "*)",
      "Bash(node",
      "*)",
      "Bash(bun",
      "*)"
    ]
  },
  "instructions": "# GitHub Inbox\n\nTurn scattered GitHub work into a small priority queue.\n\n## Authorized Scope\n\nApply this engine only within the user's requested task and existing explicit\nauthorization. Loading or delegating to it grants no additional authority.\nPreserve report-only restrictions and the caller's target, host, provider, and\ncost limits. Existing approval satisfies a gate only for the same actions and\nscope; obtain approval before expanding them. Forward these limits to delegates.\n\n## Contract\n\nInputs:\n\n- Optional repository, owner, or project filter\n- Optional limit and priority rules\n\nOutputs",
  "cost": {
    "context_tokens": 789
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-github-inbox/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.