---
name: stijnman/oss-repo-maintainer
source: https://app.decimal.ai/s/stijnman-oss-repo-maintainer@1/SKILL.md
source_sha256: 0b44f3f369b5
---

# 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.