# Repo Setup

> Set up repository policy and local Codex configuration for trunk-based development. Use when the user wants GitHub branch-protection guidance, `.codex/config.toml` direction, or a repo-local operating model aligned with direct trunk commits.

- Skill: `jwilger/repo-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jwilger/repo-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jwilger/repo-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: jwilger (https://skillmd.com/u/jwilger)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jwilger/repo-setup

---


# Repo Setup

This skill sets the repository-level rules around Codex usage.

## Defaults

- Protect `main` or the chosen trunk branch.
- Require linear history.
- Disable force-push.
- Avoid a required-PR workflow unless the user explicitly wants one.

## GitHub guidance

Recommend:

- branch protection on trunk
- linear history required
- force-push blocked
- optional required status checks only for checks that are fast and reliable enough to stay on the main path

## Local Codex guidance

- Keep the repo trusted in `.codex/config.toml` when appropriate.
- Prefer repo-local `AGENTS.md` and repo-local plugin usage over home-global instruction sprawl.
- Keep custom agents optional and task-specific.

## Deliverables

- A short branch-protection checklist
- Any needed repo-local Codex config notes
- A clear statement of what is enforced by GitHub versus what is enforced by skills and hooks