Releases: tenzir/claude-plugins
v3.0.0 - Plugin Consolidation
This release consolidates several plugins into unified packages. The dev plugin now includes documentation, technical writing, git workflows, plan review, and auto-formatting. The tenzir plugin combines TQL and OCSF functionality.
A new emoji reaction-based changelog workflow lets you approve, reject, or modify changelog suggestions directly in PR comments using GitHub reactions.
π₯ Breaking changes
Git, plan, and formatter plugins merged into dev plugin
The git, plan, and formatter plugins have been consolidated into the dev plugin, creating a comprehensive developer utilities platform. This consolidation removes three separate plugins and unifies their capabilities within the dev plugin.
Git workflows are now part of dev:
@dev:committeragent commits changes with automatic cohesion analysis to split orthogonal changes@dev:pr-makeragent creates pull requests on GitHubdev:addressing-pr-commentsskill addresses PR review commentsdev:writing-commit-messagesskill guides cohesive commit messages
Plan review capabilities moved to dev:
- Plan review hooks (
review-plan.sh,notify-plan-review.sh,notify-review-start.sh) now run as part of dev workflows - Automated plan evaluation integrates with code review tools
- Review prompts and notifications are now scoped to the dev plugin
Auto-formatting workflows integrated:
format-hook.shand formatting logic now part of dev plugin- Automatic formatting after Write and Edit operations
- Unified hook configuration for all dev-based operations
The consolidation maintains all existing functionality while providing a more cohesive experience for development workflows. Standalone projects and module-based projects continue to be supported.
Unified dev plugin replaces docs and prose
The docs and prose plugins have been consolidated into a new dev plugin. Users must update their plugin configuration to replace docs@tenzir and prose@tenzir with dev@tenzir.
The new dev plugin combines documentation workflows with technical writing guidance into a single plugin for developer utilities. The skills are now dev:docs-authoring and dev:technical-writing, and the documentation agent is @dev:docs-updater.
Migration guide:
Update your .claude/settings.json to replace the old plugins with the new one:
"plugins": [
- "docs@tenzir",
- "prose@tenzir",
+ "dev@tenzir"
]Removed commands:
The /docs:write, /docs:review, and /docs:pr commands have been removed. Use @dev:docs-updater instead for autonomous documentation workflows.
Skill mapping:
| Old | New |
|---|---|
docs:authoring |
dev:docs-authoring |
prose:technical-writing |
dev:technical-writing |
Agent mapping:
| Old | New |
|---|---|
@docs:writer |
@dev:docs-updater |
Unified tenzir plugin replaces tql and ocsf
The tql and ocsf plugins have been consolidated into a new unified tenzir plugin. Users must update their plugin configuration to replace tql@tenzir and ocsf@tenzir with tenzir@tenzir.
The new tenzir plugin combines all TQL and OCSF functionality into a single, cohesive experience with two workflow skills (/tenzir:make-parser and /tenzir:make-ocsf-mapping) and an OCSF subagent (tenzir:ocsf) for schema questions. This simplifies plugin management by reducing the number of plugins needed for Tenzir development workflows.
Migration guide:
Update your .claude/settings.json to replace the old plugins with the new one:
"plugins": [
- "tql@tenzir",
- "ocsf@tenzir",
+ "tenzir@tenzir"
]The docs:reader agent has been removed as it's superseded by general documentation lookup patterns.
π Features
Emoji reaction-based changelog workflow
Changelog entries are now generated as suggestions in PR comments rather than automatically committed. You can approve, reject, or modify suggestions using GitHub emoji reactions.
React with π to accept and commit the entry, π to reject when no changelog is needed, or π to regenerate with different content. Additional reactions let you adjust the style: π makes entries more technical, π makes them simpler, and π adds more wit.
The workflow polls reactions every minute and automatically applies your choice. This gives you control over changelog content before it's committed to your PR.
π Bug fixes
Updated documentation URLs after ship plugin rename
The documentation URLs in the ship and tql plugins now correctly reference ship-framework.md instead of the obsolete changelog-framework.md. This completes the transition from the old changelog plugin name to the new ship plugin name, ensuring all documentation links remain functional.
Dev Plugin v3.0.0
- π₯ Consolidated docs and prose into dev plugin β @mavam and @claude
- π₯ Refactor docs plugin workflow: remove agent, add dedicated commands β @mavam and @claude
- π₯ Renamed writing skill to authoring β @mavam and @claude
- π Add /docs:review command for documentation review β @mavam and @claude
- π Add path detection to docs plugin β @mavam and @claude
- π Autonomous documentation workflow with write and review β @mavam and @claude
- π Cross-referencing PR command
- π Documentation reader subagent β @mavam and @claude
- π Fully autonomous documentation writer β @mavam and @claude
- π Initial release β @mavam and @claude
- π Intelligent documentation sync hook β @mavam and @claude
- π Unified developer utilities with integrated changelog and code review β @mavam and @claude
- π§ Automated review setup with project context awareness β @mavam and @claude
- π§ Bun package manager support in command scripts β @mavam and @claude
- π§ Category indicators and refined reviewer specializations β @mavam and @claude
- π§ Command-scoped documentation synchronization hook β @mavam and @claude
- π§ Improved skill and agent descriptions with Use when pattern β @mavam and @claude
- π§ Intelligent synthesis and structured tracking for review findings β @mavam and @claude
- π§ Rename write-docs command to write β @mavam and @claude
- π§ Simplified severity display in review output β @mavam and @claude
- π§ Simplify docs plugin directory name to .docs β @mavam and @claude
- π§ Structured hook outputs for review workflow clarity β @mavam and @claude
- π§ Unconditional documentation root at .docs β @mavam and @claude
- π§ Unified documentation synchronization across all doc commands β @mavam and @claude
- π§ Use SSH URL for docs repository clone β @mavam and @claude
- π Automatic branch switching after merged documentation branches β @mavam and @claude
- π Automatic clone of documentation repository β @mavam and @claude
- π Complete example reporting in documentation reader β @mavam and @claude
- π Correct PR creation syntax in finalize command β @mavam and @claude
- π Stricter documentation reader behavior β @mavam and @claude
- π Synchronize documentation repository before writing β @mavam and @claude
- π Worktree isolation for documentation repository clones β @mavam and @claude
Python Plugin v1.1.1
Ship Plugin
This major release renames the changelog plugin to ship to better reflect its focus on release engineering. Subagents now require explicit skill declarations in their YAML frontmatter, and tool configurations have been updated to use the consolidated Skill tool.
π₯ Breaking changes
Changelog plugin renamed to ship
The changelog plugin has been renamed to ship to better reflect its broader focus on release engineering. Users who have installed the changelog plugin should update their configuration to use ship instead.
π Features
Explicit skill declarations for subagents
Subagents now explicitly declare required skills in their YAML frontmatter using the skills: field. This change aligns with Claude Code's updated behavior where subagents no longer inherit skills from the parent conversation.
The validation script now verifies that all skill references in agent definitions point to existing skills, catching broken references before deployment.
π§ Changes
Changelog-adder action uses tenzir-changelog for PR comments
The changelog-adder GitHub Action now uses tenzir-changelog to render PR comments instead of manual frontmatter parsing. This fixes two formatting issues: a trailing separator when the created field is missing, and hard-wrapped body text that rendered with explicit line breaks.
The action also supports multiple changelog entries per PR. When a PR adds entries across several plugins, all entries appear in a single comment with proper headings and attribution links.
Initial plugin version set to 0.0.0 for proper first release bumping
The plugin template now specifies 0.0.0 as the initial version, enabling the first release to use standard bump flags (--patch, --minor, --major) to produce typical initial versions like 0.0.1, 0.1.0, or 1.0.0.
Updated tool configurations to use Skill instead of SlashCommand
The SlashCommand tool has been merged into the Skill tool in recent Claude Code versions. This updates tool configurations in the changelog adder GitHub Action and the docs writer agent to reflect this change, removing the redundant SlashCommand reference while keeping Skill.
Docs Plugin v2.2.1
- π Complete example reporting in documentation reader β @mavam and @claude
- π Stricter documentation reader behavior β @mavam and @claude
Excalidraw Plugin v0.1.1
- π§ Bidirectional arrow binding documentation β @mavam and @claude
- π§ Enhanced diagramming documentation for technical limitations β @mavam and @claude
- π§ Font selection defaults for diagram text β @mavam and @claude
- π§ Triangle arrowhead as default β @mavam and @claude
- π Artist sloppiness as default for arrows and polygons β @mavam and @claude
- π Correct polygon path closing instructions β @mavam and @claude
- π Correct text positioning formula for containers β @mavam and @claude
- π Diagram generation improvements β @mavam and @claude
Formatter Plugin v1.2.0
Git Plugin v1.3.0
- π§ Autonomous commit workflow β @mavam and @claude
- π§ Expanded static checks in commit workflow β @mavam and @claude
- π§ Immediate push after each PR comment fix β @mavam and @claude
- π§ Pre-commit linting step β @mavam and @claude
OCSF Plugin v0.1.1
- π§ Pre-commit OCSF references with automated updates β @mavam and @claude (#4)
- π§ Sonnet model for guide agent β @mavam and @claude
- π Content-based sync for OCSF documentation β @mavam and @claude
Ship Plugin v2.0.0
- π₯ Plugin renamed from changelog to ship β @mavam and @claude
- π Add
/changelog:releasecommand β @mavam and @claude - π Add changelog add command to plugin β @mavam and @claude
- π Add releaser subagent to changelog plugin β @mavam and @claude
- π Initial release β @mavam and @claude
- π Non-interactive changelog entry creation for CI automation β @mavam and @claude (#1)
- π§ Add Markdown formatting best practice β @mavam
- π§ Autonomous changelog entry creation β @mavam and @claude
- π§ Autonomous release workflow β @mavam and @claude
- π§ Clearer release staging instructions β @mavam and @claude
- π§ Document extension.toml for version bumping β @mavam and @claude
- π§ Document multi-value flags and human author requirement β @mavam
- π§ Fail-fast validation and clarified module detection in release command β @mavam and @claude
- π§ Improve changelog skill discoverability β @mavam and @claude
- π§ Improve component awareness in changelog workflow β @mavam and @claude
- π§ Improve releaser agent reliability with Sonnet model and process guardrails β @mavam and @claude
- π§ Improved context gathering for changelog entries β @mavam and @claude
- π§ Improved release title documentation β @mavam and @claude
- π§ Improved tenzir-changelog CLI documentation β @mavam and @claude
- π§ Plain text titles in changelog entries β @mavam and @claude
- π§ Relative versioning in release workflow β @mavam and @claude
- π§ Release workflow simplified with clearer module release handling β @mavam and @claude
- π§ Technical writing skill reference in
/changelog:addcommand β @mavam and @claude - π§ Updated release command for tenzir-changelog v0.17.2 β @mavam and @claude
- π§ Use --co-author for AI-assisted development β @mavam and @claude
- π§ Use
--description-fileinstead of--descriptionβ @mavam - π Always pass --description to skip interactive editor β @mavam
- π Clarify entry type selection criteria in changelog skill β @mavam and @claude
- π Clarify publish step to use release notes for preview β @mavam and @claude
- π Correct argument handling in ship commands β @mavam and @claude
- π Fix release command documentation β @mavam
- π Improved release workflow with project type detection and local temp files β @mavam and @claude
- π More accurate terminology in changelog add command β @mavam and @claude
TQL Plugin v1.2.0
OCSF and Excalidraw Plugins
This release introduces the OCSF plugin for navigating the Open Cybersecurity Schema Framework with versioned reference documentation, and the Excalidraw plugin for generating valid diagrams. It also adds a reusable GitHub Action for automated changelog entries in CI.
Breaking changes include removing the meta and auto-update plugins from the marketplace.
π₯ Breaking changes
Meta plugin removed from marketplace
The meta plugin provided guidance for managing plugins in this marketplace. Since it was self-referential and only useful within this repository, the managing-plugins skill has been moved to .claude/skills/ as a project-level skill.
Users who had meta@tenzir enabled should remove it from their settings. The validation script now detects stale plugin references in .claude/settings.json to prevent this issue in the future.
π Features
Excalidraw diagram generation plugin
Generate valid Excalidraw diagrams with the new excalidraw:diagramming skill. The skill provides comprehensive reference documentation for all element types (shapes, text, arrows, lines, freedraw, images, frames, polygons) and styling properties (colors, fill patterns, positioning, grouping). All values and constants are derived from the Excalidraw source code, ensuring compatibility with excalidraw.com and VS Code extensions.
OCSF plugin with understanding-ocsf skill
The OCSF plugin provides comprehensive schema navigation for the Open Cybersecurity Schema Framework through the understanding-ocsf skill. The skill guides users through five core OCSF concepts: attributes, objects, classes, profiles, and extensions, with detailed documentation for each.
Reference documentation is dynamically generated from schema.ocsf.io covering all stable versions from 1.0.0 to 1.7.0. The generator fetches versioned schemas and creates Markdown references for 83 event classes and 170 object types, organized by the 8 OCSF categories (System, Findings, IAM, Network, Discovery, Application, Remediation, Unmanned). Progressive disclosure is achieved through hierarchical index files that link from the main index to version-specific indices to individual class and object documentation.
Generated references are excluded from git due to their size (approximately 2.6 MB across 8 versions), and users run the generation script as needed after installation.
Reusable GitHub Action for automated changelog entries
A reusable GitHub Action enables automated changelog entry creation for pull requests. The action uses the changelog:adder agent to analyze PR changes, determine if they are user-facing, and create appropriate changelog entries.
The action is idempotent, skipping execution if an entry already exists for the PR. After creating an entry, it posts a formatted comment to the PR with metadata and sync instructions for both Git and Jujutsu workflows.
Other repositories can integrate this action into their CI workflows by referencing tenzir/claude-plugins/.github/actions/changelog-adder@main and providing a Claude Code OAuth token.
π§ Changes
README documentation standards and validation
Plugin READMEs now follow stricter documentation standards with validation.
The documentation script extracts title, description, features, and usage sections from READMEs. New requirements ensure consistency:
- Intro paragraph: 2-3 sentences after the title, kept up to date when plugins change
- Features section: Required with emoji-prefixed bullet points highlighting what the plugin provides
- Usage section: Required with real-world examples showing how to use each component
- Heading style: Standardized on
## β¨ Featuresand## π Usage
The validation script now enforces these requirements, catching missing sections and incorrect heading styles. This is important because the documentation at docs.tenzir.com relies on this structure.
Changelog Plugin v1.4.1
- π Non-interactive changelog entry creation for CI automation β @mavam and @claude (#1)
- π§ Clearer release staging instructions β @mavam and @claude
- π§ Improved context gathering for changelog entries β @mavam and @claude
- π§ Relative versioning in release workflow β @mavam and @claude
- π§ Updated release command for tenzir-changelog v0.17.2 β @mavam and @claude
- π Improved release workflow with project type detection and local temp files β @mavam and @claude
- π More accurate terminology in changelog add command β @mavam and @claude
C++ Plugin v0.3.0
- π C++ coding conventions skill β @mavam, @jachris, and @claude (#3)
- π C++ plugin with clangd language server integration β @mavam and @claude
Docs Plugin v2.2.0
- π₯ Renamed writing skill to authoring β @mavam and @claude
- π Cross-referencing PR command
- π Documentation reader subagent β @mavam and @claude
- π Fully autonomous documentation writer β @mavam and @claude
- π Intelligent documentation sync hook β @mavam and @claude
- π Automatic clone of documentation repository β @mavam and @claude
- π Synchronize documentation repository before writing β @mavam and @claude
Excalidraw Plugin v0.1.0
Formatter Plugin v1.1.1
- π YAML linting support β @mavam and @claude
- π§ EditorConfig support for shell script formatting β @mavam and @claude
Git Plugin v1.2.0
- π Pull Request Command β @mavam and @claude
- π Slash command to address PR review comments β @mavam and @claude
- π Explicit branch push before PR creation β @mavam and @claude
- π Multi-line review comment support in address-pr-comments command β @mavam and @claude
OCSF Plugin v0.1.0
- π Lazy OCSF reference generation β @mavam and @claude
- π OCSF guide subagent for schema questions β @mavam and @claude
- π Versioned profile references and external resource integration β @mavam and @claude
- π§ Versioned classes and objects overviews β @mavam and @claude
Python Plugin v1.1.0
TQL Plugin v1.1.1
First Stable Release
First Stable Release
This is the first stable release of the Tenzir Claude Marketplace, a collection of plugins that extend Claude Code's capabilities for working with the Tenzir ecosystem.
This release introduces fully qualified skill names across all plugins for clarity and consistency. The writing plugin has been renamed to prose to better reflect its purpose, and the auto-update plugin has been removed in favor of manual updates. The CI now validates all skills using the official Agent Skills specification.
π₯ Breaking changes
Remove auto-update plugin
Remove the auto-update plugin as it was ineffective. The plugin ran on session start, but the current session already has old plugin code loaded, so updates only take effect on the next session. This made the automation pointless.
Users can manually run claude plugin marketplace update tenzir when they want to update the marketplace.
Renamed writing plugin to prose
The writing plugin is now prose to better reflect its purpose: style guidelines for technical prose across different contexts (documentation, error messages, CLI output, etc.).
All references to writing:technical-writing are now prose:technical-writing.
Use fully qualified skill names throughout plugins
All skill references now use fully qualified names (plugin:skill-name format) for clarity and consistency.
The following skills were renamed to follow the gerund naming convention and avoid redundancy with the plugin name prefix:
changelog-managementβmanaging-entrieswriting-documentationβwriting
Affected references across plugins:
git:writing-commit-messagesbrand:styling-tenzir-uichangelog:managing-entriesdocs:writingmeta:managing-pluginspython:python-conventionsprose:technical-writing
π Features
Skill validation in CI using agentskills skills-ref
The CI now validates all plugin skills using the official skills-ref tool from the agentskills project. This validation runs in parallel with the existing plugin structure validation, ensuring skills conform to the Agent Skills specification.
π§ Changes
Add color properties to subagents
The releaser subagent now uses green and the committer subagent uses yellow for visual distinction in the CLI.
Automatically load meta:managing-plugins skill for plugin development
Add a rule that automatically loads the meta:managing-plugins skill when working with files in the plugins/ directory. This improves the developer experience by ensuring the essential plugin management guidance is always available when creating, modifying, or reviewing plugins.
Clarify plugin release publishing responsibilities
Clarified that plugin releases do not create git tags or GitHub releases. Plugin releases now stage and commit locally, with the parent project handling publishing. Updated documentation to reflect this responsibility boundary.
Document plugin version synchronization requirement
The plugin.json version must match the latest released version in the plugin's changelog/releases/ directory. When releasing via /changelog:release, update plugin.json accordingly.
Expand commit command guidance
The /git:commit command now provides more actionable guidance for project-specific requirements. Each requirement (changelog entries, version bumps, validation steps) includes specific instructions on what to look for and how to proceed.
Improve skill descriptions for better discoverability
Skill descriptions now include more action-based triggers (running tools, editing files) alongside file-based triggers for better discoverability. Also removes time-sensitive wording from python-conventions.
Improve skill discoverability with artifact-based triggers
Rename skills and update descriptions to trigger on artifact detection rather than specific user queries:
writing-python-codeβpython-conventions: triggers on Python repository orpyproject.toml/uv.lock/ruff.toml/.pyfilesmanaging-changelogsβchangelog-management: triggers on changelog questions orchangelog/directory
By @mavam.
Update commit command to use /changelog:add slash command
Reference the /changelog:add slash command instead of invoking the changelog skill directly for a guided workflow.
Use AskUserQuestion in release command
The /release command now explicitly references AskUserQuestion for user prompts, matching the pattern established in /commit.
Version synchronization validation in plugin validation script
The plugin validation script now enforces that the version field in each plugin's plugin.json matches the latest released version in its changelog/releases/ directory. This validation catches mismatches between the declared plugin version and the actual released version, helping maintain consistency across the plugin marketplace.
π Bug fixes
Broaden managing-plugins skill triggers
The skill description now emphasizes "editing ANY file in the plugins/ directory" and explicitly mentions "bumping plugin versions" as a trigger, making it clearer when the skill should be loaded.
Brand Plugin v1.0.0
- π Add brand plugin with Tenzir design system β @mavam and @claude
- π Add official SVG logo assets β @mavam and @claude
- π Expand badge color palette to match tags β @mavam and @claude
- π Initial release β @mavam and @claude
- π Standardize CSS custom properties with --tnz- prefix β @mavam and @claude
Changelog Plugin v1.2.0
- π Add
/changelog:releasecommand β @mavam and @claude - π Add changelog add command to plugin β @mavam and @claude
- π Add releaser subagent to changelog plugin β @mavam and @claude
- π Initial release β @mavam and @claude
- π§ Add Markdown formatting best practice β @mavam
- π§ Document extension.toml for version bumping β @mavam and @claude
- π§ Document multi-value flags and human author requirement β @mavam
- π§ Improve changelog skill discoverability β @mavam and @claude
- π§ Improve component awareness in changelog workflow β @mavam and @claude
- π§ Improve releaser agent reliability with Sonnet model and process guardrails β @mavam and @claude
- π§ Improved release title documentation β @mavam and @claude
- π§ Improved tenzir-changelog CLI documentation β @mavam and @claude
- π§ Plain text titles in changelog entries β @mavam and @claude
- π§ Release workflow simplified with clearer module release handling β @mavam and @claude
- π§ Technical writing skill reference in
/changelog:addcommand β @mavam and @claude - π§ Use --co-author for AI-assisted development β @mavam and @claude
- π§ Use
--description-fileinstead of--descriptionβ @mavam - π Always pass --description to skip interactive editor β @mavam
- π Clarify entry type selection criteria in changelog skill β @mavam and @claude
- π Clarify publish step to use release notes for preview β @mavam and @claude
- π Fix release command documentation β @mavam
Docs Plugin v1.1.0
- π₯ Refactor docs plugin workflow: remove agent, add dedicated commands β @mavam and @claude
- π Add /docs:review command for documentation review β @mavam and @claude
- π Add path detection to docs plugin β @mavam and @claude
- π Autonomous documentation workflow with write and review β @mavam and @claude
- π Initial release β @mavam and @claude
- π§ Rename write-docs command to write β @mavam and @claude
- π§ Simplify docs plugin directory name to .docs β @mavam and @claude
- π§ Unconditional documentation root at .docs β @mavam and @claude
- π§ Use SSH URL for docs repository clone β @mavam and @claude
Formatter Plugin v1.0.0
- π Initial release β @mavam and @claude
- π Add MDX file support to formatter hook β @mavam and @claude
- π Use portable shebang in formatter hook β @mavam and @claude
Git Plugin v1.0.0
- π Add /commit slash command β @mavam
- π Add committer subagent β @mavam
- π Initial release β @mavam and @claude
- π Prompt for orthogonal staged changes β @mavam and @claude
- π§ Reference changelog skill in /commit command β @mavam and @claude
- π Fix unqualified skill reference in git plugin README β @mavam and @claude
- π Improve skill trigger for commit requests β @mavam
Meta Plugin v1.1.0
- π₯ Rename writing-plugins skill to managing-plugins β @mavam and @claude
- π Initial release β @mavam and @claude
- π§ Document composability principle for subagents β @mavam and @claude
- π§ Document description duplication requirement β @mavam and @claude
- π§ Refactor managing-plugins skill with progressive disclosure β @mavam
Prose Plugin v1.0.0
- π Add writing plugin for technical documentation β @mavam and @claude
- π Initial release β @mavam and @claude
- π Fix unqualified skill reference in writing plugin README β @mavam and @claude
Python Plugin v1.0.0
- π₯ Rename
python-conventionsskill tofollowing-conventionsβ @mavam and @claude - π₯ Replace
/python:releasewith/changelog:releaseβ @mavam and @claude - π Add dependency upgrade guide for Python plugin β @mavam and @claude
- π Initial release β @mavam and @claude