mindbox-cloud/agent-skills / plugins/skill-review/skills/skill-review
skill-review
VerifiedQuick and accessible AI reviewer for Agent Skills — for non-specialists. Checks structure, workflow, references, and links. Produces a clear report without technical jargon. Summary from Exhausted Vitaly. Use when user says "quick review", "basic skill check", "review my skill", "review for product owner", "light review", "quick check", "check my skill", "evaluate skill quality", "what's wrong with my skill", "review this skill". Don't use when: user asks for a deep/nightmare review (use skill-review-nightmare), user asks to create a new skill, to review code, user asks to review a prompt that is not a skill.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 22.0 KB |
| references/antipattern-bingo.md | markdown | 6.7 KB |
| references/checklist-lifecycle.md | markdown | 2.6 KB |
| references/checklist-links.md | markdown | 2.6 KB |
| references/checklist-references.md | markdown | 6.2 KB |
| references/checklist-structure.md | markdown | 5.8 KB |
| references/checklist-workflow.md | markdown | 14.1 KB |
| references/instruction-singlepass.md | markdown | 35.5 KB |
| references/maturity-diagnostic.md | markdown | 1.7 KB |
| references/report-template.md | markdown | 6.1 KB |
| references/subagent-base-rules.md | markdown | 2.4 KB |
references/maturity-diagnostic.md
View on GitHub# Maturity Stage Legend
> Reference for Exhausted Vitaly's contextual comments. Novice **does not compute** the maturity stage and does not determine the "actual stage" of a skill. This file is only for Exhausted Vitaly to contextualize findings relative to the user's declared goal.
---
## Stages
| Stage | Question | Value | Key Limitation |
|:---|:---|:---|:---|
| **1. Auto-generated** | Is this not garbage? | ~0: the model paraphrases what it already "knows" | Self-generated skills provide no improvement (SkillsBench) |
| **2. Personal skill** | Does the skill work for the author? | Captures one working path, reduces stochastic variance | Tied to the author's machine, permissions, data, and habits |
| **3. Team skill** | Can a colleague find, understand, and run it? | Portability, discoverability, stable navigation | No lifecycle artifacts, not embedded in an ecosystem |
| **4. Repository skill** | Does the skill live in an ecosystem and not rot? | Ownership, versioning, routing, lifecycle hygiene | Requires time investment; justified for skill collections |
---
## Practical Notes
- **Stage 2 — Personal skill.** Captures a working path and removes stochastic variance. Sufficient if the skill is only for you.
- **Stage 3 — Team skill.** A colleague can find, understand, and run it without verbal explanation. The main stage 2 danger is hidden coupling to the author's machine.
- **Stage 4 — Repository skill.** Owner, version, changelog, place in the ecosystem. The skill outlives its author. Changelogs and version headers matter here — they track modification history and make continuous support possible without depending on the original author's memory.
- **Important:** not every skill needs to be stage 4. A personal template is fine at stage 2.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |