Troubleshooting

❌ No API key found. Run `lua auth configure` first.

lua auth configure

❌ API key validation failed

❌ No lua.skill.yaml found. Please run this command from a skill directory.

❌ Directory is not empty. Please use an empty directory.

mkdir my-new-skill
cd my-new-skill
lua init

EACCES: permission denied

❌ No index.ts found in current directory or src/ directory

import { LuaSkill } from "lua-cli";

const skill = new LuaSkill({
  name: "my-skill",
  description: "My skill description",
  context: "How to use this skill",
  tools: []
});

❌ Compilation failed:
src/tools/MyTool.ts:10:5 - error TS2322: Type 'string' is not assignable to type 'number'.

// Error at line 10
const age: number = "25";  // ❌ Wrong type
const age: number = 25;    // ✅ Correct

❌ Cannot find module 'lua-cli'

❌ Tool names can only contain alphanumeric characters, hyphens (-), and underscores (_).

// ❌ Invalid
name = "get weather";    // Spaces
name = "get.weather";    // Dots
name = "get@weather";    // Special chars

// ✅ Valid
name = "get_weather";
name = "get-weather";
name = "getWeather";

❌ Version 1.0.0 already exists on the server

skills:
  - name: my-skill
    version: 1.0.1  # Increment this

lua push

❌ Version mismatch: config has 1.0.1, deploy.json has 1.0.0

lua compile
lua push

⚠️  Drift detected in: name, persona

lua sync

💻 Local (code):
(no persona in code)

❌ EADDRINUSE: address already in use :::3000

💡 The skill doesn't exist on the server.
Please run "lua push" first to deploy your skill.

lua push  # Push first
lua chat  # Then test in sandbox mode

❌ No versions available to deploy

lua push  # Push a version first
lua deploy

❌ Deployment failed: [error message]

async execute(input: any) {
  const results = await Data.search('articles', input.query);
  
  // Add this FIRST, before any mapping
  console.log('Raw result:', JSON.stringify(results, null, 2));
  
  // Then push and check logs:
  // lua logs --type skill --limit 5
}

# All skill logs (most recent)
lua logs --type skill --limit 20

# Filter to a specific skill
lua logs --type skill --name my-skill-name --limit 10

# JSON output (for parsing)
lua logs --type skill --json

# Other component types
lua logs --type job --name daily-report --limit 5
lua logs --type webhook --name stripe --limit 10
lua logs --type preprocessor --limit 20

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# Instead of
C:\Users\YourName\Documents\Projects\MyCompany\Skills\my-skill

# Use
C:\projects\my-skill

# Ubuntu/Debian
sudo apt-get install libsecret-1-dev

# Fedora/RHEL
sudo dnf install libsecret-devel

# Arch
sudo pacman -S libsecret

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g lua-cli

npm update

rm -rf node_modules package-lock.json
npm install

npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

# Stop current process (Ctrl+C)
lua chat  # Start again

lua env

npm update -g lua-cli

lua --version

git add lua.skill.yaml
git commit -m "Update skill config"

.env
.env.local

lua chat  # Test conversationally (sandbox mode)
lua test  # Optional: Test specific tools
lua push  # Push when ready
lua deploy  # Deploy to production