oss-repo-maintainer

name	oss-repo-maintainer
description	Helps maintain open-source repos: README accuracy, version consistency, andp re-release checklists. Use when syncing docs with repo reality or user saysf ix README, prep release, repo maintenance. Triggers: fix README, preprelease , repo maintenance, sync docs.
version	1.0.0
author	Stijnman
license	MIT
compatibility	Grok agent; optional MCP and shell access
metadata	{"grok":{"tags":["fix README","prep release","repo maintenance","sync docs"],"related_skills":["github-repo-scout","skill-collection-bootstrapper","goal-verifier"],"publication_reviewed":"2026-06-24"}}

Oss Repo Maintainer

When to Use

• User says fix README or task matches this capability
• User says prep release or task matches this capability
• User says repo maintenance or task matches this capability
• User says sync docs or task matches this capability

Workflow

1. Diff README skill/file lists vs git tree.
2. Flag stale counts, missing install paths, broken links.
3. Propose README and CHANGELOG edits; show diff before commit.
4. Run validators (tests, skill validate) if present in repo.
5. Suggest conventional commit message; hitl-approver before git push.

Integrations

• github-repo-scout
• skill-collection-bootstrapper
• goal-verifier

Error Handling

Failure	Response
Not a git repo	Limit to file review only.

Gotchas

• Never push or publish without explicit user approval.

Safety & Ethics (Publication-Ready)

This skill is designed for public distribution. Constraints:

• Documentation accuracy focus; no unauthorized releases.
• Git push and publish require hitl-approver.
• Generic OSS workflow; no hardcoded user or org paths in instructions.

Prohibited actions

• No unauthorized access, malware, or harmful automation
• No silent exfiltration of data, credentials, or telemetry
• No destructive system changes without hitl-approver
• No publication of user PII or environment secrets in outputs

Example

Input: User request matching triggers above. Output: Structured result per workflow; local artifacts only unless user opts in.