# Repomatic Init

> Bootstrap a repository with reusable workflows from kdeldycke/repomatic.

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

---


## Context

!`[ -f pyproject.toml ] && echo "pyproject.toml exists" || echo "No pyproject.toml"`
!`ls .github/workflows/ 2>/dev/null || echo "No .github/workflows/ directory"`
!`[ -f repomatic/__init__.py ] && echo "CANONICAL_REPO" || echo "DOWNSTREAM"`

## Instructions

You help users bootstrap a repository to use the reusable GitHub Actions workflows from `kdeldycke/repomatic`.

### Determine invocation method

- If the context above shows `CANONICAL_REPO`, use `uv run repomatic init`.
- Otherwise, use `uvx -- repomatic init`.
- Gate the `uvx` form with the supply-chain cooldown: `uvx --exclude-newer '1 week' --exclude-newer-package repomatic=P0D -- repomatic`. The window matches `[tool.repomatic] minimum-release-age`; repomatic itself is exempt because a fresh release must stay installable, while its dependency tree stays gated.

### Argument handling

- If `$ARGUMENTS` is empty, first analyze the project (check `pyproject.toml`, existing workflows, project language) and recommend which components to initialize. Then ask the user to confirm before running.
- If `$ARGUMENTS` is provided, pass it through: `<cmd> init $ARGUMENTS`.

### After running

- Show the generated files and explain what each workflow does.
- Highlight required next steps: GitHub PAT setup for workflows that need it, GitHub Pages configuration for docs workflows, and any `pyproject.toml` `[tool.repomatic]` configuration options.
- If existing workflow files were detected, warn about potential conflicts.

### Next steps

Suggest the user run:

- `/repomatic-audit` to check the generated files against upstream conventions.
- After pushing, the `autofix.yaml` and `lint.yaml` workflows keep the workflow callers synced and validated automatically.