86 lines
1.8 KiB
Markdown
86 lines
1.8 KiB
Markdown
# Skills and Tools
|
|
|
|
## Skills Loading Model
|
|
|
|
Skills are loaded from two sources with precedence:
|
|
|
|
1. Managed skills: `~/.super-multica/skills/`
|
|
2. 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```json5
|
|
{
|
|
tools: {
|
|
allow: ["group:fs", "web_search", "web_fetch"],
|
|
deny: ["exec"],
|
|
byProvider: {
|
|
"openai": {
|
|
deny: ["data"],
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
`deny` always has priority over `allow`.
|
|
|
|
## Inspect Effective Tools
|
|
|
|
```bash
|
|
multica tools list
|
|
multica tools list --allow group:fs,web_fetch
|
|
multica tools list --deny exec
|
|
multica tools groups
|
|
```
|