| name | codex-oss-maintainer-toolkit |
| description | Build Codex-native workflows for open-source maintenance. Use when creating AGENTS.md guidance, maintainer skills, issue triage flows, PR review prompts, release-note routines, or repository verification scripts. |
Codex OSS Maintainer Toolkit
Use this skill to turn an open-source repository into a Codex-friendly maintainer workspace.
Quick Start
./install.sh --project --target /path/to/repo --yes
./install.sh --global --yes
python3 scripts/init_skill.py issue-triage
python3 scripts/quick_validate.py .codex/skills/issue-triage
What This Skill Optimizes
- project-level
AGENTS.md
- maintainer-focused Codex skills
- issue triage and bug-investigation workflows
- PR review and release-note prompts
- reusable verification commands
- cross-session dev docs for long-running tasks
Recommended Workflow
-
Audit the repository
- Identify maintainer bottlenecks: issue triage, review latency, release friction, repeated debugging.
- Map the folders that need project-specific instructions.
-
Write AGENTS.md close to the work
- Keep global instructions short.
- Add repo-specific rules, validation commands, and ownership notes.
- Prefer operational guidance over abstract philosophy.
-
Move repeatable tasks into skills or scripts
- Use
scripts/init_skill.py for reusable task playbooks.
- Put durable procedures in
references/.
- Put deterministic checks in
templates/automation/ or project scripts.
-
Design for maintainers, not demos
- Prioritize issue triage, review, release, dependency updates, and regression checks.
- Keep verification commands next to the workflow that needs them.
-
Validate before shipping
- Run targeted checks.
- Search for stale branding or paths.
- Keep templates and examples in sync.
Maintainer Workflow Patterns
Issue Triage
- summarize the report
- classify bug vs feature vs support request
- link affected paths and owners
- propose the next maintainer action
PR Review
- inspect diff boundaries first
- check architecture, tests, rollback risk, and release notes
- produce actionable comments instead of generic praise
Debugging
- reproduce first
- inspect the failing path before editing
- test one hypothesis at a time
- verify both the fix and the absence of regressions
Release Notes
- group changes by user-facing impact
- capture migrations, flags, or rollout constraints
- link verification commands and rollback notes
Files to Read When Needed
references/workflows.md: multi-step maintainer workflow patternsreferences/output-patterns.md: structured output formats for triage, review, and release communicationtemplates/AGENTS.md: project bootstrap templatetemplates/automation/README.md: helper script usage
Validation Checklist
