agk

A terminal-based manager for distributing AI agent skills and instructions across multiple providers.

Manage vaults of reusable skills and instructions, then install them to Claude Code, GitHub Copilot, Gemini, and other AI platforms — all from an interactive TUI.

Features

• Multi-provider support — Install to Claude Code, GitHub Copilot, Gemini, Letta, Snowflake, Firebender, and AMP
• Local & GitHub vaults — Source skills from local directories or any GitHub repository
• Interactive TUI — Browse, search, install, and update assets with keyboard navigation
• Change detection — SHA-based hashing detects when vault assets have been updated
• Scoped configuration — Global settings for vaults, workspace-level settings for providers and installed assets
• Batch operations — Update all installed assets at once with F5

Installation

Homebrew (macOS & Linux)

brew tap dkthezero/agk
brew install agk

Cargo (from source)

cargo install agk

From releases (macOS, Linux, Windows)

Download pre-built binaries from the Releases page.

Quick start

Launch the TUI:

agk

Attach a vault

1. Press 4 to switch to the Vaults tab
2. Press F2 to attach a new vault
3. Enter a local path (./my-vault) or GitHub URL (owner/repo)
4. Follow the prompts for branch and subfolder

Install a skill

1. Press 1 to switch to the Skills tab
2. Navigate with arrow keys, press Space to install
3. The skill is copied to all active providers

Configure providers

1. Press 3 to switch to the Providers tab
2. Press Space to toggle providers on/off

Keybindings

Vault structure

agk expects vaults to follow this layout:

my-vault/
├── skills/
│   ├── my-skill/
│   │   ├── SKILL.md        # Required
│   │   └── ...              # Supporting files
│   └── another-skill/
│       └── SKILL.md
└── instructions/
    └── my-instruction/
        ├── AGENTS.md        # Required
        └── ...

Skills and instructions support optional YAML frontmatter for metadata:

---
name: my-skill
version: 1.0.0
---
# My Skill
...

Configuration

agk uses two configuration scopes:

Clean up

agk clean            # Remove workspace config
agk clean --global   # Remove global config

Supported providers

Development

# Build
cargo build

# Run
cargo run

# Test
cargo test

Support

If you find agk useful, consider supporting its development:

License

MIT