Skills Command

Overview

The lua skills command provides a dedicated interface for viewing local skills and managing production skill deployments.

lua skills               # Interactive: choose environment
lua skills sandbox       # Direct: view local skills
lua skills staging       # Direct: alias for sandbox
lua skills production    # Direct: manage production skills

Dedicated skills management command with environment-specific features!

Non-Interactive Mode

# View local skills (sandbox)
lua skills sandbox view

# View all production skills
lua skills view

# View skill versions
lua skills versions --skill-name mySkill

# Deploy specific version
lua skills deploy --skill-name mySkill --skill-version 1.0.3

# Deploy latest version
lua skills deploy --skill-name mySkill --skill-version latest

lua skills sandbox view prints local skills and exits (no interactive menu) - perfect for CI/CD pipelines and automation scripts.

Option	Description
`--skill-name <name>`	Skill name (for versions/deploy)
`--skill-version <ver>`	Version or ‘latest’ (for deploy)

Environment	Action	Description	Required Options
`sandbox`	`view`	Print local skills and exit	None
`production`	`view`	List all production skills	None
`production`	`versions`	View skill version history	`--skill-name`
`production`	`deploy`	Deploy specific version	`--skill-name`, `--skill-version`

Sandbox Mode

View local skills from lua.skill.yaml

Production Mode

Manage deployed skills and versions

Version History

View all skill versions

Deploy Versions

Deploy specific versions to production

Usage Modes

Interactive Mode
Direct Mode - Sandbox
Direct Mode - Production

Default behavior - prompts for environment

$ lua skills
? Select environment:
  › 🔧 Sandbox (local skills)
    🚀 Production (deployed skills)

Best for: When you’re exploring or not sure which environment

Skip prompt and view local skills

$ lua skills sandbox
# No prompt - shows local skills immediately

Best for: Quick reference during development

Skip prompt and manage production skills

$ lua skills production
# No prompt - opens production management immediately

Best for: Fast deployments, production management

Sandbox Mode

View skills defined in your local lua.skill.yaml file.

lua skills sandbox

Features

View Skills

Display all skills from your configuration

============================================================
🔧 Local Skills (Sandbox)
============================================================

1. customer-service
   Version: 1.0.5
   Skill ID: skill_abc123

2. order-management
   Version: 0.8.2
   Skill ID: skill_xyz789

Quick Actions

Access to common commands:

📦 Compile skill
☁️ Push to server
🔄 Refresh list

Example Session

$ lua skills sandbox

============================================================
🔧 Local Skills (Sandbox)
============================================================

1. customer-service
   Version: 1.0.5
   Skill ID: skill_abc123

? What would you like to do?
  › Refresh list
    Compile skill
    Push to server
    Exit

# Select "Compile skill"
🔨 Compiling Lua skill...
✅ Skill compiled successfully - 10 tools bundled

Use Cases

Quick Reference

Check skill names and IDs without opening the config file:

lua skills sandbox

Before Compiling

Verify your skills are correctly defined:

lua skills sandbox
# Check versions and IDs
lua compile

Multi-Skill Projects

View all skills in a multi-skill project:

lua skills sandbox
# Shows all skills defined in lua.skill.yaml

Production Mode

View deployed skills and manage production versions.

lua skills production

Features

View Deployed Skills

List all skills with active versions

============================================================
🚀 Production Skills
============================================================

1. customer-service
   Active Version: 1.0.5
   Skill ID: skill_abc123

2. order-management
   Active Version: 0.8.2
   Skill ID: skill_xyz789

Version History

View complete version history for each skill

? Select skill: customer-service

Version History for customer-service:
• 1.0.5 (ACTIVE) - Created: Oct 12, 2025
• 1.0.4 - Created: Oct 10, 2025
• 1.0.3 - Created: Oct 5, 2025
• 1.0.2 - Created: Oct 1, 2025

Deploy Specific Version

Deploy any version to production

? Select version to deploy: 1.0.4

⚠️  WARNING: You are about to deploy to PRODUCTION!
⚠️  This will affect ALL users immediately.

? Are you absolutely sure? Yes

🔄 Deploying version 1.0.4...
✅ Version 1.0.4 deployed successfully

Example Session

$ lua skills production
✅ Authenticated

============================================================
🚀 Production Skills
============================================================

1. customer-service
   Active Version: 1.0.5
   Skill ID: skill_abc123

2. order-management
   Active Version: 0.8.2
   Skill ID: skill_xyz789

? What would you like to do?
  › View version history
    Deploy specific version
    Refresh list
    Exit

# Select "View version history"
? Select skill: customer-service

Version History for customer-service:
• 1.0.5 (ACTIVE) - Created: Oct 12, 2025 10:30 AM
• 1.0.4 - Created: Oct 10, 2025 3:45 PM
• 1.0.3 - Created: Oct 5, 2025 9:15 AM

? Select version to deploy: 1.0.4

⚠️  WARNING: You are about to deploy to PRODUCTION!
⚠️  This will affect ALL users immediately.

Current: 1.0.5
New: 1.0.4

? Are you absolutely sure you want to deploy? Yes

🔄 Deploying version 1.0.4...
✅ Version 1.0.4 deployed successfully to production

Use Cases

Check Active Versions

Verify what’s running in production:

lua skills production
# See active versions at a glance

Rollback

Roll back to a previous version:

lua skills production
# Select skill → View history → Deploy older version

Deploy Specific Version

Deploy a specific version instead of latest:

lua skills production
# Choose exact version to deploy

Version Audit

Review deployment history:

lua skills production
# View when each version was created

Safety Features

Production deployments require two confirmations:

Select version to deploy
Confirm deployment (defaults to “No”)

This prevents accidental deployments and ensures you’re deploying the right version.

Complete Workflows

Development Workflow

# 1. Check local skills
lua skills sandbox

# 2. Make changes to tools
vim src/tools/MyTool.ts

# 3. Compile
lua compile

# 4. Test
lua test

# 5. Push new version
lua push skill

# 6. Check production before deploying
lua skills production

# 7. Deploy
lua deploy

Rollback Workflow

# 1. Check what's deployed
lua skills production

# 2. View version history
# Select skill → View history

# 3. Deploy previous version
# Select older version → Confirm

# Done! Previous version is live

Multi-Skill Management

# View all skills
lua skills sandbox

# Work on specific skill
cd my-project
vim src/tools/CustomerServiceTool.ts

# Compile specific skill
lua compile

# Push only that skill
lua push skill

# Deploy to production
lua skills production
# Select the skill you just pushed

Comparison with Other Commands

Command	Purpose	Environment
`lua skills sandbox`	View local skill configuration	Local
`lua skills production`	Manage deployed skills	Server
`lua compile`	Compile skills to bundles	Local
`lua push skill`	Upload new skill version	Server
`lua deploy`	Deploy to production (all skills)	Server
`lua production`	View production environment	Server

Best Practices

Check Before Deploying

Always check what’s currently deployed:

lua skills production
# Review active versions
lua deploy

Keep Version History

Don’t delete old versions - they’re your rollback points:

lua skills production
# View history → Shows all available versions

Test in Sandbox First

Always test locally before pushing:

lua skills sandbox  # Verify configuration
lua test           # Test tools
lua chat           # Test conversationally
lua push skill     # Then push

Document Version Changes

Use semantic versioning and keep notes:

# In lua.skill.yaml
skills:
  - name: customer-service
    version: 1.1.0  # Minor: Added FAQ tool

Troubleshooting

No skills found in sandbox

Error: “No skills found in lua.skill.yaml”Solution:

Ensure you’re in a skill directory
Check lua.skill.yaml has skills defined
Run lua compile to populate skills

Can't see production skills

Error: “Failed to fetch production skills”Solution:

Verify authentication: lua auth key
Check network connection
Ensure you’ve pushed at least one version

Version not showing in history

Problem: Pushed version doesn’t appearSolution:

Refresh the list
Verify push was successful
Check you’re viewing correct skill

Can't deploy version

Error: “Version not found”Solution:

Verify version exists: lua skills production
Check version number matches exactly
Ensure version was pushed successfully

lua compile

Compile skills before viewing in sandbox

lua push skill

Upload new skill versions

lua deploy

Deploy active skill versions

lua production

View overall production environment

Next Steps

Skill Management

Learn about compiling and pushing skills

Production Command

Comprehensive production management

Build Your First Skill

Complete skill development tutorial

Multi-Skill Projects

Managing multiple skills

Getting Started

Core Concepts

CLI Commands

API Reference

Template & Examples

Overview

Non-Interactive Mode

Sandbox Mode

Production Mode

Version History

Deploy Versions

Usage Modes

Sandbox Mode

Features

Example Session

Use Cases

Production Mode

Features

Example Session

Use Cases

Safety Features

Complete Workflows

Development Workflow

Rollback Workflow

Multi-Skill Management

Comparison with Other Commands

Best Practices

Troubleshooting

lua compile

lua push skill

lua deploy

lua production

Next Steps

Skill Management

Production Command

Build Your First Skill

Multi-Skill Projects

​Overview

​Non-Interactive Mode

Sandbox Mode

Production Mode

Version History

Deploy Versions

​Usage Modes

​Sandbox Mode

​Features

​Example Session

​Use Cases

​Production Mode

​Features

​Example Session

​Use Cases

​Safety Features

​Complete Workflows

​Development Workflow

​Rollback Workflow

​Multi-Skill Management

​Comparison with Other Commands

​Best Practices

​Troubleshooting

​Related Commands

lua compile

lua push skill

lua deploy

lua production

​Next Steps

Skill Management

Production Command

Build Your First Skill

Multi-Skill Projects

Overview

Non-Interactive Mode

Usage Modes

Sandbox Mode

Features

Example Session

Use Cases

Production Mode

Features

Example Session

Use Cases

Safety Features

Complete Workflows

Development Workflow

Rollback Workflow

Multi-Skill Management

Comparison with Other Commands

Best Practices

Troubleshooting

Related Commands

Next Steps