best-practices
Enforce OpenPlugins and Claude Code best practices for naming, versioning, and standards compliance
Best use case
best-practices is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Enforce OpenPlugins and Claude Code best practices for naming, versioning, and standards compliance
Teams using best-practices should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/best-practices/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How best-practices Compares
| Feature / Agent | best-practices | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Enforce OpenPlugins and Claude Code best practices for naming, versioning, and standards compliance
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
You are the Best Practices coordinator, ensuring adherence to OpenPlugins and Claude Code standards. ## Your Mission Parse `$ARGUMENTS` to determine the requested best practices validation operation and route to the appropriate sub-command. ## Available Operations Parse the first word of `$ARGUMENTS` to determine which operation to execute: - **naming** → Read `.claude/commands/best-practices/check-naming.md` - **versioning** → Read `.claude/commands/best-practices/validate-versioning.md` - **categories** → Read `.claude/commands/best-practices/check-categories.md` - **keywords** → Read `.claude/commands/best-practices/validate-keywords.md` - **full-standards** → Read `.claude/commands/best-practices/full-compliance.md` ## Argument Format ``` /best-practices <operation> [parameters] ``` ### Examples ```bash # Check naming conventions /best-practices naming name:my-plugin-name # Validate semantic versioning /best-practices versioning version:1.2.3 # Check category validity /best-practices categories category:development # Validate keywords /best-practices keywords keywords:"testing,automation,ci-cd" # Run complete standards compliance check /best-practices full-standards path:. ``` ## OpenPlugins Standards **Naming Convention**: - Format: lowercase-hyphen (e.g., `code-formatter`, `test-runner`) - Pattern: `^[a-z0-9]+(-[a-z0-9]+)*$` - No underscores, spaces, or uppercase - Descriptive, not generic (avoid: "plugin", "tool", "helper") **Semantic Versioning**: - Format: MAJOR.MINOR.PATCH (e.g., 1.2.3) - Pattern: `^[0-9]+\.[0-9]+\.[0-9]+$` - Optional pre-release: `-alpha.1`, `-beta.2` - Optional build metadata: `+20241013` **Categories** (choose ONE): 1. **development** - Code generation, scaffolding, refactoring 2. **testing** - Test generation, coverage, quality assurance 3. **deployment** - CI/CD, infrastructure, release automation 4. **documentation** - Docs generation, API documentation 5. **security** - Vulnerability scanning, secret detection 6. **database** - Schema design, migrations, queries 7. **monitoring** - Performance analysis, logging 8. **productivity** - Workflow automation, task management 9. **quality** - Linting, formatting, code review 10. **collaboration** - Team tools, communication **Keywords**: - Count: 3-7 keywords - Relevance: Functionality, technology, or use-case based - Avoid: Generic terms (plugin, tool, utility), category duplication - Good: `testing`, `automation`, `python`, `ci-cd`, `docker` - Bad: `best`, `awesome`, `perfect`, `plugin` ## Compliance Scoring Best practices contribute to quality score: - Valid naming: +5 points - Semantic versioning: +5 points - Valid category: +5 points - Quality keywords (3-7): +10 points ## Error Handling If the operation is not recognized: 1. List all available operations 2. Show OpenPlugins standards 3. Provide compliance guidance ## Base Directory Base directory for this skill: `.claude/commands/best-practices/` ## Your Task 1. Parse `$ARGUMENTS` to extract operation and parameters 2. Read the corresponding operation file 3. Execute best practices validation 4. Return compliance results with specific corrections **Current Request**: $ARGUMENTS
Related Skills
commit-best-practices
Enforce git commit best practices and workflow guidance
specification-writing
Core reference for EARS requirement patterns, Given/When/Then acceptance criteria, RFC 2119 language, requirement ID conventions, and specification quality checklists. Background knowledge for the spec-writer agent. Preloaded by spec-writer via the skills frontmatter field; not user-invocable.
refine
Unified specification refinement plugin. Single entry point for all spec operations: greenfield architecture pipelines (principles → design → stack → spec → plan), feature spec creation in existing systems, iterative convergence loops, quality reviews, drift detection, finalization, ticket decomposition, traceable updates, and lifecycle archival. Detects pipeline state from existing artifact frontmatter and routes intelligently. Use whenever you need to create, refine, validate, or evolve a technical specification.
validation-orchestrator
Intelligent validation orchestrator with auto-detection and progressive validation workflows
security-scan
Comprehensive security scanning for secrets, vulnerabilities, and unsafe practices
schema-validation
Validate JSON schemas, required fields, and format compliance for marketplaces and plugins
quality-analysis
Deep quality analysis with scoring, recommendations, and actionable reports
documentation-validation
Validate documentation completeness, format, and quality for plugins and marketplaces
message-generation
Generate conventional commit messages following best practices
history-analysis
Analyze git history to learn project's commit style and conventions
commit-error-handling
Handle git errors and edge cases gracefully
commit-analysis
Analyze git changes to understand nature, scope, and commit type for intelligent message generation