claude-config · the herow plugin marketplace
Personal Claude Code toolkit — slash commands, skills, agents, guardrail hooks, and
always-on rules — packaged as a Claude Code plugin marketplace. No clone, no
symlinks, no install script: two commands and it auto-updates from this repo.
Install
Inside Claude Code:
/plugin marketplace add judsonjuniorr/claude-config
/plugin install herow-core@herow
Then pick the suites you want:
/plugin install herow-dev@herow # dev workflows
/plugin install herow-seo@herow # SEO/GEO suite
/plugin install herow-finance@herow # finance automation
/plugin install herow-extras@herow # standalone utilities
Auto-update (do this once)
/plugin → Marketplaces → herow → Enable auto-update
Plugins are versioned by commit SHA (no pinned version in any plugin.json), so
every push to main is a new version — with auto-update enabled, it applies at the
next session start. As a fallback, herow-core ships a silent SessionStart check
(throttled to once/hour, network-failure-safe) that tells you when you're behind,
and /herow-core:upgrade force-updates on demand.
Plugins
| Plugin | What you get |
|---|
| herow-core | Guardrail hooks (doc-file warning, config protection, stop-guard, batched format+typecheck at Stop, console.log checks, git-guard), always-on coding rules injected at session start (terse "caveman" output by default — /herow-core:uncompress restores full prose), the github-ops skill (token-efficient git/gh/glab via scripts), code-reviewer + debugger agents, /herow-core:upgrade, and /herow-core:setup (one-command stack installer: gstack + headroom + the herow-dev flow commands; removes OMEGA & conflicts, prompted) |
| herow-dev | Commands: /herow-dev:blueprint·quick·execute (gstack plan→worktree→ship flow, graphify-integrated), /herow-dev:code:review·refactor·generate-tests, /herow-dev:git:pr·fix-conflicts·release-notes, /herow-dev:react:review·test·validate-ui, /herow-dev:python:review·fastapi-review. Skills: error-handling, prompt-optimizer, deep-research, exa-search, research-ops, jira-integration. 17 specialist agents (fullstack, python-pro, reviewers, tdd-guide, ui-ux, …) |
| herow-seo | 11 commands (/herow-seo:weekly-audit, ctr-tune, indexation-check, content-sprint, geo-optimize, report, …) + seo-strategist, technical-seo-auditor, content-engineer agents + the GSC data-contract reference |
| herow-finance | /herow-finance:organizze (Organizze API analysis with the financial-analyst agent), context/goal/profile helpers, /herow-finance:nf-tomada (Contabilizei NF registration). Data lives in ~/finance/ and survives updates |
| herow-extras | /herow-extras:create-prd, /herow-extras:file-organizer, /herow-extras:graphify-install |
Old install.sh profiles map to: minimal → core · dev → core+dev · seo → core+seo · finance → core+finance.
Migrating from the legacy symlink install
If you previously ran install.sh (symlinks into ~/.claude/ + hooks merged into
settings.json), run this before installing the plugins — otherwise every hook
fires twice:
./migrate.sh
It removes the repo's symlinks from ~/.claude/{agents,commands,skills,rules},
strips the merged hook entries from settings.json (markers
claude-config-hooks/ and github-ops/hooks/), and prints the install commands.
Idempotent; touches nothing it didn't create.
Command renames
Plugin commands are namespaced by plugin name (imposed by Claude Code):
| Before | After |
|---|
/code:review | /herow-dev:code:review |
/git:pr | /herow-dev:git:pr |
/seo:weekly-audit | /herow-seo:weekly-audit |
/finance:organizze | /herow-finance:organizze |
/contabilizei:nf-tomada | /herow-finance:nf-tomada |
/create-prd | /herow-extras:create-prd |
Structure
claude-config/
├── .claude-plugin/marketplace.json # the "herow" marketplace (5 plugins)
├── plugins/
│ ├── herow-core/
│ │ ├── .claude-plugin/plugin.json
│ │ ├── hooks/hooks.json # auto-registered when the plugin is enabled
│ │ ├── scripts/ # hook scripts + rules-inject.sh + update-check.sh
│ │ ├── rules/ # common/ (injected at SessionStart) + per-language
│ │ ├── skills/github-ops/
│ │ ├── commands/upgrade.md
│ │ └── agents/
│ ├── herow-dev/ # commands/{code,git,react,python}/ + skills/ + agents/
│ ├── herow-seo/ # commands/ + agents/ + reference/gsc-data-contract.md
│ ├── herow-finance/ # commands/ + scripts/{organizze,finance,contabilizei}/ + agents/
│ └── herow-extras/ # commands/
├── docs/ # relocated namespace docs + MCP server templates (docs/mcp/)
├── migrate.sh # legacy symlink install → plugin migration
└── .github/workflows/plugin-ci.yml
How the unsupported pieces work
