trek-plugin-dev

v3.4.0

Build, test, sign, and publish plugins for TREK, the self-hosted travel planner.

CodexClaude Code1 skill

by fbnlrzMIT9updated 3 weeks ago

Source

$ git clone https://github.com/liketrek/Plugin-Skill

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

trek-plugin-dev/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
└── skills/trek-plugin-dev/SKILL.md

Skills1

trek-plugin-devskills/trek-plugin-dev/SKILL.md

Build, test, sign, and publish plugins for TREK, the self-hosted travel planner (github.com/liketrek/TREK). Covers the trek-plugin.json manifest, the definePlugin server API and ctx object, the sandboxed iframe postMessage bridge for widget/page UIs, permissions and egress rules, the enforced `trek` TREK-version range, local development with trek-plugin-sdk (create/dev/status/shot/validate/pack), author signing (keygen/--sign, Ed25519 trust-on-first-use), and publishing to the TREK-Plugins community registry including every CI gate. Use when creating or modifying a TREK plugin, working with trek-plugin-sdk or trek-plugin.json, signing a plugin or handling a signature/key-rotation problem (SIGNATURE_KEY_CHANGED, re-trust, allow-key-change), debugging PERMISSION_DENIED / RESOURCE_FORBIDDEN / TREK_VERSION_INCOMPATIBLE / TREK_VERSION_UNKNOWN or a plugin that will not install or activate on a given TREK version, or preparing a TREK-Plugins registry entry or PR.

Manifests2

.codex-plugin/plugin.json

{
  "name": "trek-plugin-dev",
  "version": "3.4.0",
  "description": "Build, test, sign, and publish plugins for TREK, the self-hosted travel planner.",
  "author": {
    "name": "fbnlrz",
    "url": "https://github.com/fbnlrz"
  },
  "homepage": "https://github.com/liketrek/Plugin-Skill",
  "repository": "https://github.com/liketrek/Plugin-Skill",
  "license": "MIT",
  "keywords": [
    "trek",
    "plugin",
    "skill",
    "trek-plugin-sdk"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "TREK Plugin Dev",
    "shortDescription": "Build, test, and publish TREK plugins",
    "longDescription": "Covers the trek-plugin.json manifest and its permission catalog, the definePlugin server API and ctx object, the sandboxed iframe postMessage bridge, egress rules, the trek-plugin-sdk CLI, Ed25519 author signing, and the TREK-Plugins registry with every CI gate.",
    "developerName": "fbnlrz",
    "category": "Developer Tools",
    "websiteURL": "https://github.com/liketrek/Plugin-Skill",
    "defaultPrompt": [
      "Scaffold a TREK plugin and wire up its manifest permissions"
    ]
  }
}

.claude-plugin/plugin.json

{
  "name": "trek-plugin-dev",
  "description": "Agent skill for building, testing, and publishing TREK plugins (trek-plugin-sdk, trek-plugin.json, sandboxed runtime, TREK-Plugins registry and its CI gates).",
  "author": {
    "name": "fbnlrz"
  },
  "homepage": "https://github.com/liketrek/Plugin-Skill",
  "repository": "https://github.com/liketrek/Plugin-Skill",
  "license": "MIT",
  "keywords": [
    "trek",
    "plugin",
    "skill",
    "trek-plugin-sdk"
  ]
}