codex oss maintainer toolkit
- Repo stars 0
- Author repo skills-registry
- Domain
- Productivity
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Codex OSS Maintainer Toolkit
Use this skill to turn an open-source repository into a Codex-friendly maintainer workspace.
## Quick Start
```bash
./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
1. **Audit the repository**
- Identify maintainer bottlenecks: issue triage, review latency, release friction, repeated debugging.
- Map the folders that need project-specific instructions.
2. **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.
3. **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.
4. **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.
5. **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 patterns
- `references/output-patterns.md`: structured output formats for triage, review, and release communication
- `templates/AGENTS.md`: project bootstrap template
- `templates/automation/README.md`: helper script usage
## Validation Checklist
- [ ] `AGENTS.md` matches the repository layout
- [ ] public docs use Codex/OpenAI terminology consistently
- [ ] skills are concise and validated
- [ ] automation scripts have explicit inputs and outputs
- [ ] examples and templates stay synchronized
---
> Source: [ComeOnOliver/skillshub](https://github.com/ComeOnOliver/skillshub) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
Sections and files
Listed in source order.
sections -> Quick Start → What This Skill Optimizes → Recommended Workflow → Maintainer Workflow Patterns → Issue Triage → PR Review
terms -> Audit the repository · Write AGENTS.md close to the work · Move repeatable tasks into skills or scripts · Design for maintainers, not demos · Validate before shipping
files/cmd -> AGENTS.md · scripts/init_skill.py · references/ · templates/automation/ · references/workflows.md · references/output-patterns.md · templates/AGENTS.md · templates/automation/README.md
body sha256 -> f2de5528f66f
What This Skill Optimizes
project-level
AGENTS.mdmaintainer-focused Codex skills issue triage and bug-investigation workflows PR review and release-note prompts reusable verification commandsRecommended 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.
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