skillm

Uniwersalna warstwa skill dla AI przez protokół MCP — reużycie gotowych paczek Python, usług Docker, dowolnego CLI, API REST bez ręcznej integracji każdego narzędzia.

Schemat zgodny z CONTROL_LAYER: cienkie adaptery (mcp2*, rest2*, cli2*) delegują do dsl2skillm.dispatch().

Szybki start

cd /home/tom/github/semcod/skillm
bash install-dev.sh

# CLI
cli2skillm exec 'LIST FILE app.skillm.yaml'
cli2skillm exec 'INVOKE skillm://skill/echo-python FILE app.skillm.yaml'

# MCP (stdio — dla Cursor, Open WebUI, Claude Desktop)
mcp2skillm serve

# REST
rest2skillm serve --port 8216
curl -s http://127.0.0.1:8216/health

Architektura

flowchart LR
  OW[Open WebUI / Cursor]
  MCP[mcp2skillm]
  DSL[dsl2skillm]
  CORE[skillm core]
  PY[Python package]
  CLI[Shell CLI]
  DK[Docker]
  API[REST service]

  OW --> MCP --> DSL --> CORE
  CORE --> PY
  CORE --> CLI
  CORE --> DK
  CORE --> API

Loading

Manifest skilli (app.skillm.yaml)

version: "1"
skills:
  echo-python:
    type: python
    entry: skillm.examples.echo:run
    args: ["hello"]

  my-cli:
    type: cli
    command: curl
    args: ["-s", "https://httpbin.org/get"]

  my-docker:
    type: docker
    image: hello-world:latest

  my-api:
    type: rest
    url: http://127.0.0.1:8210/health
    method: GET

  other-mcp:
    type: mcp
    command: mcp2doql
    args: ["serve"]

DSL (przykłady)

LIST FILE app.skillm.yaml
QUERY skillm://skill/echo-python FILE app.skillm.yaml
VALIDATE app.skillm.yaml
HEALTH skillm://skill/echo-python FILE app.skillm.yaml
INVOKE skillm://skill/echo-python FILE app.skillm.yaml ARGS '["world"]'
REGISTER my-tool TYPE cli WITH {"command":"date","args":["-u"]}
PATCH skillm://skill/my-tool WITH {"description":"updated"}
UNREGISTER my-tool
RESOLVE "python echo skill"

Paczki

Paczka	Port / transport	Opis
skillm	—	Registry, invoke, validate
dsl2skillm	—	Bus CQRS + Schema + Protobuf
uri2skillm	—	skillm://cmd/... → DSL
nlp2skillm	—	NL → DSL
cli2skillm	stdio REPL	shell, exec, run
mcp2skillm	MCP stdio	Narzędzia skillm_*
rest2skillm	8216	POST /v1/dsl

Szczegóły: packages/README.md.

Open WebUI

Instrukcja integracji MCP: examples/open-webui/README.md.

Testy

pytest packages/ -q

Licencja

Apache-2.0 — see LICENSE.