Skip to main content

Overview

You can define multiple skills in one project to organize tools logically, then add them all to your agent.

When to Use Multiple Skills

✅ Tools serve different purposes✅ Different teams own different skills✅ Skills need different deployment schedules✅ Clear logical separation

Example: E-commerce Platform

Benefits

Logical Organization

Group related tools together

Independent Versions

Version each skill separately

Clear Ownership

Different teams maintain different skills

Flexible Deployment

Deploy skills independently

How It Works

Configuration

lua.skill.yaml tracks all skills:

Deployment

All skills push and deploy together:

Real-World Examples

Customer Service Platform

Restaurant Management

Best Practices

Each skill should have a clear, single purpose:✅ Good: “product-catalog-skill”, “order-management-skill”❌ Bad: “general-skill”, “everything-skill”
Keep skills manageable:
  • Small: 2-5 tools
  • Medium: 6-10 tools
  • Large: 11-20 tools
  • Too large: > 20 tools (consider splitting)
Each skill is versioned independently in lua.skill.yaml:
Use services for shared logic:

Migration Strategies

From Single to Multiple Skills

1

Identify Groups

Group related tools together
2

Create New Skills

Define new LuaSkill instances
3

Move Tools

Assign tools to appropriate skills
4

Update Context

Write specific context for each skill
5

Test

Test all skills together
6

Deploy

Push and deploy as usual

Example Migration

Before (Single Skill):
After (multiple skills):

Next Steps

Best Practices

Advanced tips and patterns

Tool Examples

See working multi-skill examples