README
¶
tsuba
Scaffold marketplace-ready Claude Code skills and plugins in seconds.
tsuba is a single-binary Go CLI that generates correct Claude Code plugin directories with .claude-plugin/plugin.json, sample skill, LICENSE, and README - then hands the result to Hanko for validation before you submit to a marketplace.
The name: 鍔 (tsuba) is the guard on a katana - the disc between blade and handle that lets a swordsman grip the blade safely and hand it off to someone else. tsuba the tool does the same thing for your plugin: makes it safe to hand off to the marketplace.
Install
curl -fsSL https://roninforge.org/tsuba/install.sh | sh
Or grab a binary from the latest release. Prefer Go install:
go install github.com/RoninForge/tsuba/cmd/tsuba@latest
Also install Hanko so tsuba validate works:
curl -fsSL https://roninforge.org/hanko/install.sh | sh
Quickstart
# Create a new plugin
tsuba new plugin my-review-tool
# Create a standalone skill
tsuba new skill code-reviewer --description "Review code for quality issues"
# Validate a plugin directory (delegates to hanko)
tsuba validate
# Check your local environment (hanko on PATH, git identity, etc.)
tsuba doctor
# See which marketplaces are supported and their quirks
tsuba list marketplaces
What gets scaffolded
tsuba new plugin my-plugin creates:
my-plugin/
├── .claude-plugin/
│ └── plugin.json # name, description, author, version
├── skills/
│ └── hello/
│ └── SKILL.md # placeholder skill with frontmatter
├── LICENSE # MIT by default
└── README.md # installation + attribution footer
All generated JSON is kebab-case, version-stamped, and passes hanko check on the first try. Author name and email default to your git config (git config user.name, git config user.email) and can be overridden with --author and --email.
Sibling tools
tsuba is part of RoninForge. Its siblings:
- Hanko - validate plugin manifests before submission.
- BudgetClaw - local spend monitor for Claude Code.
Development
See CONTRIBUTING.md.
Security
See SECURITY.md.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
tsuba
command
Command tsuba is the CLI entry point.
|
Command tsuba is the CLI entry point. |
|
internal
|
|
|
cli
Package cli builds the cobra command tree.
|
Package cli builds the cobra command tree. |
|
gitctx
Package gitctx reads git configuration values so the scaffold can auto-populate author fields when the user does not pass explicit flags.
|
Package gitctx reads git configuration values so the scaffold can auto-populate author fields when the user does not pass explicit flags. |
|
hanko
Package hanko adapts the Hanko CLI for tsuba.
|
Package hanko adapts the Hanko CLI for tsuba. |
|
scaffold
Package scaffold renders the embedded templates into a directory on disk.
|
Package scaffold renders the embedded templates into a directory on disk. |
|
templates
Package templates embeds the text/template sources tsuba renders when scaffolding a new skill, plugin, hook, or agent.
|
Package templates embeds the text/template sources tsuba renders when scaffolding a new skill, plugin, hook, or agent. |
|
version
Package version exposes build-time version metadata.
|
Package version exposes build-time version metadata. |