Skip to content

Commit c719580

Browse files
sjnimsclaude
andcommitted
docs: fix component counts and update documentation accuracy
- Update README.md: "2 guided workflow commands" → "3 slash commands" - Update README.md: skill word count "~1,500-2,000" → "~1,000-2,200" - Update CONTRIBUTING.md: command count and list all 3 slash commands - Update CLAUDE.md: word count range and command description accuracy - Fix marketplace.json: homepage URL to sjnims/plugin-dev 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent e472cfa commit c719580

File tree

4 files changed

+45
-7
lines changed

4 files changed

+45
-7
lines changed

.claude-plugin/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
"url": "https://github.com/anthropics/claude-code/",
1919
"email": "daisy@anthropic.com"
2020
},
21-
"homepage": "https://github.com/anthropics/claude-code/",
21+
"homepage": "https://github.com/sjnims/plugin-dev",
2222
"tags": [
2323
"ai-tools",
2424
"claude",

CLAUDE.md

Lines changed: 40 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
44

55
## Overview
66

7-
This repository is a **plugin marketplace** containing the **plugin-dev** plugin - a comprehensive toolkit for developing Claude Code plugins. It provides 8 specialized skills, 3 agents, and 2 guided workflow commands for building high-quality plugins and marketplaces.
7+
This repository is a **plugin marketplace** containing the **plugin-dev** plugin - a comprehensive toolkit for developing Claude Code plugins. It provides 8 specialized skills, 3 agents, and 3 slash commands (1 entry point + 2 guided workflows) for building high-quality plugins and marketplaces.
88

99
## Quick Reference
1010

@@ -41,7 +41,7 @@ When testing locally, point to the plugin directory, not the root.
4141

4242
Each skill follows progressive disclosure:
4343

44-
- `SKILL.md` - Core content (1,500-2,000 words, lean)
44+
- `SKILL.md` - Core content (1,000-2,200 words, lean)
4545
- `references/` - Detailed documentation loaded into context as needed
4646
- `examples/` - Complete working examples and templates for copy-paste
4747
- `scripts/` - Utility scripts (executable without loading into context)
@@ -91,6 +91,8 @@ Test the plugin locally:
9191
cc --plugin-dir plugins/plugin-dev
9292
```
9393

94+
**Tip**: Create a separate test repository to avoid polluting your development environment. See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed testing guidelines.
95+
9496
Utility scripts (paths relative to `plugins/plugin-dev/`):
9597

9698
```bash
@@ -126,6 +128,14 @@ markdownlint '**/*.md' --ignore node_modules --fix
126128
shellcheck plugins/plugin-dev/skills/*/scripts/*.sh
127129
```
128130

131+
**Markdownlint rules** (from `.markdownlint.json`):
132+
133+
- ATX-style headers only (`#`, not underlines)
134+
- Dash-style lists (`-`, not `*` or `+`)
135+
- Fenced code blocks (not indented)
136+
- No line length limits
137+
- Allowed HTML: `<p>`, `<img>`, `<example>`, `<commentary>`
138+
129139
## Component Patterns
130140

131141
### Agents
@@ -185,6 +195,8 @@ The primary entry point for plugin development. Presents users with a choice:
185195
1. **Create a plugin** (recommended for most users) - Routes to `/plugin-dev:create-plugin`
186196
2. **Create a marketplace** - Routes to `/plugin-dev:create-marketplace`
187197

198+
This command uses `disable-model-invocation: true` to prevent subagent model invocation, ensuring it only routes to specialized workflows rather than handling the task itself. This pattern is useful for workflow commands that delegate to other commands.
199+
188200
Use this command when starting fresh or when unsure which workflow to use.
189201

190202
### `/plugin-dev:create-plugin`
@@ -245,6 +257,32 @@ Use these agents proactively after creating components:
245257
- `sync-labels.yml` - Synchronizes repository labels
246258
- `greet.yml` - Greets new contributors
247259

260+
## Labels
261+
262+
Issues and PRs use a structured labeling system defined in `.github/labels.yml`:
263+
264+
| Category | Format | Examples |
265+
|----------|--------|----------|
266+
| Component | `component:*` | `component:skill`, `component:agent`, `component:hook`, `component:command`, `component:docs` |
267+
| Priority | `priority:*` | `priority:critical`, `priority:high`, `priority:medium`, `priority:low` |
268+
| Status | `status:*` | `status:blocked`, `status:in-progress`, `status:needs-review` |
269+
| Effort | `effort:*` | `effort:small` (<1h), `effort:medium` (1-4h), `effort:large` (>4h) |
270+
271+
The `semantic-labeler.yml` workflow auto-labels PRs based on file paths changed.
272+
273+
## Issue & PR Templates
274+
275+
The repository includes templates in `.github/`:
276+
277+
**Issue Templates** (4 types):
278+
279+
- `bug_report.yml` - Bug reports with reproduction steps
280+
- `feature_request.yml` - Feature requests with use cases
281+
- `documentation.yml` - Documentation improvements
282+
- `question.yml` - Questions and discussions
283+
284+
**Pull Request Template**: Component-specific checklists with validation requirements. See [CONTRIBUTING.md](CONTRIBUTING.md) for PR guidelines.
285+
248286
## Publishing & Version Management
249287

250288
### Version Files

CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,15 +47,15 @@ Before contributing, ensure you have:
4747
2. **Explore the architecture**:
4848
```
4949
plugins/plugin-dev/
50-
├── commands/ # 2 slash commands
50+
├── commands/ # 3 slash commands
5151
├── skills/ # 8 skills
5252
└── agents/ # 3 specialized agents
5353
```
5454

5555
3. **Understand the plugin components**:
5656
- 8 skills for different plugin development aspects
5757
- 3 agents for validation and generation
58-
- 2 guided workflow commands (`/plugin-dev:create-plugin`, `/plugin-dev:create-marketplace`)
58+
- 3 slash commands: `/plugin-dev:start` (entry point), `/plugin-dev:create-plugin`, `/plugin-dev:create-marketplace`
5959

6060
## Development Setup
6161

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ A comprehensive toolkit for developing Claude Code plugins with expert guidance
3232

3333
## Overview
3434

35-
The plugin-dev toolkit provides **8 specialized skills**, **3 validation agents**, and **2 guided workflow commands** to help you build high-quality Claude Code plugins:
35+
The plugin-dev toolkit provides **8 specialized skills**, **3 validation agents**, and **3 slash commands** to help you build high-quality Claude Code plugins:
3636

3737
- **Skills** provide domain expertise loaded on-demand via trigger phrases
3838
- **Agents** automate validation and generation tasks
@@ -106,7 +106,7 @@ Skills load automatically when you ask relevant questions. Each skill includes c
106106

107107
Each skill provides:
108108

109-
- **Core SKILL.md** (~1,500-2,000 words) - Essential API reference
109+
- **Core SKILL.md** (~1,000-2,200 words) - Essential API reference
110110
- **references/** - Detailed guides and patterns
111111
- **examples/** - Complete working code for copy-paste
112112
- **scripts/** - Validation and testing utilities

0 commit comments

Comments
 (0)