Lumi Skills

A CLI tool to install AI skills for multiple coding assistants. Transform your AI coding assistant into a specialized agent with domain-specific knowledge and workflows.

Supported Platforms

| Platform | Config Location | Format | |----------|----------------|--------| | Claude Code | .claude/skills/{skill}/SKILL.md | YAML frontmatter + Markdown | | Cursor | .cursor/rules/{skill}/RULE.md | YAML frontmatter + Markdown | | Gemini CLI | GEMINI.md | Pure Markdown | | OpenAI Codex | AGENTS.md | Pure Markdown | | GitHub Copilot | .github/copilot-instructions.md | Pure Markdown | | Antigravity | .gemini/GEMINI.md | Pure Markdown + Workflows |

Quick Start

Run directly with npx (no installation required):

npx lumi-skills init

Installation

# Global installation
npm install -g lumi-skills

# Then use anywhere
lumi-skills init

Usage

Interactive Mode

# Using npx (recommended for one-time use)
npx lumi-skills init

# Or if installed globally
lumi-skills
lumi-skills init

Select skills and platforms interactively.

List Available Skills

lumi-skills list

Install Specific Skill

# Install to all platforms
lumi-skills install git-commit

# Install to specific platform
lumi-skills install git-commit -p claude-code
lumi-skills install git-commit -p cursor

Create New Skill

# Create a new skill template
lumi-skills create my-skill

# Or specify output directory
lumi-skills create my-skill -d ./skills

This creates:

my-skill/
├── SKILL.md         # Main skill definition
├── references/      # Documentation files
└── scripts/         # Reusable scripts

Available Skills

| Skill | Description | |-------|-------------| | git-commit | Generate commit messages following Conventional Commits | | git-pr | Generate PR descriptions with summary, changes, testing notes | | pdf | PDF manipulation: extract text, create, merge, split, forms | | xlsx | Spreadsheet operations: formulas, formatting, data analysis | | pptx | Presentation creation and editing | | docx | Document creation with tracked changes and comments |

How It Works

1. Skills are defined using Claude's SKILL.md format with YAML frontmatter
2. The CLI transforms skills to the target platform's format
3. Shared resources (scripts, references) are copied to .lumi/{skill-id}/
4. Platform-specific files reference the shared resources

Directory Structure After Installation

your-project/
├── .lumi/                    # Shared resources
│   └── {skill-id}/
│       ├── references/
│       └── scripts/
├── .claude/skills/           # Claude Code
│   └── {skill-id}/SKILL.md
├── .cursor/rules/            # Cursor
│   └── {skill-id}/RULE.md
├── .gemini/GEMINI.md         # Antigravity
├── .github/copilot-instructions.md  # Copilot
├── GEMINI.md                 # Gemini CLI
└── AGENTS.md                 # OpenAI Codex

Creating Custom Skills

Create a skill directory with a SKILL.md file:

---
name: my-skill
description: Description of what this skill does
allowed-tools: Bash, Read  # Optional
---

# My Skill

Instructions for the AI assistant...

Optional bundled resources:

• references/ - Documentation files
• scripts/ - Executable scripts
• assets/ - Templates, images, etc.

License

MIT