Skip to main content

AI Skills Installation

Lovrabet AI Skills are a set of development standards and guides customized for AI IDEs, helping AI correctly use Lovrabet SDK and CLI, reducing erroneous code and improving development efficiency.

What are AI Skills?​

Skills include the following:

SkillDescription
TypeScript SDK Usage GuideFilter, SQL, BFF three core API usage specifications
MCP SQL Creation Workflow5-step mandatory process for creating custom SQL queries
AntD UI Development StandardsAvoid generating "AI-flavored" UI code
API Integration Guidelovrabet api pull process and usage
Menu Management Guidemenu sync/update process
Backend Function Script Writing StandardsPermission filtering, data desensitization, business logic

File Structure After Installation​

your-project/
├── .cursorrules              # Cursor general rules
├── .cursor/
│   └── skills/               # Cursor skills
├── .windsurf/
│   └── workflows/            # Windsurf workflows
├── .claude/
│   └── skills/               # Claude Code skills
├── .lovrabet/
│   ├── skill-manifest.json   # Skill manifest
│   └── skill/
│       └── .shared/
│           └── guides/       # Shared guides
│               ├── 01-typescript-sdk/guide.md
│               ├── 02-mcp-sql-workflow/guide.md
│               ├── 03-antd-style/guide.md
│               ├── 05-api-integration/guide.md
│               ├── 06-menu-management/guide.md
│               └── 07-backend-function/guide.md
└── agents.md                 # Claude Code rules

Supported IDEs​

IDEConfiguration LocationDescription
Cursor.cursorrules, .cursor/Cursor IDE
Windsurf.windsurf/Windsurf IDE
Claude Code.claude/, agents.mdClaude Code
Codex.codex/Codex IDE
OpenCode.opencode/OpenCode IDE
Qoder.qoder/Qoder IDE
CodeBuddy.codebuddy/CodeBuddy IDE
Trae.trae/Trae IDE
Generic/Other.agent/Generic AI assistants

Installation Methods​

Install using the skills tool, which is the officially recommended method:

npx skills add lovrabet/lovrabet-skill

Advantages:

  • ✅ No additional CLI installation required
  • ✅ Always uses the latest version
  • ✅ Cross-platform compatible
  • ✅ Automatically detects and configures multiple IDEs

Installation Process:

  1. The skills tool automatically detects your IDE
  2. Installs Lovrabet Skills to the corresponding configuration directory
  3. Generates a unified manifest file

Method 2: Enterprise CDN (Internal Use)​

If your team has configured an enterprise CDN, you can install from the internal source:

lovrabet skill install --cursor
Note

This method is for internal enterprise use only and requires enterprise CDN access permissions. Regular users should use the npx skills add method.

Skill Content Details​

1. TypeScript SDK Usage Guide​

Master the three core APIs of Lovrabet SDK: Filter, SQL, BFF.

Includes:

  • Filter Advanced Queries - Complex condition filtering, field selection, sorting
  • SQL Custom Queries - Execute registered SQL queries
  • BFF Endpoint Calls - Call backend functions
  • Comparison and use cases of the three APIs
  • Error handling best practices

Example Comparison:

// Filter - Dataset advanced query
const result = await client.models.users.filter({
  where: { status: { $eq: 'active' } },
  select: ['id', 'name'],
  currentPage: 1,
  pageSize: 20,
});

// SQL - Custom query
const data = await client.sql.execute({
  sqlCode: 'fc8e7777-06e3847d',
  params: { userId: '123' }
});

// BFF - Backend function call
const result = await client.bff.execute({
  scriptName: 'getUserDashboard',
  params: { userId: '123' }
});

2. MCP SQL Creation Workflow​

Master the 5-step process for creating custom SQL.

Process Steps:

  1. Use MCP to get dataset information
  2. Determine query requirements and fields
  3. Create custom SQL on the platform
  4. Call using SDK executeSql()
  5. Handle results and errors

3. AntD UI Development Standards​

Unified AntD component usage style, avoiding "AI flavor".

Standards Content:

  • Component selection principles
  • Style conventions
  • Table configuration standards
  • Form layout standards

4. API Integration Guide​

Use lovrabet api pull to integrate dataset APIs.

Process Description:

  • Initialize project configuration
  • Pull API configuration
  • Generate API documentation
  • Use in code

5. Menu Management Guide​

Use lovrabet menu sync/update to manage menus.

Process Description:

  • Develop new pages
  • Sync menus to platform
  • Update CDN resources

6. Backend Function Script Writing Standards​

Standards for writing backend function scripts.

Standards Content:

  • Permission filtering
  • Data desensitization
  • Business logic encapsulation
  • Error handling

View Installed Skills​

After installation, you can view the skill files:

# View manifest
cat .lovrabet/skill-manifest.json

# View guides directory
ls .lovrabet/skill/.shared/guides/

# Read specific guide
cat .lovrabet/skill/.shared/guides/01-typescript-sdk/guide.md

Update Skills​

Skills are updated periodically. To update to the latest version:

npx method:

# Reinstall to update
npx skills add lovrabet/lovrabet-skill

Enterprise CDN method:

lovrabet skill install --cursor

Using with MCP​

Skills work better when combined with MCP:

# 1. Install Skills
npx skills add lovrabet/lovrabet-skill

# 2. Configure MCP (if using Claude Code)
# Edit ~/.config/claude-code/mcp.json

Combined Effect:

  • MCP enables AI to access dataset information
  • Skills teach AI how to correctly use the SDK
  • Together, AI can generate more accurate code

Troubleshooting​

Problem: Skill Files Not Taking Effect​

Checklist:

  1. Confirm files have been created
  2. Restart IDE
  3. Check if IDE supports this format of rule files

Solution:

# Check if files exist
ls -la .cursorrules
ls -la .lovrabet/skill/.shared/guides/

# Reinstall
npx skills add lovrabet/lovrabet-skill

Problem: IDE Does Not Recognize Rule Files​

Different IDEs have different support for rule files:

  • Cursor: Supports .cursorrules and .cursor/skills/
  • Windsurf: Supports .windsurf/workflows/
  • Claude Code: Supports .claude/skills/ and agents.md

If the IDE does not recognize the files, please check the IDE version and official documentation.

Problem: npx skills Installation Fails​

Possible Causes:

  • Network connection issues
  • npm registry access restricted

Solution:

# Try using the Taobao mirror
npm config set registry https://registry.npmmirror.com

# Reinstall
npx skills add lovrabet/lovrabet-skill