compozycompozyOfficialยท5 Agent Skills Included

skeeper

Sync spec docs to a sidecar Git repo with lockfile-pinned commits

Mirrors SPEC.md, ADRs, RFCs, and plan files into a sidecar Git repository while pinning every main commit to exact sidecar commits via a tracked skeeper.lock file. Keeps pull request diffs focused on code instead of bloated documentation changes, with strict Git hooks that fail the commit if the sidecar state cannot be proven. Provides status, pull, push, sync, restore, and repair commands plus a GitHub Action for CI verification.
npx skills add compozy/skeeper --all -g -y
Available:

Instructs the coding agent on mandatory verification gates, coding standards, and a skill dispatch protocol that routes each task domain to the correct sub-skills before writing code.

All Skills in This Repository (5)

Pure Emerald Level Indicators

Frequently Asked Questions

FAQPage Schema
How to install skeeper?โ–ผ

Run `npx skills add compozy/skeeper --all -g -y` in your terminal to install all skills in this suite globally.

What problem does skeeper solve?โ–ผ

It keeps spec documents like SPEC.md, ADRs, and plan files out of your main repo's PR diffs by mirroring them into a sidecar Git repository, while a committed skeeper.lock file proves which spec state shipped with each commit.

How do I set up skeeper in my repository?โ–ผ

Run `skeeper init` inside any Git repository to interactively create the sidecar repo, write .skeeper.yml, and install the managed Git hooks. Then edit specs and commit normally; the hooks sync automatically.

What happens if a spec sync fails during commit?โ–ผ

The commit fails closed by design so code and specs never silently drift. You can run `skeeper status` to diagnose, `skeeper repair` to fix local state, or use the audited `SKEEPER_SKIP=1` bypass which stays visible until you run `skeeper sync`.

Can multiple projects share one sidecar repository?โ–ผ

Yes. Each project uses a unique namespace, and skeeper stores files under namespace prefixes with branch-aware refs, so shared sidecars never collide.

Related Repositories in Software Engineering

View All in Software Engineeringโ†’