Skip to content

Commit 76cb396

Browse files
sjnimsclaude
andcommitted
docs: update README accuracy, add attribution, update repo URLs
- Fix word counts to use approximate values across all skills - Update MCP integration resources (4 examples, 4 refs including server-discovery) - Update agent development to show all 3 utility scripts - Update command development with accurate resource counts - Add comprehensive Attribution section crediting original author - Update installation instructions for this repository - Update plugin.json homepage/repository to sjnims/plugin-dev - Add Steve Nims copyright to LICENSE.txt - Expand Utility Scripts section with all 12 scripts - Update Working Examples to cover all 7 skills 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 88c6498 commit 76cb396

3 files changed

Lines changed: 57 additions & 37 deletions

File tree

LICENSE.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
MIT License
22

33
Copyright (c) 2025 Daisy Hollman
4+
Copyright (c) 2025 Steve Nims
45

56
Permission is hereby granted, free of charge, to any person obtaining a copy
67
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 53 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ Use this workflow for structured, high-quality plugin development from concept t
6666
- ${CLAUDE_PLUGIN_ROOT} for portable paths
6767

6868
**Resources:**
69-
- Core SKILL.md (2,125 words)
69+
- Core SKILL.md (~2,100 words)
7070
- 3 example hook scripts (validate-write, validate-bash, load-context)
7171
- 3 reference docs: patterns, migration, advanced techniques
7272
- 3 utility scripts: validate-hook-schema.sh, test-hook.sh, hook-linter.sh
@@ -86,9 +86,9 @@ Use this workflow for structured, high-quality plugin development from concept t
8686
- Integration patterns and performance optimization
8787

8888
**Resources:**
89-
- Core SKILL.md (1,663 words)
90-
- 3 example configurations (stdio, SSE, HTTP)
91-
- 3 reference docs: server-types (~1,370w), authentication (~1,280w), tool-usage (~1,540w)
89+
- Core SKILL.md (~1,770 words)
90+
- 4 example configurations (stdio, SSE, HTTP, WebSocket)
91+
- 4 reference docs: server-types, authentication, tool-usage, server-discovery
9292

9393
**Use when:** Integrating external services, APIs, databases, or tools into your plugin.
9494

@@ -105,7 +105,7 @@ Use this workflow for structured, high-quality plugin development from concept t
105105
- Minimal, standard, and advanced plugin patterns
106106

107107
**Resources:**
108-
- Core SKILL.md (1,654 words)
108+
- Core SKILL.md (~1,650 words)
109109
- 3 example structures (minimal, standard, advanced)
110110
- 2 reference docs: component-patterns, manifest-reference
111111

@@ -125,7 +125,7 @@ Use this workflow for structured, high-quality plugin development from concept t
125125
- Gitignore and lifecycle management
126126

127127
**Resources:**
128-
- Core SKILL.md (1,623 words)
128+
- Core SKILL.md (~1,620 words)
129129
- 3 examples (read-settings hook, create-settings command, templates)
130130
- 2 reference docs: parsing-techniques, real-world-examples
131131
- 2 utility scripts: validate-settings.sh, parse-frontmatter.sh
@@ -145,9 +145,10 @@ Use this workflow for structured, high-quality plugin development from concept t
145145
- Best practices for command development
146146

147147
**Resources:**
148-
- Core SKILL.md (2,235 words)
149-
- Examples and reference documentation
150-
- Command organization patterns
148+
- Core SKILL.md (~2,240 words)
149+
- 2 examples: simple-commands, plugin-commands
150+
- 8 reference docs: frontmatter-reference, slashcommand-tool, interactive-commands, plugin-integration, advanced-workflows, testing-strategies, documentation-patterns, marketplace-considerations
151+
- 2 utility scripts: validate-command.sh, check-frontmatter.sh
151152

152153
**Use when:** Creating slash commands, defining command arguments, or organizing plugin commands.
153154

@@ -165,10 +166,10 @@ Use this workflow for structured, high-quality plugin development from concept t
165166
- Complete production-ready agent examples
166167

167168
**Resources:**
168-
- Core SKILL.md (1,896 words)
169+
- Core SKILL.md (~1,900 words)
169170
- 2 examples: agent-creation-prompt (AI-assisted workflow), complete-agent-examples (4 full agents)
170-
- 3 reference docs: agent-creation-system-prompt (from Claude Code), system-prompt-design (~1,400w), triggering-examples (~1,600w)
171-
- 1 utility script: validate-agent.sh
171+
- 3 reference docs: agent-creation-system-prompt (from Claude Code), system-prompt-design, triggering-examples
172+
- 3 utility scripts: validate-agent.sh, test-agent-trigger.sh, create-agent-skeleton.sh
172173

173174
**Use when:** Creating autonomous agents, defining agent behavior, or implementing AI-assisted agent generation.
174175

@@ -186,24 +187,24 @@ Use this workflow for structured, high-quality plugin development from concept t
186187
- Based on skill-creator methodology adapted for Claude Code plugins
187188

188189
**Resources:**
189-
- Core SKILL.md (1,463 words)
190-
- References: skill-creator methodology, plugin-dev patterns
191-
- Examples: Study plugin-dev's own skills as templates
190+
- Core SKILL.md (~1,460 words)
191+
- 3 examples: minimal-skill, complete-skill, frontmatter-templates
192+
- 2 reference docs: skill-creator-original, skill-creation-workflow
192193

193194
**Use when:** Creating new skills for plugins or improving existing skill quality.
194195

195196
## Installation
196197

197-
Install from claude-code-marketplace:
198+
Install from this repository:
198199

199200
```bash
200-
/plugin install plugin-dev@claude-code-marketplace
201+
/plugin install sjnims/plugin-dev
201202
```
202203

203204
Or for development, use directly:
204205

205206
```bash
206-
cc --plugin-dir /path/to/plugin-dev
207+
claude --plugin-dir /path/to/plugin-dev/plugins/plugin-dev
207208
```
208209

209210
## Quick Start
@@ -274,6 +275,7 @@ Each skill includes production-ready utilities (paths relative to `plugins/plugi
274275
# Agent development
275276
./skills/agent-development/scripts/validate-agent.sh agents/my-agent.md
276277
./skills/agent-development/scripts/test-agent-trigger.sh agents/my-agent.md
278+
./skills/agent-development/scripts/create-agent-skeleton.sh my-agent agents/
277279

278280
# Command development
279281
./skills/command-development/scripts/validate-command.sh commands/my-command.md
@@ -282,19 +284,23 @@ Each skill includes production-ready utilities (paths relative to `plugins/plugi
282284
# Hook development
283285
./skills/hook-development/scripts/validate-hook-schema.sh hooks/hooks.json
284286
./skills/hook-development/scripts/test-hook.sh my-hook.sh test-input.json
287+
./skills/hook-development/scripts/hook-linter.sh hooks/my-hook.sh
285288

286289
# Plugin settings
287290
./skills/plugin-settings/scripts/validate-settings.sh .claude/plugin.local.md
291+
./skills/plugin-settings/scripts/parse-frontmatter.sh .claude/plugin.local.md
288292
```
289293

290294
### Working Examples
291295

292296
Every skill provides working examples:
293297
- **Hook Development**: 3 complete hook scripts (bash, write validation, context loading)
294-
- **MCP Integration**: 3 server configurations (stdio, SSE, HTTP)
298+
- **MCP Integration**: 4 server configurations (stdio, SSE, HTTP, WebSocket)
295299
- **Plugin Structure**: 3 plugin layouts (minimal, standard, advanced)
296300
- **Plugin Settings**: 3 examples (read-settings hook, create-settings command, templates)
297-
- **Command Development**: 10 complete command examples (review, test, deploy, docs, etc.)
301+
- **Command Development**: 2 example collections with multiple command patterns
302+
- **Agent Development**: 2 examples with 4+ complete production-ready agents
303+
- **Skill Development**: 3 examples (minimal, complete, frontmatter templates)
298304

299305
## Documentation Standards
300306

@@ -307,10 +313,10 @@ All skills follow consistent standards:
307313

308314
## Total Content
309315

310-
- **Core Skills**: ~12,659 words across 7 SKILL.md files
316+
- **Core Skills**: ~12,750 words across 7 SKILL.md files
311317
- **Reference Docs**: ~10,000+ words of detailed guides
312-
- **Examples**: 12+ working examples (hook scripts, MCP configs, plugin layouts, settings files)
313-
- **Utilities**: 10 production-ready validation/testing/parsing scripts
318+
- **Examples**: 20+ working examples (hook scripts, MCP configs, plugin layouts, settings files, commands, agents)
319+
- **Utilities**: 12 production-ready validation/testing/parsing scripts
314320

315321
## Use Cases
316322

@@ -382,24 +388,38 @@ All skills emphasize:
382388

383389
## Contributing
384390

385-
This plugin is part of the claude-code-marketplace. To contribute improvements:
391+
To contribute improvements:
386392

387-
1. Fork the marketplace repository
388-
2. Make changes to plugin-dev/
389-
3. Test locally with `cc --plugin-dir`
390-
4. Create PR following marketplace-publishing guidelines
393+
1. Fork this repository
394+
2. Make changes to `plugins/plugin-dev/`
395+
3. Test locally with `claude --plugin-dir plugins/plugin-dev`
396+
4. Create a PR with your changes
391397

392-
## Version
398+
## Attribution
393399

394-
0.1.0 - Initial release with seven comprehensive skills and three validation agents
400+
This plugin was originally developed by [Daisy Hollman](mailto:daisy@anthropic.com) at Anthropic. The original plugin can be found at:
401+
402+
- [claude-code/plugins/plugin-dev](https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev)
403+
- [claude-plugins-official/plugins/plugin-dev](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/plugin-dev)
404+
405+
This repository ([sjnims/plugin-dev](https://github.com/sjnims/plugin-dev)) is an expanded version of the original, with improvements made through successive review iterations using the plugin-dev skills themselves, validated against the official [Claude Code plugin documentation](https://docs.anthropic.com/en/docs/claude-code/plugins) and [skill documentation](https://docs.anthropic.com/en/docs/claude-code/skills).
395406

396-
## Author
407+
**Key improvements in this repository:**
397408

398-
Daisy Hollman (<daisy@anthropic.com>)
409+
- Enhanced skill descriptions with stronger trigger phrases
410+
- Additional utility scripts (test-agent-trigger.sh, create-agent-skeleton.sh)
411+
- Expanded MCP integration documentation (server-discovery, WebSocket examples)
412+
- Comprehensive command development references
413+
- CI/CD workflows for validation and quality assurance
414+
- Improved cross-references between skills
415+
416+
## Version
417+
418+
0.1.0 - Initial release with seven comprehensive skills and three validation agents
399419

400420
## License
401421

402-
MIT License - See repository for details
422+
MIT License - See [LICENSE.txt](LICENSE.txt) for details
403423

404424
---
405425

plugins/plugin-dev/.claude-plugin/plugin.json

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,10 @@
44
"description": "Comprehensive toolkit for developing Claude Code plugins. Includes 7 expert skills covering hooks, MCP integration, commands, agents, and best practices. AI-assisted plugin creation and validation.",
55
"author": {
66
"name": "Daisy Hollman",
7-
"email": "daisy@anthropic.com",
8-
"url": "https://github.com/anthropics/claude-code/"
7+
"email": "daisy@anthropic.com"
98
},
10-
"homepage": "https://github.com/anthropics/claude-code/",
11-
"repository": "https://github.com/anthropics/claude-code/",
9+
"homepage": "https://github.com/sjnims/plugin-dev",
10+
"repository": "https://github.com/sjnims/plugin-dev",
1211
"license": "MIT",
1312
"keywords": [
1413
"development"

0 commit comments

Comments
 (0)