Skip to content

Commit fd648cf

Browse files
docs(plugin-dev): identity & ownership — author, fork attribution, CHANGELOG (#46)
* docs(plugin-dev): identity & ownership — author, fork attribution, CHANGELOG - Replace upstream author (Daisy Hollman) with Nuno Salvação in README.md - Add fork attribution section referencing anthropics/claude-plugins-official - Update Contributing section to point to nsalvacao-claude-code-plugins repo - Create CHANGELOG.md documenting v1.0.0 changes vs upstream baseline - Fix two pre-existing MD012 (multiple blank lines) markdownlint errors Roadmap: v1.1 — Identity & Ownership (all 3 items done) Generated by Nuno Salvação Co-Authored-By: Nexo <nexo.modeling@gmail.com> * fix(plugin-dev): align README version with CHANGELOG and marketplace.json Version section showed 0.1.0 (upstream baseline) after introducing CHANGELOG.md which starts at 1.0.0. Update to 1.0.0 and reference CHANGELOG for details. Addresses Gemini review comment on PR #46. Generated by Nuno Salvação Co-Authored-By: Nexo <nexo.modeling@gmail.com> --------- Co-authored-by: Nexo <nexo.modeling@gmail.com>
1 parent 19594fe commit fd648cf

2 files changed

Lines changed: 55 additions & 8 deletions

File tree

plugins/plugin-dev/CHANGELOG.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# CHANGELOG — plugin-dev
2+
3+
This file tracks all notable changes made in this fork relative to the upstream source.
4+
5+
Upstream: [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official)
6+
Fork maintained by: Nuno Salvação
7+
8+
---
9+
10+
## [1.0.0] — 2026-03-12
11+
12+
### Added
13+
14+
- Registered `plugin-dev` as a marketplace plugin in `.claude-plugin/marketplace.json` (v1.0.0).
15+
- `plugin-validation.yml` CI now includes `plugin-dev` in README and marketplace sync checks.
16+
17+
### Fixed
18+
19+
- `validate-hook-schema.sh`: arithmetic bug replaced (`((n++))``n=$((n+1))`) — prevents
20+
premature exit under `set -e` when the counter starts at 0.
21+
- `validate-hook-schema.sh`: added wrapper format detection and unwrap support — the canonical
22+
`{"hooks":{...}}` wrapper format is now accepted and validated correctly.
23+
- `hooks/hooks.json` in all 6 plugins: migrated from direct format to wrapper format
24+
(`{"hooks":{"EventName":[...]}}`) as required by the Claude Code runtime.
25+
- `hook-development/SKILL.md`: corrected canonical `hooks.json` format documentation from
26+
direct format to wrapper format throughout.
27+
- `hook-development/references/migration.md`: updated all hook configuration examples to use
28+
the correct wrapper format.
29+
30+
---
31+
32+
## [Upstream Baseline]
33+
34+
Content inherited from `anthropics/claude-plugins-official` at fork point (2026-03-12):
35+
36+
- 7 skills: `hook-development`, `mcp-integration`, `plugin-structure`, `plugin-settings`,
37+
`command-development`, `agent-development`, `skill-development`
38+
- 3 agents: `agent-creator`, `plugin-validator`, `skill-reviewer`
39+
- 1 command: `create-plugin`
40+
- Validation scripts: `validate-hook-schema.sh`, `validate-agent.sh`, `validate-settings.sh`,
41+
`parse-frontmatter.sh`, `test-hook.sh`, `hook-linter.sh`

plugins/plugin-dev/README.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Plugin Development Toolkit
22

3+
An independent fork of [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official), maintained by Nuno Salvação with improvements to validation tooling, canonical formats, and documentation.
4+
35
A comprehensive toolkit for developing Claude Code plugins with expert guidance on hooks, MCP integration, plugin structure, and marketplace publishing.
46

57
## Overview
@@ -192,7 +194,6 @@ Use this workflow for structured, high-quality plugin development from concept t
192194

193195
**Use when:** Creating new skills for plugins or improving existing skill quality.
194196

195-
196197
## Installation
197198

198199
Install from claude-code-marketplace:
@@ -223,7 +224,6 @@ cc --plugin-dir /path/to/plugin-dev
223224
- Ask: "Create a PreToolUse hook that validates file writes"
224225
- The hook-development skill gives working examples and utilities
225226

226-
227227
## Development Workflow
228228

229229
The plugin-dev toolkit supports your entire plugin development lifecycle:
@@ -378,20 +378,26 @@ All skills emphasize:
378378

379379
## Contributing
380380

381-
This plugin is part of the claude-code-marketplace. To contribute improvements:
381+
This plugin is part of [nsalvacao-claude-code-plugins](https://github.com/nsalvacao/nsalvacao-claude-code-plugins). To contribute improvements:
382382

383-
1. Fork the marketplace repository
384-
2. Make changes to plugin-dev/
383+
1. Fork the repository
384+
2. Make changes to `plugins/plugin-dev/`
385385
3. Test locally with `cc --plugin-dir`
386-
4. Create PR following marketplace-publishing guidelines
386+
4. Create a PR following the repository's contribution guidelines
387387

388388
## Version
389389

390-
0.1.0 - Initial release with seven comprehensive skills and three validation agents
390+
1.0.0 - Forked from upstream. See CHANGELOG.md for details.
391391

392392
## Author
393393

394-
Daisy Hollman (daisy@anthropic.com)
394+
Nuno Salvação
395+
396+
## Fork Attribution
397+
398+
This plugin is an independent fork of [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official).
399+
Original work by Daisy Hollman (daisy@anthropic.com) and the Anthropic team.
400+
See [CHANGELOG.md](./CHANGELOG.md) for a full list of changes made in this fork.
395401

396402
## License
397403

0 commit comments

Comments
 (0)