From 9b51cc9d3e5bdd7926a32b05473dd19b84d9d6e9 Mon Sep 17 00:00:00 2001 From: zero Date: Wed, 8 Apr 2026 02:33:45 +0200 Subject: [PATCH] Restructure into proper Claude Code plugin format MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Move tea/ → skills/tea/ so the plugin loader can find the skill - Add .claude-plugin/plugin.json with name, version, description, author, keywords - Add MIT LICENSE file - Update README with marketplace install command and corrected manual install paths Co-Authored-By: Claude Sonnet 4.6 --- .claude-plugin/plugin.json | 11 +++++ LICENSE | 21 ++++++++++ README.md | 49 +++++++++++++--------- {tea => skills/tea}/SKILL.md | 0 {tea => skills/tea}/references/commands.md | 0 5 files changed, 61 insertions(+), 20 deletions(-) create mode 100644 .claude-plugin/plugin.json create mode 100644 LICENSE rename {tea => skills/tea}/SKILL.md (100%) rename {tea => skills/tea}/references/commands.md (100%) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..08ed16c --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,11 @@ +{ + "name": "tea", + "version": "1.0.0", + "description": "Full operability with the tea CLI for Gitea — manage issues, PRs, releases, branches, notifications, and more from the command line.", + "author": { + "name": "zero" + }, + "homepage": "https://gittea.kammenstraatha.duckdns.org/admin/tea-skill", + "license": "MIT", + "keywords": ["gitea", "tea", "git", "issues", "pull-requests", "cli"] +} diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..e1d0747 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 zero + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md index a3d7d2c..8e14010 100644 --- a/README.md +++ b/README.md @@ -24,48 +24,57 @@ When installed, Claude will know how to use `tea` to: ## Installation -Skills in Claude Code live inside plugin packages under `~/.claude/plugins/`. To install this skill, copy the `tea/` folder into a plugin's `skills/` directory. - -### Option A — standalone plugin (recommended) - -Create a minimal plugin structure and drop the skill in: +### From the Claude Code marketplace (once listed) ```bash -PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea-skill/1.0.0 -mkdir -p "$PLUGIN_DIR/skills" -cp -r tea "$PLUGIN_DIR/skills/" +/plugin install tea@claude-plugins-official +``` + +### Manual install + +Clone and register as a local plugin: + +```bash +git clone https://gittea.kammenstraatha.duckdns.org/admin/tea-skill +PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea/1.0.0 +mkdir -p "$PLUGIN_DIR" +cp -r tea-skill/* "$PLUGIN_DIR/" ``` Then register it in `~/.claude/plugins/installed_plugins.json` under the `"plugins"` key: ```json -"tea-skill@local-plugins": [{ +"tea@local-plugins": [{ "scope": "user", - "installPath": "/home/YOUR_USER/.claude/plugins/cache/local-plugins/tea-skill/1.0.0", + "installPath": "/home/YOUR_USER/.claude/plugins/cache/local-plugins/tea/1.0.0", "version": "1.0.0", "installedAt": "2025-01-01T00:00:00.000Z", "lastUpdated": "2025-01-01T00:00:00.000Z" }] ``` -### Option B — clone and symlink +### Clone and symlink (for development) ```bash -git clone https://github.com/yourname/tea-skill -PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea-skill/1.0.0 -mkdir -p "$PLUGIN_DIR/skills" -ln -s "$(pwd)/tea-skill/tea" "$PLUGIN_DIR/skills/tea" +git clone https://gittea.kammenstraatha.duckdns.org/admin/tea-skill +PLUGIN_DIR=~/.claude/plugins/cache/local-plugins/tea/1.0.0 +mkdir -p "$PLUGIN_DIR" +ln -s "$(pwd)/tea-skill/.claude-plugin" "$PLUGIN_DIR/.claude-plugin" +ln -s "$(pwd)/tea-skill/skills" "$PLUGIN_DIR/skills" ``` -Then register as above. With a symlink, pulling the repo updates the skill immediately. +With symlinks, pulling the repo updates the skill immediately. ## Structure ``` -tea/ -├── SKILL.md # Main skill instructions -└── references/ - └── commands.md # Full command & flag reference +.claude-plugin/ +└── plugin.json # Plugin metadata +skills/ +└── tea/ + ├── SKILL.md # Main skill instructions + └── references/ + └── commands.md # Full command & flag reference ``` ## License diff --git a/tea/SKILL.md b/skills/tea/SKILL.md similarity index 100% rename from tea/SKILL.md rename to skills/tea/SKILL.md diff --git a/tea/references/commands.md b/skills/tea/references/commands.md similarity index 100% rename from tea/references/commands.md rename to skills/tea/references/commands.md