flins

<div align="center">

# flins

**Universal skill and command manager for AI coding agents**

Install, manage, and update skills and commands across 17+ AI development tools from a single unified interface.

[![npm version](https://badge.fury.io/js/flins.svg)](https://www.npmjs.org/package/flins)
[![Agent Skills](https://img.shields.io/badge/Agent_Skills-standard-blue)](https://agentskills.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

</div>

## Overview

**flins** is an open-source CLI that provides a unified interface for managing agent skills and commands across all skill-compatible coding assistants. It follows a familiar command pattern while working seamlessly with the [Agent Skills](https://agentskills.io) open standard.

## Supported Agents

[Antigravity](https://antigravity.google/), [Amp](http://ampcode.com/), [Claude Code](https://claude.com/product/claude-code), [Clawdbot](https://clawdbot.com/), [Codex](https://openai.com/codex/), [CommandCode](https://commandcode.ai/), [Copilot](https://github.com/features/copilot), [Cursor](http://cursor.com/), [Factory Droid](https://factory.ai/), [Gemini CLI](https://geminicli.com/), [Goose](https://goose.ai/), [Kilo Code](https://kilo.ai/), [Kiro](https://kiro.dev/), [Letta](https://www.letta.com/), [Neovate](https://neovateai.dev/), [OpenCode](https://opencode.ai/), [OpenHands](https://openhands.ai/), [Pi](https://shittycodingagent.ai/), [Qoder](https://qoder.com/), [Qwen Code](https://qwenlm.github.io/qwen-code-docs/), [Roo Code](https://roocode.com/), [Trae](http://trae.ai/), [Windsurf](http://windsurf.com/), [Zencoder](https://zencoder.ai/)

## Installation

```bash
# Using npx (recommended)
npx flins@latest add <source>

# Using bunx
bunx --bun flins@latest add <source>

# Install globally
npm install -g flins
flins add <source>
```

## Quick Start

```bash
# Install from flins directory (Browse via `flins search` or https://flins.tech/)
flins add better-auth

# Install from GitHub
flins add expo/skills

# Install to specific agent
flins add expo -a claude-code

# Install globally
flins add expo --global

# Browse available skills
flins search
```

**flins directory** = a curated catalog of popular skills. Browse via `flins search` or https://flins.tech/

> See [Source Formats](#source-formats) below for all supported sources (GitHub, GitLab, Codeberg, etc.)

## Commands (Experimental)

> **Note:** Command support is experimental and varies by agent. No standard exists yet. Commands may work in one agent but fail in another due to incompatible syntax or features.

### Command Types

| Type       | Status            | Agents                       |
| ---------- | ----------------- | ---------------------------- |
| Markdown   | Supported         | Claude Code, OpenCode, Droid |
| JSON       | Not supported yet | OpenCode only                |
| Executable | Not supported yet | Factory Droid only           |

### Markdown Compatibility

| Feature         | Claude Code | OpenCode | Factory Droid |
| --------------- | ----------- | -------- | ------------- |
| `$ARGUMENTS`    | ✅          | ✅       | ✅            |
| `$1`, `$2`...   | ✅          | ✅       | ❌            |
| Bash `!command` | ✅          | ✅       | ❌            |
| File refs `@`   | ✅          | ✅       | ❌            |
| `allowed-tools` | ✅          | ❌       | ❌            |
| `hooks`         | ✅          | ❌       | ❌            |

## CLI Commands

| Command           | Description                         |
| ----------------- | ----------------------------------- |
| `flins add <src>` | Install skills/commands from source |
| `flins update`    | Update installed skills/commands    |
| `flins outdated`  | Check for available updates         |
| `flins remove`    | Uninstall skills/commands           |
| `flins list`      | List all installed skills/commands  |
| `flins search`    | Interactive skill browser           |
| `flins clean`     | Remove orphaned state entries       |

**Common options:**

- `-g, --global` - Install globally (user-level)
- `-a, --agent <name>` - Target specific agent
- `-s, --skill <name>` - Install specific skill by name
- `-y, --yes` - Auto-confirm all prompts
- `-f, --force` - Skip all confirmations
- `--silent` - Suppress non-error output
- `--no-symlink` - Copy files directly instead of symlinks

### Source Formats

```bash
# Directory name (Browse via `flins search` or https://flins.tech/)
flins add better-auth

# GitHub shorthand
flins add expo/skills

# GitHub full URL
flins add https://github.com/expo/skills

# GitLab
flins add https://gitlab.com/org/repo

# Codeberg
flins add https://codeberg.org/user/repo

# Any git repository
flins add https://example.com/repo.git

# Specific branch
flins add https://github.com/expo/skills/tree/develop
```

## Symlink-First Architecture

By default, flins uses symlinks for efficient skill management:

```
.agents/                    # Source files (s

... (truncated)