Skills and Tools

Skills Loading Model

Skills are loaded from two sources with precedence:

Managed skills: ~/.super-multica/skills/
Profile skills: ~/.super-multica/agent-profiles/<profile-id>/skills/

Profile skills override managed skills when IDs conflict.

Skill File Contract

A valid skill directory must include:

SKILL.md

Optional runtime files:

.env
helper scripts/assets

Current Repo Note

This repository intentionally keeps docs and bundled skill metadata minimal. If a directory under skills/ does not contain SKILL.md, it will not be loaded as a skill.

Skills CLI

multica skills list
multica skills status [id]
multica skills install <id>
multica skills add <owner/repo[/skill]>
multica skills remove <name>

Tool System

@multica/core composes:

base coding tools (read/write/edit/...)
extended tools (exec, process, glob, web_fetch, web_search, data, cron, delegate)
conditional tools (memory_search, send_file)

Tool errors are wrapped into structured tool results instead of crashing runs.

Tool Groups

Supported group aliases:

group:fs -> read, write, edit, glob
group:runtime -> exec, process
group:web -> web_search, web_fetch
group:memory -> memory_search
group:subagent -> delegate
group:cron -> cron
group:data -> data
group:core -> core local/web/data set

Tool Policy Example

{
  tools: {
    allow: ["group:fs", "web_search", "web_fetch"],
    deny: ["exec"],
    byProvider: {
      "openai": {
        deny: ["data"],
      },
    },
  },
}

deny always has priority over allow.

Inspect Effective Tools

multica tools list
multica tools list --allow group:fs,web_fetch
multica tools list --deny exec
multica tools groups

1.8 KiB Raw Blame History