Skip to content

Local video editor for coding agents: 42 FFmpeg tools with a machine-readable contract and an MCP server, for Claude Code, Cursor and Codex. Cut, captions, reframe, loudness, platform exports. No cloud, no API keys.

Claude Code plugin: add the marketplace the README's install line needed (#361)

Shogo Kajiyamad728d3f4bd7e
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..cf25bf4
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,15 @@
+{
+ "name": "ffmpeg-skill",
+ "description": "ffmpeg-skill as a Claude Code plugin: local FFmpeg video and audio editing with a machine-readable contract.",
+ "owner": {
+ "name": "kajisho5",
+ "url": "https://github.com/kajisho5"
+ },
+ "plugins": [
+ {
+ "name": "ffmpeg-skill",
+ "source": "./",
+ "description": "Local FFmpeg video/audio editing for coding agents: a machine-readable contract, an MCP server and a probe-first / verify-last workflow."
+ }
+ ]
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5d5a8de..3356ab9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,7 +4,9 @@
## Unreleased
-(nothing yet)
+### Fixed
+
+- **The Claude Code plugin can actually be installed.** The README's `claude plugin install kajisho5/ffmpeg-skill` failed with "not found in any configured marketplace": the repository shipped a plugin manifest but no marketplace. `.claude-plugin/marketplace.json` now lists the plugin from the repository root. The install is `/plugin install ffmpeg-skill --marketplace kajisho5/ffmpeg-skill`, or on older Claude Code `claude plugin marketplace add kajisho5/ffmpeg-skill` followed by `claude plugin install ffmpeg-skill@ffmpeg-skill`.
## 2.17.0
diff --git a/README.md b/README.md
index cae380e..bb4fce4 100644
--- a/README.md
+++ b/README.md
@@ -497,13 +497,15 @@ npx ffmpeg-skill --dir ./my-skills
npx ffmpeg-skill --uninstall # remove from the selected targets (--codex also clears the older ~/.codex/skills location)
```
-As a Claude Code plugin (no Node needed, updates with `claude plugin update`):
+As a Claude Code plugin (no Node needed, updates with `claude plugin update`). This repository is its own plugin marketplace:
```bash
-claude plugin install kajisho5/ffmpeg-skill
+/plugin install ffmpeg-skill --marketplace kajisho5/ffmpeg-skill # in Claude Code 2.1.275 or later
+claude plugin marketplace add kajisho5/ffmpeg-skill # older versions: add the marketplace,
+claude plugin install ffmpeg-skill@ffmpeg-skill # then install from it
```
-The plugin namespaces the skill as `ffmpeg-skill:ffmpeg-skill`; the manifest is [.claude-plugin/plugin.json](.claude-plugin/plugin.json) and its version follows every release automatically.
+The plugin namespaces the skill as `ffmpeg-skill:ffmpeg-skill`. The manifests are [.claude-plugin/plugin.json](.claude-plugin/plugin.json), whose version follows every release automatically, and [.claude-plugin/marketplace.json](.claude-plugin/marketplace.json), which lists the plugin from the repository root. Before 2.17.1 the README's one-line `claude plugin install kajisho5/ffmpeg-skill` could not work, because there was no marketplace file.
Without Node: clone this repository and copy `SKILL.md`, `scripts/`, `references/` and `mcp/` into your agent's skills directory.
diff --git a/tests/test_contract.py b/tests/test_contract.py
index 994615c..ef932ba 100644
--- a/tests/test_contract.py
+++ b/tests/test_contract.py
@@ -218,8 +218,8 @@ class ContractTests(unittest.TestCase):
self.assertEqual(t["version"], pkg["version"])
def test_claude_plugin_manifest_matches_package_and_skill(self):
- """.claude-plugin/plugin.json makes the repo installable with `claude plugin install
- kajisho5/ffmpeg-skill` (#142); a single-skill plugin may keep SKILL.md at its root. Its
+ """.claude-plugin/plugin.json makes the repo installable as a Claude Code plugin (#142,
+ listed by marketplace.json since 2.17.1); a single-skill plugin may keep SKILL.md at its root. Its
version must track package.json (release.yml's auto-bump rewrites both), its name must
equal SKILL.md's frontmatter name (the plugin namespaces the skill as name:name), and it
must be valid JSON with only the documented top-level fields."""
@@ -232,6 +232,22 @@ class ContractTests(unittest.TestCase):
self.assertTrue(set(manifest) <= {"name", "version", "description", "author", "homepage", "repository", "license", "keywords"}, sorted(manifest))
self.assertTrue(re.fullmatch(r"[a-z0-9-]+", manifest["name"]))
+ def test_claude_plugin_marketplace_lists_the_plugin_at_the_repo_root(self):
+ """Without .claude-plugin/marketplace.json, `claude plugin install` and `claude plugin
+ marketplace add kajisho5/ffmpeg-skill` both fail ("not found in any configured
+ marketplace" / "Marketplace file not found"), so the README's plugin install line could
+ never work. The marketplace lists exactly this plugin, by the manifest's name, from the
+ repository root, and the README installs it under that name."""
+ market = json.loads((ROOT / ".claude-plugin" / "marketplace.json").read_text(encoding="utf-8"))
+ manifest = json.loads((ROOT / ".claude-plugin" / "plugin.json").read_text(encoding="utf-8"))
+ self.assertTrue(re.fullmatch(r"[a-z0-9-]+", market["name"]))
+ self.assertTrue(market["owner"]["name"])
+ self.assertEqual([(p["name"], p["source"]) for p in market["plugins"]], [(manifest["name"], "./")])
+ readme = (ROOT / "README.md").read_text(encoding="utf-8")
+ self.assertIn(f"/plugin install {manifest['name']} --marketplace kajisho5/ffmpeg-skill", readme)
+ self.assertIn(f"claude plugin install {manifest['name']}@{market['name']}", readme)
+ self.assertNotIn("claude plugin install kajisho5/ffmpeg-skill\n", readme)
+
def test_docs_contract_example_version_matches_package_json(self):
"""docs/contract.md's illustrative JSON example of the Skill object hand-copies a
skill.version value; it drifted to a stale "0.9.1" while package.json moved on to