Buckle

buckle

Install a **Hub-and-Spoke** agent documentation skill into the location your coding agent expects.

The hub is `AGENTS.md` at the repo root — a one-screen table of contents that routes agents to spoke files (docs, runbooks, conventions, ADRs). Tool-specific files (`CLAUDE.md`, `.cursorrules`, `GEMINI.md`, …) become one-line pointers back to the hub, so rules don't drift across tools.

`buckle` is a single Go binary that writes the skill content into the right file for each tool. The skill itself lives at [`buckle/SKILL.md`](buckle/SKILL.md) and is embedded into the binary at build time.

Install

# From source (latest):
go install github.com/WagnerJust/buckle/cmd/buckle@latest

Or grab a pre-built archive from the [releases page](https://github.com/WagnerJust/buckle/releases) — Linux, macOS, and Windows on amd64 / arm64.

Usage

# Dry-run: show where buckle would install the skill for Claude Code (default).
buckle install

# Install for Claude Code in the current repo.
buckle install --apply

# Install for Cursor.
buckle install --target cursor --apply

# Install Claude's skill globally under a custom dir.
buckle install --target claude --global --dir ~/.agents --apply

# List supported targets.
buckle install --list

# Print version / commit / build date.
buckle version

Default is **dry-run** — `--apply` is required to actually write.

Supported targets

ID	Tool	Path
claude	Claude Code	.claude/skills/buckle/SKILL.md
cursor	Cursor	.cursor/rules/buckle.mdc
gemini	Gemini Code Assist	GEMINI.md (shared)
codex	OpenAI Codex CLI	AGENTS.md (shared)
opencode	OpenCode	AGENTS.md (shared)
windsurf	Windsurf