Skip to main content

Knowledge Base and Runtime Skills

This page is mainly for Agent maintainers, delivery engineers, and Skill maintainers. Business users usually describe the problem in business language and do not maintain knowledge-base entries or Skills directly.

What These Commands Are For​

Lovrabet Runtime CLI provides two Agent-knowledge related command groups:

  • lovrabet kb ...: manage personal knowledge-base entries for the current app and search visible company plus personal knowledge.
  • lovrabet skill ...: install the official Lovrabet Skill, or sync platform runtime Skills into local Agent skill directories.

Both groups require AccessKey login and a resolved current app. A typical preflight is:

lovrabet auth status
lovrabet app list
lovrabet app use <appName>

You can also pass --app or --appcode on a single command.

Personal Knowledge Base: lovrabet kb​

List and Detail​

lovrabet kb list
lovrabet kb list --verbose
lovrabet kb detail --id <kbId>

list returns summary fields by default: id, title, version, ragStatus, ragErrorMessage, and updateTime. Detail includes content, scope, userId, and timestamps.

Create and Update​

Create and update read content from local UTF-8 text or Markdown files:

lovrabet kb create --title "After-sales Rules" --file ./knowledge/after-sales.md --dry-run
lovrabet kb create --title "After-sales Rules" --file ./knowledge/after-sales.md

lovrabet kb update --id <kbId> --file ./knowledge/after-sales.md --dry-run
lovrabet kb update --id <kbId> --title "After-sales Rules v2" --file ./knowledge/after-sales.md

--file must point to a local regular file. Do not put AccessKeys, Cookies, Authorization headers, customer-private data, or production passwords into knowledge-base content.

Search Visible Knowledge​

lovrabet kb search --query "refund policy"
lovrabet kb search --query "refund policy" --topk 5

Search covers visible company and personal knowledge for the current user. Results include scope, docId, score, weightedScore, content, and metadata.

Official Skill Install: lovrabet skill install​

For first-time Agent setup, use the built-in CLI entry:

lovrabet skill install

Equivalent public install command:

npx skills add lovrabet/lovrabet-cli -g -y

The public Skill tells Agents when to use the runtime CLI, which operations need dry-run first, and which real writes require user confirmation.

Platform Runtime Skill Sync​

Personal and company runtime Skills maintained in the platform can be synced into local Agent skill directories.

Pull Platform Skills​

lovrabet skill pull
lovrabet skill pull --code <skillCode>

skill pull reads both personal and company scopes, materializes local skill directories, and links the effective Skills for the current app.

Push a Local Skill to Personal Scope​

lovrabet skill push --dir ./my-runtime-skill

--dir must point to a local Skill directory containing SKILL.md. The target is the personal runtime Skill scope for the current app. Existing skillCode entries are updated; otherwise a new one is created.

  1. Use kb search to check existing stable knowledge.
  2. Use kb create or kb update when background knowledge is missing.
  3. Turn stable repeatable business workflows into runtime Skills.
  4. Use skill push to upload a personal Skill, validate it, then decide whether it should become a company Skill.
  5. On new machines or Agent environments, run skill install for the public Skill and skill pull for platform runtime Skills.

Summary​

  • kb list/detail/create/update/search manages personal knowledge and visible knowledge search.
  • skill install installs the public Lovrabet Skill.
  • skill pull/push syncs platform runtime Skills for app-specific Agent workflows.
  • Knowledge and Skill content must not contain real credentials, private data, or one-off debug logs.