code-quality

Enforce strict code quality rules on TypeScript and JavaScript changes.

14|4|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/motlin/claude-code-plugins --skill code-quality-motlin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-quality
Source: https://github.com/motlin/claude-code-plugins/tree/main/plugins/code/skills/code-quality
Command: npx skills add https://github.com/motlin/claude-code-plugins --skill code-quality-motlin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Forgiving code, inconsistent naming, and poor file management lead to brittle, unmaintainable, and confusing codebases that are prone to bugs and difficult to collaborate on. This Skill ensures every code change meets high standards.

Core Features & Use Cases

  • Strict Code Design: Advocates against forgiving code (e.g., union types), promoting preconditions, schema validation, and immediate error throwing instead of defensive try/catch blocks.
  • Clear Naming Conventions: Enforces full, descriptive names (e.g., number instead of num) to enhance code readability.
  • Efficient File Management: Prioritizes editing existing files over creating new ones and requires user confirmation for new Markdown files.
  • Expressive Style: Encourages the use of emojis and unicode characters in comments, commit messages, and documentation headers for clarity and engagement.
  • Use Case: Before making any code changes or reviewing a pull request, use this skill to automatically check and enforce adherence to strict code quality guidelines, preventing future bugs and improving overall code health.

Quick Start

Review the user-service.ts file for code quality issues, focusing on naming conventions and forgiving code.

Frequently Asked Questions about code-quality

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce strict code quality standards across TypeScript and JavaScript projects?

Enforce code quality by applying schema validation to inputs, throwing errors on violations instead of logging, avoiding union types, and eliminating defensive try/catch blocks. This ensures consistent, maintainable code across all changes and CI pipelines.

What naming conventions should I follow to improve code readability?

Use full, descriptive names instead of abbreviations—for example, write `number` rather than `num`. Clear naming conventions reduce confusion, enhance maintainability, and make code easier to collaborate on across teams.

How do I eliminate forgiving code paths and improve error handling?

Replace defensive try/catch blocks and forgiving logic with strict input validation using schema libraries and immediate error throwing when expectations are violated. This prevents bugs and makes failure modes explicit.

What's the best way to manage files during code changes?

Prioritize editing existing files over creating new ones, and require user confirmation before generating new markdown files. This prevents file sprawl and keeps the codebase organized and maintainable.

Can I use emojis and special characters in code comments and documentation?

Yes, emojis and unicode characters are encouraged in comments, commit messages, and documentation headers to enhance clarity and engagement while maintaining code professionalism.

When should I apply code quality checks in my development workflow?

Apply code quality enforcement before making changes or during pull request review to automatically check adherence to strict guidelines, preventing bugs and improving overall code health early.