avada-skills

CLI tool to install and publish Avada Claude skills from the Skills Directory or GitHub.

Installation

# Run directly with npx (no installation needed)
npx avada-skills install <skill-name>

# Or install globally
npm install -g avada-skills

Commands

Authentication

# Login to your Avada account
npx avada-skills login

# Check who you're logged in as
npx avada-skills whoami

# Logout
npx avada-skills logout

Install a skill

From Avada Skills Directory:

# Install a skill (interactive - prompts for agent selection)
npx avada-skills install shopify-api-essentials

# Install a specific version
npx avada-skills install [email protected]

# Skip prompts and install to all detected agents
npx avada-skills install shopify-api-essentials -y

# Specify which agents to install to
npx avada-skills install shopify-api-essentials --agents claude cursor

# Install globally to home directory
npx avada-skills install shopify-api-essentials --global

# Install to a specific directory
npx avada-skills install shopify-api-essentials --dir ./my-project

From GitHub:

# Install from a GitHub repository
npx avada-skills install https://github.com/owner/repo

# Install a specific skill from a multi-skill repo
npx avada-skills install https://github.com/vercel-labs/agent-skills --skill react-best-practices

# Install from a specific branch/path
npx avada-skills install https://github.com/owner/repo/tree/main/skills/my-skill

The CLI looks for skills in:

• Repository root (if it has SKILL.md)
• skills/ folder with subdirectories containing SKILL.md

What gets installed

Packages can contain both skills and commands:

.claude/
├── skills/           # Skill files (markdown instructions)
│   └── my-skill/
│       └── SKILL.md
└── commands/         # Command files (slash commands)
    └── my-command.md

Both are installed to the appropriate agent directories.

Supported agents

| Agent | Skills Path | Commands Path | |-------|-------------|---------------| | Claude Code | .claude/skills/ | .claude/commands/ | | Cursor | .cursor/skills/ | .cursor/commands/ | | Gemini CLI | .gemini/skills/ | .gemini/commands/ | | Antigravity | .agent/skills/ | .agent/commands/ | | Codex | .codex/skills/ | .codex/commands/ | | OpenCode | .opencode/skills/ | .opencode/commands/ | | Trae | .trae/skills/ | .trae/commands/ | | Windsurf | .windsurf/skills/ | .windsurf/commands/ |

List available skills

npx avada-skills list
npx avada-skills list --category development

Search for skills

npx avada-skills search react
npx avada-skills search "shopify api"

Publish a skill

Requires authentication. Run npx avada-skills login first.

# Publish from current directory's .claude/skills/<skill-name>
npx avada-skills publish my-skill

# Publish with metadata
npx avada-skills publish my-skill \
  --name "My Skill" \
  --description "A helpful skill" \
  --category development \
  --tags "react,frontend" \
  --version 1.0.0 \
  --changelog "Initial release"

Authentication Flow

1. Run npx avada-skills login
2. Visit the URL shown (https://dev.avada.io/skills/cli-auth)
3. Login with your avada.io or mageplaza.com Google account
4. Copy the CLI token
5. Paste it in the terminal

Credentials are stored in ~/.avada/credentials.json.

Environment Variables

• AVADA_SKILLS_API - Override the default API endpoint (default: https://dev.avada.io/api/skills)

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

Publishing Updates

# Bump version and publish
npm version patch
npm publish