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
- Use Multiple When
- Use Single When
✅ 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
Keep Skills Focused
Keep Skills Focused
Each skill should have a clear, single purpose:✅ Good: “product-catalog-skill”, “order-management-skill”❌ Bad: “general-skill”, “everything-skill”
Limit Tools Per Skill
Limit Tools Per Skill
Keep skills manageable:
- Small: 2-5 tools
- Medium: 6-10 tools
- Large: 11-20 tools
- Too large: > 20 tools (consider splitting)
Version Independently
Version Independently
Each skill is versioned independently in
lua.skill.yaml:Share Common Code
Share Common Code
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

