Analyzes SKILL.md files, plugin prompts, and command instructions; scores clarity, safety, effectiveness, completeness, conciseness; provides rewrites and edits.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin severity1-marketplaceThis skill is limited to using the following tools:
This skill automatically analyzes and improves plugin prompts, SKILL.md files, command definitions, and agent instructions.
Maintains Claude Code plugins through domain analysis, structure review, behavioral testing, and quality fixes for skills, commands, agents, hooks, and reference sheets. Use when enhancing existing packs.
Audits Claude skills against Anthropic prompting best practices including positive framing, motivation, and XML structure. Use after creation/modification, before release, or for inconsistent results.
Refines and validates existing Claude Code skills for clarity, efficiency, and production readiness. Use for improving structure, best practices, token reduction, and production checks.
Share bugs, ideas, or general feedback.
This skill automatically analyzes and improves plugin prompts, SKILL.md files, command definitions, and agent instructions.
The prompt-improver skill evaluates plugin content across five dimensions — clarity, safety, effectiveness, completeness, and conciseness — then provides scored assessments and concrete rewrites.
This skill activates when you need to:
## Prompt Analysis: [filename]
### Scores
| Dimension | Score | Notes |
|-----------|-------|-------|
| Clarity | X/5 | ... |
| Safety | X/5 | ... |
| Effectiveness | X/5 | ... |
| Completeness | X/5 | ... |
| Conciseness | X/5 | ... |
**Overall: X/25**
### Improvements
1. [Specific improvement with before/after]
### Suggested Rewrite
[Full improved prompt text]
Before:
description: Does stuff with code
After:
description: |
Analyze source code for common anti-patterns and suggest refactoring improvements. Use when the user asks to "review code quality", "find code smells", or "refactor this file".
Before:
Delete all temporary files from the project.
After:
Identify temporary files (*.tmp, *.bak, *.swp) in the project. List them for user confirmation before deletion. Never delete files outside the project root.
.claude-plugin/plugin.json for contextThe skill produces a structured analysis report containing:
| Error | Cause | Resolution |
|---|---|---|
| No SKILL.md found | Target path has no skill files | Verify the plugin path and check for skills/*/SKILL.md |
| Invalid frontmatter | YAML parsing failure in target file | Report the specific YAML error and suggest corrections |
| Empty skill body | File has frontmatter but no instructions | Flag as critical and generate a starter template |