Home / gnosil / semantix · agent-skill/SKILL.md · GitHub

semantix skillA

semantix is agent-read markdown (skill) from gnosil/semantix: Install and use the semantix memory kernel as a middleware in your agent: extract user preferences / workflows / experience from past sessions, retrieve and inject them on demand. One binary + your agent's own tools..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Semantix — 记忆中间件 Skill

> 给你的智能体装上**用户级记忆**:记住用户偏好、业务流程、总结办案/工作经验,
> 跨会话自动复用。你的 agent 不需要改造内核——装一个二进制 + 两个工具即可。

## 执行模式(agent 自助接入,逐条执行)

> 本 skill 设计为**由客户的 agent 直接执行**完成接入。按顺序执行以下步骤;
> 每步有通过标准;失败进入「故障处理」。全部通过 = 接入完成。

### STEP 0 — 环境检查

```bash
uname -s && uname -m            # 通过标准:darwin 或 linux;amd64 或 arm64
command -v curl || echo "need curl"
```

### STEP 1 — 安装

```bash
bash <(curl -sL https://raw.githubusercontent.com/Gnosil/semantix/main/agent-skill/scripts/install.sh)
```
通过标准:输出 `== installed:` 且无报错。
(离线/内网客户:手动下载 release 包,跳过下载步骤后继续。)

### STEP 2 — 配置

```bash
semantix lookup --help >/dev/null && echo ok   # 通过标准:输出 ok
mkdir -p ~/.semantix/sessions
```
默认零配置可用;按需复制 `agent-skill/config/semantix.example.toml` 调整。

### STEP 3 — 选择集成方式(决策树)

| 你的 agent 底座 | 走哪条路径 |
|---|---|
| **semantix-agent**(本仓 harness/,随发布包分发) | 内置集成已就绪:`semantix-agent.toml` 中 `[semantix] enabled=true` + semantix_lookup 工具(零步骤) |
| **LangChain** | `docs/reports/langchain-middleware.md` 双挂点示例(消息改写 + 会话提取) |
| **Claude Code / 工具注册类** | 本 skill `tools/semantix-lookup.md` 的 schema 注册 `semantix_lookup`(+可选 `semantix_inject`) |
| **任意自定义 agent** | 会话旁路三方式(`hooks/session-bypass.md`):导出 / 事件旁路 / 直接调用 |
…

Read the whole file at its exact version.

How to install

Latest version
mdr add gnosil/semantix/semantix@git:20260822.25c3da1
Exact content
mdr add gnosil/semantix/semantix@sha256:ca97cc193118779e

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_bk5fwliq7qanjjsv.svg)](https://markdownregistry.com/a/art_bk5fwliq7qanjjsv)

0 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260822.25c3da1 latest2026-08-22 25c3da1 8,040 BA view · diff
git:20260821.2e010b82026-08-21 2e010b8 7,059 BA view · diff
git:20260821.1f555752026-08-21 1f55575 8,001 BA view · diff
git:20260811.03e261b2026-08-11 03e261b 7,020 BA view · diff
git:20260811.01fcf942026-08-11 01fcf94 7,001 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8040 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

gnosil/semantix · 719 stars · license MIT · pushed 2026-09-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bk5fwliq7qanjjsv
GET https://markdownregistry.com/api/v1/resolve?ref=gnosil/semantix/semantix
GET https://markdownregistry.com/api/v1/blob/ca97cc193118779e109df3e46b636ac0e48330e97cd0ba2cbe9f63c225553bc7

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from gnosil/semantix

CLAUDE.md claude
gnosil/semantix · CLAUDE.md
git:20260902.4b315ac · audit A · 719 stars
semantix-guide skill
gnosil/semantix · harness/skill/builtincontent/semantix-guide/SKILL.md · Troubleshoot and configure Semantix capabilities: Skills (project/custom/global/builtin priority, discovery dirs)…
git:20260821.2e010b8 · audit A · 719 stars
AGENTS.md@site agents
gnosil/semantix · site/AGENTS.md
git:20260810.9fa0560 · audit A · 719 stars
CLAUDE.md@site claude
gnosil/semantix · site/CLAUDE.md
git:20260810.9fa0560 · audit B · 719 stars
llms-full.txt@site/public llmstxt
gnosil/semantix · site/public/llms-full.txt
git:20260907.7b873db · audit B · 719 stars
llms.txt@site/public llmstxt
gnosil/semantix · site/public/llms.txt
git:20260907.7b873db · audit A · 719 stars

Every file in gnosil/semantix

Browse by kind, by grade A, or by owner.