Lua Marketplace

Open-source marketplace skills and agent implementations for Lua. Browse, use, and contribute conversational AI agents.

What is this?

This repository contains community-contributed agent implementations that you can:

• Install directly to your Lua agent via the marketplace
• Copy into your own codebase and extend
• Learn from as reference implementations

Available Skills

Skill	Description	Category
lua-shopify	E-commerce agent for Shopify stores with product search, cart, and checkout	E-commerce

Using a Skill

Option 1: Install from Marketplace

If the skill is listed on the Lua Marketplace, you can install it directly:

lua marketplace install <skill-name> --agent <your-agent-id>

Option 2: Copy and Customize

Clone this repo and copy the skill folder into your project:

git clone https://github.com/heylua/lua-marketplace.git
cp -r lua-marketplace/lua-shopify ./my-agent/

Then customize the implementation to fit your needs.

Contributing a Skill

We welcome contributions! To add your skill to the marketplace:

1. Fork and Clone

git clone https://github.com/<your-username>/lua-marketplace.git
cd lua-marketplace

2. Create Your Skill

Create a new folder with the naming convention lua-<skill-name>/:

lua-marketplace/
├── lua-your-skill/
│   ├── README.md           # Documentation (required)
│   ├── package.json        # Dependencies
│   ├── tsconfig.json       # TypeScript config
│   ├── env.example         # Required environment variables
│   ├── lua.skill.yaml      # Agent manifest (remove agentId before PR)
│   └── src/
│       ├── index.ts        # LuaAgent configuration
│       ├── skills/
│       │   └── your-skill.ts
│       ├── services/       # Business logic
│       ├── dtos/           # Type definitions
│       ├── jobs/           # Scheduled tasks (optional)
│       └── webhooks/       # Webhook handlers (optional)

3. Document Your Skill

Your README.md should include:

• Description - What the skill does
• Features - Key capabilities
• Quick Start - How to set up and use
• Environment Variables - Required configuration
• Tools - Available tools and their parameters
• Example Conversation - Show it in action

4. Clean Up Before Submitting

Remove any sensitive or personal data:

# lua.skill.yaml - Remove these before PR
agent:
  agentId: # Remove
  orgId: # Remove

5. Submit a Pull Request

1. Push your changes to your fork
2. Open a PR against main
3. Fill out the PR template with:
   • Skill description
   • Testing instructions
   • Screenshots/demos if applicable

Skill Guidelines

Required

• Clear README.md with setup instructions
• env.example file listing required environment variables
• TypeScript source code
• Working package.json with all dependencies

Recommended

• Example conversations showing the skill in action
• Comprehensive tool descriptions
• Error handling for edge cases
• Support for multiple environments (sandbox/production)

Security

• Never commit API keys, tokens, or secrets
• Use environment variables for all credentials
• Document required API permissions clearly
• Implement proper input validation

Project Structure

lua-marketplace/
├── README.md                 # This file
├── lua-shopify/              # Shopify e-commerce agent
├── lua-calendar/             # (example) Calendar management
├── lua-crm/                  # (example) CRM integration
└── ...

Related Resources

• Lua Documentation
• Lua CLI
• Lua Marketplace
• Discord Community

License

MIT License - see individual skill folders for specific licenses.

---

Built with Lua