softaworks/agent-toolkit / skills/plugin-forge
plugin-forge
UnverifiedCreate and manage Claude Code plugins with proper structure, manifests, and marketplace integration. Use when creating plugins for a marketplace, adding plugin components (commands, agents, hooks), bumping plugin versions, or working with plugin.json/marketplace.json manifests.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 8.6 KB |
| SKILL.md | skill md | 5.1 KB |
| references/marketplace-schema.md | markdown | 2.4 KB |
| references/plugin-structure.md | markdown | 2.7 KB |
| references/workflows.md | markdown | 3.8 KB |
| scripts/bump_version.pyexecutable | script | 3.3 KB |
| scripts/create_plugin.pyexecutable | script | 4.5 KB |
scripts/bump_version.py
View on GitHub#!/usr/bin/env python3
"""
Bump plugin version in both plugin.json and marketplace.json.
"""
import argparse
import json
import sys
from pathlib import Path
from typing import Literal
VersionPart = Literal["major", "minor", "patch"]
def parse_version(version: str) -> tuple[int, int, int]:
"""Parse semantic version string into tuple."""
try:
parts = version.split(".")
return int(parts[0]), int(parts[1]), int(parts[2])
except (ValueError, IndexError):
print(f"❌ Invalid version format: {version}")
sys.exit(1)
def bump_version(version: str, part: VersionPart) -> str:
"""Bump semantic version."""
major, minor, patch = parse_version(version)
if part == "major":
return f"{major + 1}.0.0"
elif part == "minor":
return f"{major}.{minor + 1}.0"
elif part == "patch":
return f"{major}.{minor}.{patch + 1}"
else:
print(f"❌ Invalid version part: {part}")
sys.exit(1)
def update_plugin_version(plugin_name: str, marketplace_root: Path, part: VersionPart) -> None:
"""Update version in both plugin.json and marketplace.json."""
# Update plugin.json
plugin_json_path = marketplace_root / "plugins" / plugin_name / ".claude-plugin" / "plugin.json"
if not plugin_json_path.exists():
print(f"❌ Plugin manifest not found: {plugin_json_path}")
sys.exit(1)
with open(plugin_json_path, "r") as f:
plugin_data = json.load(f)
old_version = plugin_data.get("version", "0.0.0")
new_version = bump_version(old_version, part)
plugin_data["version"] = new_version
with open(plugin_json_path, "w") as f:
json.dump(plugin_data, f, indent=2)
print(f"✅ Updated plugin.json: {old_version} → {new_version}")
# Update marketplace.json
marketplace_json_path = marketplace_root / ".claude-plugin" / "marketplace.json"
if not marketplace_json_path.exists():
print(f"❌ Marketplace manifest not found: {marketplace_json_path}")
sys.exit(1)
with open(marketplace_json_path, "r") as f:
marketplace_data = json.load(f)
plugin_found = False
for plugin in marketplace_data.get("plugins", []):
if plugin.get("name") == plugin_name:
plugin["version"] = new_version
plugin_found = True
break
if not plugin_found:
print(f"❌ Plugin '{plugin_name}' not found in marketplace manifest")
sys.exit(1)
with open(marketplace_json_path, "w") as f:
json.dump(marketplace_data, f, indent=2)
print(f"✅ Updated marketplace.json: {old_version} → {new_version}")
print(f"\n🎉 Version bumped successfully: {old_version} → {new_version}")
def main():
parser = argparse.ArgumentParser(description="Bump plugin version")
parser.add_argument("plugin_name", help="Plugin name")
parser.add_argument("part", choices=["major", "minor", "patch"], help="Version part to bump")
parser.add_argument("--marketplace-root", default=".", help="Path to marketplace root directory")
args = parser.parse_args()
marketplace_root = Path(args.marketplace_root).resolve()
update_plugin_version(
plugin_name=args.plugin_name,
marketplace_root=marketplace_root,
part=args.part
)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |