https://github.com/dantuck/claude-kit
https://github.com/dantuck/claude-kit
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dantuck/claude-kit
- Owner: dantuck
- Created: 2026-04-26T21:50:52.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-26T22:13:47.000Z (3 months ago)
- Last Synced: 2026-04-27T00:16:42.089Z (3 months ago)
- Language: Python
- Size: 30.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# claude-kit
A personal Claude Code plugin marketplace. Marketplace ID: `claude-kit`.
## Plugins
| Plugin | Type | Category | Description |
|--------|------|----------|-------------|
| [conventional-commits](skills/conventional-commits) | skill | productivity | Enforces Conventional Commits v1.0.0 for all git commit messages |
| [wt-workflow](skills/wt-workflow) | skill | productivity | Skill for the `wt` git worktree CLI — all subcommands and the core workflow |
| [add-plugin](skills/add-plugin) | skill | productivity | Scaffolds and registers new plugins in this marketplace |
| [secret-guard](hooks/secret-guard) | hook | security | Blocks reading secret files, env var dumps, and warns on writing credentials |
---
## Setup
### 1. Register the marketplace
```bash
claude plugin marketplace add https://github.com/dantuck/claude-kit
```
Verify it was registered:
```bash
claude plugin marketplace list
# claude-kit → https://github.com/dantuck/claude-kit
```
### 2. Install plugins
Install any plugin from the marketplace with:
```bash
claude plugin install @claude-kit --scope user
```
The `--scope user` flag installs the plugin for all your projects. Omit it to install for the current project only.
**Install all plugins at once:**
```bash
claude plugin install conventional-commits@claude-kit --scope user
claude plugin install wt-workflow@claude-kit --scope user
claude plugin install add-plugin@claude-kit --scope user
claude plugin install secret-guard@claude-kit --scope user
```
### 3. Verify installation
```bash
claude plugin list
```
---
## Plugin details
### conventional-commits
Enforces [Conventional Commits v1.0.0](https://www.conventionalcommits.org/) for every git commit. Activates automatically whenever Claude creates or suggests a commit message.
- Structured commit types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
- Optional scope in parentheses: `feat(auth): add OAuth2`
- Breaking change notation: `!` suffix or `BREAKING CHANGE:` footer
- Never adds `Co-Authored-By` or AI attribution footers
- User-invocable as `/conventional-commits:commit`
```bash
claude plugin install conventional-commits@claude-kit --scope user
```
### wt-workflow
Teaches Claude the [`wt`](https://codeberg.org/tuck/wt) git worktree CLI. Activates on any mention of `wt` commands, `.worktreekeep`, or worktree management tasks.
- Covers installation (fish shell and bash/zsh)
- All subcommands: `wt switch`, `wt update`, `wt remove`, `wt prune`, `wt review`, `wt -w`, `wt doctor`
- The stable workflow pattern for keeping `main` clean
- `.worktreekeep` config for persisting worktrees across `wt prune`
```bash
claude plugin install wt-workflow@claude-kit --scope user
```
### add-plugin
Guides Claude through creating a new plugin in this marketplace. Activates on requests like "add a plugin", "create a plugin", or "scaffold a plugin".
- Scaffolds the full directory structure for skill or hook-only plugins
- Writes `SKILL.md`, `plugin.json`, `evals/evals.json`, and `README.md`
- Updates `marketplace.json` and validates the manifest
- Installs the plugin immediately after creation
- User-invocable as `/add-plugin:add-plugin`
```bash
claude plugin install add-plugin@claude-kit --scope user
```
### secret-guard
A hook plugin that intercepts tool calls before they execute and prevents secrets from leaking into the conversation.
| Trigger | Action |
|---------|--------|
| `Bash` reading `.env`, `*.pem`, `*.key`, credentials files | Block |
| `Bash` running `env`, `printenv`, or echoing credential vars | Block |
| `Read` on any secrets-pattern path | Block |
| `Write` / `Edit` to a secrets-pattern path | Warn |
Detected patterns: `.env*`, `*.pem`, `*.key`, `*.p12`, `*.pfx`, `*.jks`, `*.ppk`, `*.cer`, `*.crt`, `credentials`, `secrets.yml/json/toml`, `id_rsa`, `id_ed25519`, `.netrc`, `.pgpass`.
```bash
claude plugin install secret-guard@claude-kit --scope user
```
---
## Repository structure
```
claude-kit/
├── .claude-plugin/
│ └── marketplace.json ← marketplace manifest
├── skills/
│ └── / ← skill plugins
│ ├── .claude-plugin/
│ │ └── plugin.json ← plugin manifest
│ ├── skills/
│ │ └── /
│ │ └── SKILL.md ← skill loaded when installed as plugin
│ ├── evals/
│ │ └── evals.json
│ ├── SKILL.md ← skill loaded when used standalone
│ └── README.md
└── hooks/
└── / ← hook-only plugins (no SKILL.md)
├── .claude-plugin/
│ └── plugin.json
├── hooks/
│ ├── hooks.json
│ └── pretooluse.py
├── evals/
│ └── evals.json
└── README.md
```
---
## Adding a new plugin
Use the `add-plugin` skill — it handles scaffolding, writing all files, updating `marketplace.json`, validating, and installing. Do not scaffold manually unless the skill is unavailable.
After adding a plugin, update the table at the top of this README.
---
## Maintenance commands
```bash
# Validate a plugin manifest
claude plugin validate skills/
claude plugin validate hooks/
# Validate the marketplace manifest
claude plugin validate ~/claude-kit
# Sync the marketplace index after editing marketplace.json
claude plugin marketplace update claude-kit
# Tag a release
claude plugin tag skills/
claude plugin tag hooks/
```
---
## Contributing
Plugins in this repo are personal tools, but suggestions and improvements are welcome.
- Open an issue to propose a new plugin or report a bug
- Fork and submit a pull request for fixes or enhancements
- All commit messages must follow [Conventional Commits v1.0.0](https://www.conventionalcommits.org/)
- New plugins require at least 3 evals (happy path, edge case, negative case)
---
## License
MIT © Plan To Live LLC