Getting started

Five minutes from zero to a skill shared between two projects.

1. Install

Homebrew:

brew install evgeniiPerov/tap/quay

Or download a release binary from https://github.com/evgeniiPerov/quay/releases and put it on your PATH.

Verify:

quay --version

macOS Gatekeeper: the first run may be blocked. Right-click the binary → Open once, or xattr -dr com.apple.quarantine /opt/homebrew/bin/quay.

2. Create a profile

A profile holds your default hub URL, default branch, push mode (PR or direct), and provider kind. The interactive wizard sets everything in one go:

quay profile add -i

Pick a name (e.g. work), paste your hub URL (e.g. git@github.com:my-org/skills-hub.git), answer two more prompts. Done.

Confirm it took:

quay profile show

3. Launch the TUI

quay tui

The Dashboard lists your remotes, recent pushes, and outdated installed skills. Press [1]/[2]/[3] to switch screens, [,] for Settings, [q] to quit.

4. Author a skill

From any project directory:

mkdir -p .agents/skills/hello
$EDITOR .agents/skills/hello/SKILL.md

Paste a minimal frontmatter skill:

---
name: hello
description: Say hello.
version: 0.1.0
---

# Hello

Print "hi" when the agent starts.

5. Push

quay push hello

quay clones your hub into a temp dir, drops the skill into skills/hello/SKILL.md, updates the hub's registry.json, commits, and (depending on push_mode) opens a PR or pushes the commit directly. The URL is printed on success.

From the TUI: open Local ([2]), select hello, press [u].

6. Install in a different project

In a freshly-cloned repo on another machine:

quay add hello

The skill lands at .agents/skills/hello/SKILL.md. Mirror dirs (.claude/, .cursor/, etc.) are populated automatically based on your profile.

Next steps