Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@
{
"name": "terraphim-skills-intro",
"source": "./",
"description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
"version": "0.2.4",
"description": "Create editor alternatives, search a shared synonym graph, capture learning, and retrieve memory with Terraphim.",
"version": "0.2.5",
"category": "development",
"homepage": "https://terraphim-skills.md/"
}
Expand Down
4 changes: 2 additions & 2 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "terraphim-skills-intro",
"description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
"version": "0.2.4",
"description": "Create editor alternatives, search a shared synonym graph, capture learning, and retrieve memory with Terraphim.",
"version": "0.2.5",
"author": {
"name": "Terraphim AI",
"email": "engineering@terraphim.ai"
Expand Down
7 changes: 4 additions & 3 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "terraphim-skills-intro",
"description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
"version": "0.2.4",
"description": "Create editor alternatives, search a shared synonym graph, capture learning, and retrieve memory with Terraphim.",
"version": "0.2.5",
"author": {
"name": "Terraphim AI",
"email": "engineering@terraphim.ai"
Expand All @@ -21,6 +21,7 @@
"skills": [
"skills/terraphim-grep",
"skills/terraphim-agent-learn",
"skills/terraphim-agent-memory"
"skills/terraphim-agent-memory",
"skills/terraphim-editor"
]
}
20 changes: 20 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,27 @@ jobs:
with:
python-version: "3.12"

- name: Install pinned official signature verifier
run: |
verifier_dir="$RUNNER_TEMP/terraphim-tsm-verifier"
mkdir -p "$verifier_dir"
curl --fail --location --silent --show-error --retry 2 \
https://downloads.terraphim-skills.md/tsm/v0.1.16/tsm-0.1.16-x86_64-unknown-linux-gnu.tar.gz \
--output "$verifier_dir/tsm.tar.gz"
printf '%s %s\n' \
0a785a17e70bf724ff3a387dfa5d011d2e23e09913e4a774553cfad64a8c1765 \
"$verifier_dir/tsm.tar.gz" | sha256sum --check --strict
tar -xzf "$verifier_dir/tsm.tar.gz" -C "$verifier_dir" tsm

- name: Verify every original signed skill
run: |
python3 scripts/verify_kilo_distribution.py \
--inputs integrations/kilo/release-inputs.json \
--source-root skills --tsm "$RUNNER_TEMP/terraphim-tsm-verifier/tsm"

- name: Validate tagged pack
env:
TERRAPHIM_TSM_VERIFIER: ${{ runner.temp }}/terraphim-tsm-verifier/tsm
run: |
expected_tag="v$(python3 scripts/generate_distribution.py --print-version)"
test "$GITHUB_REF_NAME" = "$expected_tag"
Expand Down
20 changes: 20 additions & 0 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,30 @@ jobs:
with:
python-version: "3.12"

- name: Install pinned official signature verifier
run: |
verifier_dir="$RUNNER_TEMP/terraphim-tsm-verifier"
mkdir -p "$verifier_dir"
curl --fail --location --silent --show-error --retry 2 \
https://downloads.terraphim-skills.md/tsm/v0.1.16/tsm-0.1.16-x86_64-unknown-linux-gnu.tar.gz \
--output "$verifier_dir/tsm.tar.gz"
printf '%s %s\n' \
0a785a17e70bf724ff3a387dfa5d011d2e23e09913e4a774553cfad64a8c1765 \
"$verifier_dir/tsm.tar.gz" | sha256sum --check --strict
tar -xzf "$verifier_dir/tsm.tar.gz" -C "$verifier_dir" tsm

- name: Verify every original signed skill
run: |
python3 scripts/verify_kilo_distribution.py \
--inputs integrations/kilo/release-inputs.json \
--source-root skills --tsm "$RUNNER_TEMP/terraphim-tsm-verifier/tsm"

- name: Check generated manifests
run: python3 scripts/generate_distribution.py --check

- name: Run tests
env:
TERRAPHIM_TSM_VERIFIER: ${{ runner.temp }}/terraphim-tsm-verifier/tsm
run: python3 -m unittest discover -s tests -p 'test_*.py'

- name: Verify reproducible AutoClaw archives
Expand Down
11 changes: 6 additions & 5 deletions .zcode-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "terraphim-skills-intro",
"description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
"version": "0.2.4",
"description": "Create editor alternatives, search a shared synonym graph, capture learning, and retrieve memory with Terraphim.",
"version": "0.2.5",
"author": {
"name": "Terraphim AI",
"email": "engineering@terraphim.ai"
Expand All @@ -19,12 +19,13 @@
],
"displayName": "Terraphim Skills Introduction",
"description_i18n": {
"en": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
"zh-CN": "使用 Terraphim 命令行工具搜索代码、记录经验并检索记忆。"
"en": "Create editor alternatives, search a shared synonym graph, capture learning, and retrieve memory with Terraphim.",
"zh-CN": "在编辑器中创建备选措辞、搜索共享同义词图、记录经验并检索记忆。"
},
"skills": [
"./skills/terraphim-grep",
"./skills/terraphim-agent-learn",
"./skills/terraphim-agent-memory"
"./skills/terraphim-agent-memory",
"./skills/terraphim-editor"
]
}
12 changes: 7 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,17 @@
# Terraphim Skills Introduction

Three small, open-source skills bring Terraphim's local code search, operational
learning, and agent memory workflows to Cursor, Kimi Code, AutoClaw, ZCode,
Four small, open-source skills connect Terraphim's editor alternatives, local
search, operational learning, and agent memory workflows to Cursor, Kimi Code, AutoClaw, ZCode,
Hermes Agent, skills.sh, Claude Code, and Grok Build.

| Skill | Command family | Purpose |
|---|---|---|
| `terraphim-grep` | `terraphim-grep` | Search bounded local code and documentation, offline by default. |
| `terraphim-agent-learn` | `terraphim-agent learn` | Inspect failures and capture verified operational corrections. |
| `terraphim-agent-memory` | `terraphim-agent memory` | Save authored lessons, inspect saved content and source tags, and retrieve memory. |
| `terraphim-editor` | Editor UI → `terraphim-grep` | Create and swap alternatives, export synonyms and search related decisions. |

These Apache-2.0 command wrappers do not bundle executables, secrets, hooks, or
These Apache-2.0 instruction skills do not bundle executables, secrets, hooks, or
proprietary skill content. They remain useful without a marketplace account.

## Install the command dependencies
Expand Down Expand Up @@ -43,9 +44,10 @@ troubleshooting. The skills never install dependencies automatically.
| Kimi Code | Install this repository or add `marketplaces/kimi.json` as a custom marketplace. |
| AutoClaw | Import one checksummed ZIP per skill with **Skills & Connectors → Skills → Create → Add skill file**. |
| ZCode | Add `marketplaces/zcode.json` as a personal marketplace and install `terraphim-skills-intro`; curated listing is a separate maintainer-reviewed PR. |
| Hermes Agent | Add `terraphim/terraphim-cursor-plugin` as a tap, then inspect and install the three skills. |
| Hermes Agent | Add `terraphim/terraphim-cursor-plugin` as a tap, then inspect and install the four skills. |
| skills.sh | Run `npx skills add terraphim/terraphim-cursor-plugin`; use `DISABLE_TELEMETRY=1` to opt out of anonymous telemetry. |
| Claude Code | Add the repository as a marketplace, then install the plugin as shown below. |
| Kilo | Integration is being prepared; catalog admission and actual Kilo installation remain unqualified. |
| Grok Build | The marketplace submission pins the signed public release and is awaiting maintainer review; see the [distribution guide](docs/distribution.md) for status. |

Claude Code commands:
Expand Down Expand Up @@ -75,7 +77,7 @@ cp -R /path/to/terraphim-cursor-plugin \
~/.cursor/plugins/local/terraphim-skills-intro
```

Reload Cursor, open **Customize**, and confirm that all three skills appear.
Reload Cursor, open **Customize**, and confirm that all four skills appear.

## Use both command-line tools

Expand Down
5 changes: 3 additions & 2 deletions README_CN.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,14 @@
# Terraphim Skills Introduction

本插件提供三个开源技能,让 Kimi Code、ZCode 及其他智能体能够使用
Terraphim 的本地代码搜索、经验学习和智能体记忆工作流。
本插件提供四个开源技能,让 Kimi Code、ZCode 及其他智能体能够使用
Terraphim 的编辑器备选措辞、本地代码搜索、经验学习和智能体记忆工作流。

## 技能

- `terraphim-grep`:在本地代码和文档中进行有界搜索,默认离线。
- `terraphim-agent-learn`:检查失败并记录经过验证的操作修正。
- `terraphim-agent-memory`:保存明确提供的经验,按实际 ID 读取内容和来源标签。
- `terraphim-editor`:创建和切换备选措辞,导出同义词图并搜索相关决策。

这些技能采用 Apache-2.0 许可证,不包含可执行文件、密钥、后台任务或
Terraphim 专有技能内容。
Expand Down
7 changes: 4 additions & 3 deletions dist/autoclaw/SHA256SUMS
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
218e953aa259b7bffd866e95ccfebe7ebe2d0a9bcdd8c8d7fe7d23689037517c terraphim-grep-0.2.4.zip
72133ba7d0e87158d1fef420ee4a194f6a32113ded1ad9c077e01a7ef1bc36d2 terraphim-agent-learn-0.2.4.zip
bd9c8eee9f3b2d177424dd70cebef891d6e65f2946f6766daaea728c236ee796 terraphim-agent-memory-0.2.4.zip
218e953aa259b7bffd866e95ccfebe7ebe2d0a9bcdd8c8d7fe7d23689037517c terraphim-grep-0.2.5.zip
72133ba7d0e87158d1fef420ee4a194f6a32113ded1ad9c077e01a7ef1bc36d2 terraphim-agent-learn-0.2.5.zip
bd9c8eee9f3b2d177424dd70cebef891d6e65f2946f6766daaea728c236ee796 terraphim-agent-memory-0.2.5.zip
fa15eff9b196591c99b1cd5cd6493162a6658dc8d1a44a7f014177c546c7075c terraphim-editor-0.2.5.zip
Binary file added dist/autoclaw/terraphim-editor-0.2.5.zip
Binary file not shown.
12 changes: 9 additions & 3 deletions distribution/metadata.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
"plugin": {
"name": "terraphim-skills-intro",
"display_name": "Terraphim Skills Introduction",
"version": "0.2.4",
"description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
"description_zh_cn": "使用 Terraphim 命令行工具搜索代码、记录经验并检索记忆。",
"version": "0.2.5",
"description": "Create editor alternatives, search a shared synonym graph, capture learning, and retrieve memory with Terraphim.",
"description_zh_cn": "在编辑器中创建备选措辞、搜索共享同义词图、记录经验并检索记忆。",
"author_name": "Terraphim AI",
"author_email": "engineering@terraphim.ai",
"homepage": "https://terraphim-skills.md/",
Expand Down Expand Up @@ -54,6 +54,12 @@
"path": "skills/terraphim-agent-memory",
"command": "terraphim-agent memory",
"mode": "explicit-writes"
},
{
"name": "terraphim-editor",
"path": "skills/terraphim-editor",
"command": "terraphim-grep",
"mode": "explicit-writes"
}
]
}
20 changes: 19 additions & 1 deletion docs/distribution.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
# Multi-marketplace distribution

This repository is the canonical source for all hosts. Release `v0.2.4` contains
exactly three skills and deterministic AutoClaw archives.
exactly three skills and deterministic AutoClaw archives. The current source
prepares pack `0.2.5` with a fourth, editor-to-search companion; it is not yet a
published release. The version-pinned installation examples below remain on
`0.2.4` until the new release passes its gates.

## CLI workflows to include in every listing

Expand Down Expand Up @@ -126,3 +129,18 @@ Each host links to <https://terraphim-skills.md/skills/>. Community skills are
freely obtainable; Core and Premium content follows the catalogue's entitlement
rules. Public packages never embed proprietary bodies, tokens, checkout URLs, or
automatic transactions.

## Kilo integration in preparation

The source prepares four instruction skills: editor, grep, authored memory and
explicit command learning. The editor companion uses the existing online/editor
extension and hands its exported synonym JSON to the separately installed
`terraphim-grep`. A separate example uses `terraphim-agent` to save/read authored
memory. No Kilo plugin binary or new server is introduced.

Kilo imports will use the official importer, a full source commit and copied
Apache licence, with verified source signatures kept separate from transformed
Kilo archive provenance. The existing remote Skills service, released Continue
grep transport and Rust KG MCP are distinct optional integrations. Actual Kilo
installation, OAuth/provider methods and catalog admission remain unqualified
until their individual output checks pass. No current Kilo listing is claimed.
6 changes: 4 additions & 2 deletions docs/install-dependencies.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
# Install Terraphim command dependencies

The three skills are workflow instructions. They call two local binaries and never
install software automatically.
Released pack 0.2.4 contains three CLI instruction skills. Candidate pack 0.2.5
adds an editor companion; it uses the existing online/editor extension and the
same two separately installed CLIs. No skill installs software automatically.
The editor and Kilo catalog routes require their own installation checks.

## Homebrew installation

Expand Down
17 changes: 11 additions & 6 deletions docs/marketplace-submission-pack.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,9 @@
This document is the reusable, public submission collateral for the Terraphim
introductory skills plugin. Platform-specific manifests are generated from
`distribution/metadata.json`; this copy should remain consistent with that
canonical source.
canonical source. This source prepares four-skill pack **0.2.5**; the current
released pack **0.2.4** still has three skills. Do not use candidate copy as proof
of a new release or Kilo catalog admission.

## Listing identity

Expand All @@ -21,25 +23,27 @@ canonical source.

### Tagline

Search code, capture learning, and retrieve memory with Terraphim command-line
tools.
Create wording alternatives, search a shared synonym graph, capture learning,
and retrieve memory with Terraphim.

### Short description

Three Community skills introduce local code search, structured learning
capture, and reusable memory. The skills run Terraphim's local command-line
Four Community skills connect editor alternatives, local search, structured
learning capture, and reusable memory. The skills run Terraphim's local command-line
tools and explain every write before it happens.

### Long description

Terraphim Skills Introduction gives coding agents three focused, open-source
Terraphim Skills Introduction gives coding agents four focused, open-source
workflows:

1. `terraphim-grep` searches local code and documentation with context.
2. `terraphim-agent-learn` turns an explicit lesson into a reusable local
knowledge entry.
3. `terraphim-agent-memory` works with the current user's OS-local memory
store; the checked example captures authored text and reads it back by ID.
4. `terraphim-editor` guides the existing editor: create and swap alternatives,
save/reopen, export synonym JSON and search related decisions.

The plugin contains instructions, not bundled executables. Users install the
signed Terraphim binaries through Homebrew or the checksummed release archives
Expand Down Expand Up @@ -119,6 +123,7 @@ The repository includes Terraphim-owned V-model artwork in both formats:
| Hermes Agent | `skills/*/SKILL.md` | Repository/local skills directory |
| skills.sh | `skills/*/SKILL.md` | Repository URL discovery/install |
| Claude Code | `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json` | Direct install and publisher-owned marketplace |
| Kilo | Four imported skills and three optional existing MCP integrations | In preparation; separate upstream admission and actual host checks required |
| Grok Build (xAI) | `.grok-plugin/marketplace.json` entry in xAI's catalogue | Submission pending maintainer review; see [distribution status](distribution.md) |

An artefact being present does not imply that a third-party catalogue has
Expand Down
Loading
Loading