Triages issues, reviews PRs, analyzes contributor activity, generates maintenance reports, and proposes actions for open-source GitHub repositories.
npx claudepluginhub numman-ali/n-skills --plugin open-source-maintainerThis skill uses the workspace's default tool permissions.
Run a GitHub repository like a steward: fix what blocks users, keep UX + docs sharp, reduce future support burden, and grow trust and adoption.
references/communication-guide.mdreferences/config.mdreferences/decision-framework.mdreferences/intent-extraction.mdreferences/quality-checklist.mdreferences/repo-state-template.mdreferences/report-structure.mdreferences/workflow.mdscripts/triage.tsscripts/triage/analysis.tsscripts/triage/config.tsscripts/triage/derive.tsscripts/triage/git-summary.tsscripts/triage/github.tsscripts/triage/graph.tsscripts/triage/index.tsscripts/triage/main.tsscripts/triage/notes.tsscripts/triage/reports.tsscripts/triage/state.tsGuides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
Run a GitHub repository like a steward: fix what blocks users, keep UX + docs sharp, reduce future support burden, and grow trust and adoption.
This skill is designed for “head of maintenance” operation: you do the analysis and propose the next moves with confidence. The human should be able to mostly ask: “What’s next?”
Everything else is optional and should be progressively disclosed.
If unsure which mode to use, default to Maintain → Ship.
Do not read everything by default. Load the minimum reference needed for the task you are about to do.
| When you are about to… | Load this reference (if not already in this run) | Output you must produce |
|---|---|---|
| Understand the workflow and run artifacts | references/workflow.md, references/report-structure.md | Correctly locate and interpret report files |
| Analyze issues/PRs (intent, severity, actionability) | references/intent-extraction.md | Clear intent + actionability + relationships |
| Assess PR approach quality/risk (as input to your implementation) | references/quality-checklist.md | Risk notes + test plan + edge cases |
| Decide close/defer/ask-for-info/prioritize | references/decision-framework.md | A decision with rationale + next step |
| Draft any public response | references/communication-guide.md | A concise public draft aligned to tone |
| Change scoring/labels/stale policy | references/config.md | Proposed config edits + impact |
Initialize/reshape .github/maintainer/ state | references/repo-state-template.md | Correct state files created/updated |
These are “STOP gates” where skipping the right reference tends to cause mistakes.
references/decision-framework.md.references/communication-guide.md.references/quality-checklist.md.references/intent-extraction.md.references/config.md..github/maintainer/ exists (create via templates if missing)..github/maintainer/context.md to align with project priorities and tone.From repo root:
npx tsx /path/to/open-source-maintainer/scripts/triage.ts
Prefer --delta if a previous run exists.
.github/maintainer/notes/ (scores, confidence, rationale)..github/maintainer/decisions.md, .github/maintainer/patterns.md, .github/maintainer/contributors.md..github/maintainer/state.json current for delta runs.# Standard run (creates reports/<datetime>/)
npx tsx /path/to/open-source-maintainer/scripts/triage.ts
# Compare with previous run
npx tsx /path/to/open-source-maintainer/scripts/triage.ts --delta
# Keep existing folder if same datetime
npx tsx /path/to/open-source-maintainer/scripts/triage.ts --keep
# Override report folder name
npx tsx /path/to/open-source-maintainer/scripts/triage.ts --datetime 2026-01-17T12-30-00
# Use a custom config path
npx tsx /path/to/open-source-maintainer/scripts/triage.ts --config .github/maintainer/config.json
The skill maintains project memory in .github/maintainer/:
| File | Purpose |
|---|---|
context.md | Project vision, priorities, tone, boundaries |
decisions.md | Decision log with reasoning |
contributors.md | Notes on specific contributors |
patterns.md | Observed patterns and learnings |
standing-rules.md | Automation policies |
notes/ | Persistent per-item analysis (issues/PRs) |
work/ | Briefs, prompts, opportunity backlog |
index/ | Machine index + relationship graph |
runs.md | Run ledger with report paths |
state.json | Technical state for delta computation |
Notes/work/index are persistent across runs; reports are snapshots.
Reference items consistently in reports and responses:
ISSUE:42 — Issue #42ISSUE:42:C:3 — Comment #3 on issue #42PR:38 — Pull request #38PR:38:R:1 — Review #1 on PR #38PR:38:RC:4 — Review comment #4 on PR #38Never execute without explicit approval: