feat: publish multi-marketplace community pack

.claude-plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "name": "terraphim-skills",
+  "description": "Public Community skills from Terraphim AI.",
+  "owner": {
+    "name": "Terraphim AI",
+    "email": "engineering@terraphim.ai"
+  },
+  "plugins": [
+    {
+      "name": "terraphim-skills-intro",
+      "source": "./",
+      "description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
+      "version": "0.2.0",
+      "category": "development",
+      "homepage": "https://terraphim-skills.md/"
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "terraphim-skills-intro",
+  "description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
+  "version": "0.2.0",
+  "author": {
+    "name": "Terraphim AI",
+    "email": "engineering@terraphim.ai"
+  },
+  "homepage": "https://terraphim-skills.md/",
+  "repository": "https://github.com/terraphim/terraphim-cursor-plugin",
+  "license": "Apache-2.0",
+  "keywords": [
+    "terraphim",
+    "code-search",
+    "learning",
+    "memory",
+    "knowledge-graph",
+    "developer-tools"
+  ]
+}

.cursor-plugin/plugin.json

@@ -1,15 +1,14 @@
 {
   "name": "terraphim-skills-intro",
   "description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": {
     "name": "Terraphim AI",
     "email": "engineering@terraphim.ai"
   },
   "homepage": "https://terraphim-skills.md/",
   "repository": "https://github.com/terraphim/terraphim-cursor-plugin",
   "license": "Apache-2.0",
-  "logo": "assets/logo.svg",
   "keywords": [
     "terraphim",
     "code-search",
@@ -18,6 +17,7 @@
     "knowledge-graph",
     "developer-tools"
   ],
+  "logo": "assets/logo.svg",
   "skills": [
     "skills/terraphim-grep",
     "skills/terraphim-agent-learn",

.github/trusted-release-signers

@@ -0,0 +1 @@
+alex@metacortex.engineer namespaces="git" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAICRY4s+NewIgKEE/fgGCtIF0Kd9Q9y6pELMuY+xM2mLC

.github/workflows/release.yml

@@ -0,0 +1,69 @@
+name: Publish marketplace pack
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out tagged source
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.12"
+
+      - name: Validate tagged pack
+        run: |
+          expected_tag="v$(python3 scripts/generate_distribution.py --print-version)"
+          test "$GITHUB_REF_NAME" = "$expected_tag"
+          git config gpg.format ssh
+          git config gpg.ssh.allowedSignersFile \
+            "$GITHUB_WORKSPACE/.github/trusted-release-signers"
+          git verify-tag "$GITHUB_REF_NAME"
+          python3 scripts/generate_distribution.py --check
+          python3 -m unittest discover -s tests -p 'test_*.py'
+
+      - name: Rebuild and compare AutoClaw archives
+        run: |
+          output="$(mktemp -d)"
+          python3 scripts/generate_distribution.py --autoclaw-dist "$output"
+          diff -u dist/autoclaw/SHA256SUMS "$output/SHA256SUMS"
+          for archive in dist/autoclaw/*.zip; do
+            name="$(basename "$archive")"
+            cmp "$archive" "$output/$name"
+          done
+
+  publish:
+    needs: validate
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Check out validated tagged source
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          persist-credentials: false
+
+      - name: Publish immutable release assets
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "$GITHUB_REF_NAME" \
+            dist/autoclaw/*.zip \
+            dist/autoclaw/SHA256SUMS \
+            assets/v-model-overview.svg \
+            assets/v-model-overview.png \
+            --repo "$GITHUB_REPOSITORY" \
+            --title "Terraphim Skills Introduction $GITHUB_REF_NAME" \
+            --generate-notes \
+            --verify-tag

.github/workflows/validate.yml

@@ -0,0 +1,39 @@
+name: Validate public marketplace pack
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.12"
+
+      - name: Check generated manifests
+        run: python3 scripts/generate_distribution.py --check
+
+      - name: Run tests
+        run: python3 -m unittest discover -s tests -p 'test_*.py'
+
+      - name: Verify reproducible AutoClaw archives
+        run: |
+          output="$(mktemp -d)"
+          python3 scripts/generate_distribution.py --autoclaw-dist "$output"
+          diff -u dist/autoclaw/SHA256SUMS "$output/SHA256SUMS"
+
+      - name: Reject whitespace errors
+        run: git diff --check

.zcode-plugin/plugin.json

@@ -0,0 +1,30 @@
+{
+  "name": "terraphim-skills-intro",
+  "description": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
+  "version": "0.2.0",
+  "author": {
+    "name": "Terraphim AI",
+    "email": "engineering@terraphim.ai"
+  },
+  "homepage": "https://terraphim-skills.md/",
+  "repository": "https://github.com/terraphim/terraphim-cursor-plugin",
+  "license": "Apache-2.0",
+  "keywords": [
+    "terraphim",
+    "code-search",
+    "learning",
+    "memory",
+    "knowledge-graph",
+    "developer-tools"
+  ],
+  "displayName": "Terraphim Skills Introduction",
+  "description_i18n": {
+    "en": "Search code, capture learning, and retrieve memory with Terraphim command-line tools.",
+    "zh-CN": "使用 Terraphim 命令行工具搜索代码、记录经验并检索记忆。"
+  },
+  "skills": [
+    "./skills/terraphim-grep",
+    "./skills/terraphim-agent-learn",
+    "./skills/terraphim-agent-memory"
+  ]
+}

NOTICE

@@ -1,2 +1,5 @@
 Terraphim Skills Introduction for Cursor
 Copyright 2026 Terraphim AI
+
+The V-model overview artwork in assets/ is Copyright 2026 Terraphim AI and is
+distributed under the Apache License 2.0 with the rest of this repository.

README.md

@@ -1,62 +1,100 @@
-# Terraphim Skills Introduction for Cursor
+# Terraphim Skills Introduction
 
-Three small, open-source skills introduce Cursor users to Terraphim's local code search, operational learning, and agentic memory commands.
+Three small, open-source skills bring Terraphim's local code search, operational
+learning, and agent memory workflows to Cursor, Kimi Code, AutoClaw, ZCode,
+Hermes Agent, skills.sh, and Claude Code.
 
 | 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` | Retrieve role-scoped memory, inspect provenance, and govern its lifecycle. |
 
-These are independently written Apache-2.0 command wrappers. They do not contain or redistribute the proprietary Terraphim Skills catalogue.
+These Apache-2.0 command wrappers do not bundle executables, secrets, hooks, or
+proprietary skill content. They remain useful without a marketplace account.
 
-## Prerequisites
+## Install the command dependencies
 
-Install current Terraphim command-line tools using the release instructions at <https://github.com/terraphim/terraphim-ai/releases>, then verify the installed surface:
+On macOS or Linux with Homebrew:
 
 ```bash
+brew tap terraphim/terraphim
+brew install terraphim-grep terraphim-agent
 terraphim-grep --version
 terraphim-agent --version
 terraphim-agent learn --help
 terraphim-agent memory --help
 ```
 
-The wrappers inspect `--help` at runtime so they remain honest about the locally installed version.
+The formulae install the signed, checksummed Terraphim Clients v1.21.14 release.
+See [dependency installation](docs/install-dependencies.md) for updates, removal,
+non-Homebrew installation, signature checks, and PATH troubleshooting. The skills
+never install dependencies automatically.
+
+## Install in your agent
+
+| Host | Installation |
+|---|---|
+| Cursor | Already submitted; install from Cursor Marketplace, or use the local-copy instructions below. |
+| 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. |
+| 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. |
+
+Claude Code commands:
+
+```text
+claude plugin marketplace add terraphim/terraphim-cursor-plugin
+claude plugin install terraphim-skills-intro@terraphim-skills
+```
+
+Availability in a host's curated public marketplace is separate from direct or
+custom installation. See the [distribution guide](docs/distribution.md) for exact
+install, update, discovery, and removal steps and current publication status.
 
 ## Local Cursor installation
 
-For local development, copy this repository into Cursor's local plugin directory:
+For local development, copy this repository into:
 
 ```text
 ~/.cursor/plugins/local/terraphim-skills-intro
 ```
 
 Cursor 3.20 rejects a symlink when its resolved target is outside
-`~/.cursor/plugins/local`, so use a real directory for a reliable test. For example:
+`~/.cursor/plugins/local`, so use a real directory:
 
 ```sh
 cp -R /path/to/terraphim-cursor-plugin \
   ~/.cursor/plugins/local/terraphim-skills-intro
 ```
 
-Reload Cursor, open **Customize**, and confirm that all three skills appear. Invoke them by name or ask Cursor to search code, inspect an earlier command failure, or retrieve project memory.
+Reload Cursor, open **Customize**, and confirm that all three skills appear.
 
 ## Example requests
 
 - “Use Terraphim Grep to find the authorization callback and show two lines of context.”
 - “Search project learnings for an earlier failed deployment command.”
 - “Retrieve role-scoped memory about OAuth redirect validation and show its provenance.”
 
-The skills default to local, read-only operations. Persistent learning or memory changes remain explicit and scoped.
+The skills default to local, read-only operations. Persistent learning or memory
+changes remain explicit and scoped. Review [permissions and side effects](docs/permissions.md)
+before enabling writes or configured model synthesis.
 
-## Terraphim Skills
+## Continue with Terraphim Skills
 
-Browse the Terraphim catalogue and non-technical guidance at <https://terraphim-skills.md/>. This introductory plugin remains useful on its own and requires no marketplace account.
+Browse the [Community, Core, and Premium catalogue](https://terraphim-skills.md/skills/).
+The public introduction contains no proprietary instructions or entitlement token.
+Following a related-skill link never creates a checkout or transaction. Access and
+purchase decisions remain on Terraphim's authenticated site and MCP services.
 
 ## Development
 
 ```bash
+python3 scripts/generate_distribution.py --check
 python3 -m unittest discover -s tests -p 'test_*.py'
+python3 scripts/generate_distribution.py --autoclaw-dist dist/autoclaw
 ```
 
 ## Licence

README_CN.md

@@ -0,0 +1,55 @@
+# Terraphim Skills Introduction
+
+本插件提供三个开源技能，让 Kimi Code、ZCode 及其他智能体能够使用
+Terraphim 的本地代码搜索、经验学习和智能体记忆工作流。
+
+## 技能
+
+- `terraphim-grep`：在本地代码和文档中进行有界搜索，默认离线。
+- `terraphim-agent-learn`：检查失败并记录经过验证的操作修正。
+- `terraphim-agent-memory`：检索角色范围内的记忆并检查来源。
+
+这些技能采用 Apache-2.0 许可证，不包含可执行文件、密钥、后台任务或
+Terraphim 专有技能内容。
+
+## 安装依赖
+
+在 macOS 或安装了 Homebrew 的 Linux 上运行：
+
+```bash
+brew tap terraphim/terraphim
+brew install terraphim-grep terraphim-agent
+terraphim-grep --version
+terraphim-agent --version
+terraphim-agent learn --help
+terraphim-agent memory --help
+```
+
+技能不会自动安装软件。没有 Homebrew 时，请从
+[Terraphim Clients v1.21.14](https://github.com/terraphim/terraphim-clients/releases/tag/v1.21.14)
+下载适合平台的文件，并用 `SHA256SUMS` 验证。
+
+## 安装与使用
+
+在 ZCode 的“发现”页面把仓库内的 `marketplaces/zcode.json` 添加为个人市场，
+然后安装 `terraphim-skills-intro`。进入官方精选市场仍需由维护者审核并合并
+单独的 Pull Request。各平台的安装、更新和卸载步骤见
+[分发指南](docs/distribution.md)。
+
+示例请求：
+
+- “使用 Terraphim Grep 查找授权回调并显示两行上下文。”
+- “搜索项目经验，找出之前失败的部署命令。”
+- “检索有关 OAuth 重定向验证的角色记忆，并显示其来源。”
+
+默认操作是本地且只读的。写入学习或记忆必须获得明确授权；启用模型综合
+前必须确认数据边界和可能的费用。
+
+浏览 [Community、Core 和 Premium 技能目录](https://terraphim-skills.md/skills/)。
+此链接只提供信息，不会自动创建结账、付款或交易。
+
+隐私政策：<https://terraphim-skills.md/legal/privacy/>
+
+服务条款：<https://terraphim-skills.md/legal/terms/>
+
+许可证：Apache-2.0