Skip to main content

​
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
New in v2.6.0: Dedicated skills management command with environment-specific features!

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

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

​
Sandbox Mode

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

​
Features

1

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
2

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

Check skill names and IDs without opening the config file:
lua skills sandbox
Verify your skills are correctly defined:
lua skills sandbox
# Check versions and IDs
lua compile
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

1

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
2

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
3

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

Verify what’s running in production:
lua skills production
# See active versions at a glance
Roll back to a previous version:
lua skills production
# Select skill → View history → Deploy older version
Deploy a specific version instead of latest:
lua skills production
# Choose exact version to deploy
Review deployment history:
lua skills production
# View when each version was created

​
Safety Features

Production deployments require two confirmations:
  1. Select version to deploy
  2. 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

CommandPurposeEnvironment
lua skills sandboxView local skill configurationLocal
lua skills productionManage deployed skillsServer
lua compileCompile skills to bundlesLocal
lua push skillUpload new skill versionServer
lua deployDeploy to production (all skills)Server
lua productionView production environmentServer

​
Best Practices

Always check what’s currently deployed:
lua skills production
# Review active versions
lua deploy
Don’t delete old versions - they’re your rollback points:
lua skills production
# View history → Shows all available versions
Always test locally before pushing:
lua skills sandbox  # Verify configuration
lua test           # Test tools
lua chat           # Test conversationally
lua push skill     # Then push
Use semantic versioning and keep notes:
# In lua.skill.yaml
skills:
  - name: customer-service
    version: 1.1.0  # Minor: Added FAQ tool

​
Troubleshooting

Error: “No skills found in lua.skill.yaml”Solution:
  1. Ensure you’re in a skill directory
  2. Check lua.skill.yaml has skills defined
  3. Run lua compile to populate skills
Error: “Failed to fetch production skills”Solution:
  1. Verify authentication: lua auth key
  2. Check network connection
  3. Ensure you’ve pushed at least one version
Problem: Pushed version doesn’t appearSolution:
  1. Refresh the list
  2. Verify push was successful
  3. Check you’re viewing correct skill
Error: “Version not found”Solution:
  1. Verify version exists: lua skills production
  2. Check version number matches exactly
  3. 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