Open Source Maintenance
Use this skill when a repository needs public open-source readiness.
Goal
Keep public project metadata consistent, useful, and low-maintenance.
Checklist
- Confirm the intended license and update
LICENSEplus manifest/package metadata. - Make README useful to a first-time visitor:
- what it is
- what problem it solves
- quick start
- repository layout
- usage examples
- development and validation
- contribution path
- license
- Add or update
CONTRIBUTING.mdwhen outside contributors are expected. - Add or update
CHANGELOG.mdfor user-visible changes. - Check version impact with
version-governance. - Run plugin or repository validation.
- Use
release-workflowbefore PR or GitHub release work.
For this plugin, prefer:
python3 plugins/openarc/scripts/openarc.py doctor plugins/openarc
Rules
- Do not invent maintainer contact details, repository URLs, or governance promises.
- Prefer concise public docs over marketing copy.
- Keep README and manifest metadata aligned.
- Do not publish or tag a release without maintainer confirmation.