Skip to content

feat(terraphim-skills-intro): add community skills - #13

Open
AlexMikhalev wants to merge 4 commits into
zai-org:mainfrom
AlexMikhalev:codex/add-terraphim-skills-intro
Open

AlexMikhalev wants to merge 4 commits into
zai-org:mainfrom
AlexMikhalev:codex/add-terraphim-skills-intro

Conversation

@AlexMikhalev

@AlexMikhalev AlexMikhalev commented Sep 16, 2026 •

Copy link
Copy Markdown

Plugin type / 插件类型

  • UI Plugin
  • Standard plugin — no MCP Apps interactive page
  • Not applicable

Affected manifest name: terraphim-skills-intro.

What changes

Add Terraphim's three Apache-2.0 Community skills for separately installed terraphim-grep and terraphim-agent. This updates the existing submission to plugin version 0.2.4 and signed skill bodies 1.0.3, copied byte-for-byte from the signed public release at 391c7e4ebc103f1770b9dca589fcce7ccd211d5f.

The pending partner plugin now lives under external_plugins/terraphim-skills-intro, matching the current contribution guide. The bilingual READMEs include both CLI examples: an editor-exported synonym graph retrieves three Risk passages for Concern; explicit memory capture is read back by actual ID/content/source tag. Each signed skill includes the graph and complete copyable workflow. See the editor/search story and memory story.

Validation

  • Unique plugin name, developer-tools category, external ownership path.
  • Standard-plugin classification and affected name declared.
  • Both manifest and marketplace entry use version 0.2.4.
  • Equivalent English/Chinese READMEs and localized descriptions.
  • No secrets, private dependencies or machine-specific paths.
  • Model/network dependencies and writes documented.
  • python3 scripts/validate.py: all 42 plugins pass.
  • The actual scripts/build_dist.py:build_zip implementation builds Terraphim's package twice with identical SHA256 c8e46f888b9f585c135e8e775327ef4841f09ee866b4349e905328151e88b92a. All three skill trees in the ZIP match the signed release; trusted signatures pass.
  • git diff --check passes.
  • Full repository pnpm build and python3 scripts/build_dist.py: blocked locally by unrelated Photocraft's missing Rust 1.95.0 + WASM toolchain; the distributor correctly refuses its incomplete build. No unrelated plugin or build guard was changed.
  • Fresh native ZCode installation/execution of 0.2.4 remains to be verified; CLI/package checks are not a claim of native host acceptance.

Released Clients 1.21.20 binaries and the downloaded signed workflows produced actual zero-to-three search results, same-ID/content/tag memory readback, and a nonempty compiled correction with synonyms:: Markdown export. The source release's 26 tests and CI pass. The public skills catalogue, API downloads and MCP expose all three version 1.0.3 bodies; curated ZCode publication still requires maintainer acceptance.

Permissions, dependencies and licensing

The package contains instructions and Apache-2.0 sample data, with LICENSE and NOTICE. It bundles no executable, hook, MCP server, credential, telemetry or automatic installer. Dependencies are installed separately and version-checked. Search is read-only and synthesis is off by default. Optional synthesis can contact the configured model provider only when explicitly requested.

Authored memory capture writes to the current user's OS-local store, independent of cwd. Learning uses an existing project's .terraphim store or falls back to global storage. Writes require an explicit request; a graph export does not configure or isolate memory. The skills distinguish correction annotations, explicit compiled rewrite rules and hook activation. No proprietary catalogue content or purchase flow is included.

@AlexMikhalev

Copy link
Copy Markdown
Author

Additional real-host validation completed against the public terraphim/terraphim-cursor-plugin v0.2.2 repository using ZCode 0.15.2 in an isolated storage profile:

  • plugins/marketplace/add added the public GitHub repository with no diagnostics.
  • plugins/overview discovered terraphim-skills-intro v0.2.2.
  • plugins/install installed it enabled at user scope with no diagnostics.
  • plugins/validate returned ok: true with no diagnostics.
  • plugins/describe returned exactly the three intended skills: terraphim-grep, terraphim-agent-learn, and terraphim-agent-memory.

This supplements the already-passing repository validator, distribution build, archive-integrity check, and independent structured review. GUI UAT remains explicitly separate from this app-server/CLI proof.

@AlexMikhalev

Copy link
Copy Markdown
Author

Updated the submission to Terraphim Skills Introduction v0.2.3.

The bundled plugin now uses first-party Terraphim links in end-user collateral, includes the re-signed v1.0.2 Community skills, and preserves GitHub only as machine-readable source provenance.

Validation repeated after rebasing onto current upstream main:

  • python3 scripts/validate.py — 22 plugins passed
  • python3 scripts/build_dist.py — built v0.2.3 package, SHA-256 3b249c96a65b…
  • tsm validate — passed for all three signed Community skills
  • git diff --check — passed

@panda920

Copy link
Copy Markdown
Collaborator

✅ Internal validation passed. A ZCode maintainer will review the change next; once merged it is published to the marketplace and this PR is closed automatically.

@AlexMikhalev
AlexMikhalev force-pushed the codex/add-terraphim-skills-intro branch from 90652ab to afb1f16 Compare October 14, 2026 19:29
@panda920

Copy link
Copy Markdown
Collaborator

✅ Internal validation passed. A ZCode maintainer will review the change next; after acceptance, release checks run separately and this PR is closed automatically.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants