/code-quality

Code quality practices, linting, and refactoring

Boost this skill

fujigo-software@fujigo-software

GitHub

From plugin

f5-framework

2434 skills104 agents69 commands

Install

$ npx -y skills add Fujigo-Software/f5-framework-claude --skill code-quality --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/code-quality

Context preview

The summary Claude sees to decide when to auto-load this skill.

Code quality practices, linting, and refactoring

SKILL.md

code-quality.SKILL.md

name: code-quality
description: Code quality practices, linting, and refactoring
category: skill
allowed-tools: Read, Write, Glob, Grep, Bash
user-invocable: true
context: inject
version: 1.0.0

Code Quality Skills

Overview

Code quality practices for writing clean, maintainable, and reliable code. These skills cover linting, static analysis, refactoring, naming conventions, documentation, and best practices.

Quality Metrics

| Metric | Good | Warning | Bad | |--------|------|---------|-----| | Cyclomatic Complexity | < 10 | 10-20 | > 20 | | Function Length | < 20 lines | 20-50 | > 50 | | File Length | < 300 lines | 300-500 | > 500 | | Nesting Depth | < 3 | 3-4 | > 4 | | Code Coverage | > 80% | 60-80% | < 60% | | Duplicate Code | < 3% | 3-5% | > 5% | | Technical Debt Ratio | < 5% | 5-10% | > 10% |

Linting

Automated code style enforcement and error detection:

**ESLint** - JavaScript/TypeScript linting
**Prettier** - Code formatting
**Stylelint** - CSS/SCSS linting
**lint-staged** - Pre-commit linting

Static Analysis

Deep code analysis beyond linting:

**TypeScript Strict Mode** - Maximum type safety
**SonarQube** - Comprehensive analysis platform
**Code Coverage** - Test coverage metrics

Refactoring

Code improvement techniques:

**Code Smells** - Identifying problematic patterns
**Refactoring Techniques** - Systematic improvements
**Extract Method** - Breaking down functions
**When to Refactor** - Decision framework

Naming

Clear and consistent naming:

**Naming Conventions** - Project-wide standards
**Variable Naming** - Descriptive identifiers
**Function Naming** - Action-oriented names

Documentation

In-code documentation:

**Code Comments** - When and how to comment
**JSDoc/TSDoc** - Type documentation
**README Standards** - Project documentation

Practices

Development best practices:

**Clean Code Principles** - Foundational concepts
**Code Review Checklist** - Review guidelines
**Technical Debt** - Managing and reducing debt
**Boy Scout Rule** - Continuous improvement

Quality Gates Integration

# .f5/quality/code-quality-gate.yaml
code_quality_gate:
  name: "Code Quality Standards"
  metrics:
    lint_errors: 0
    lint_warnings: 10
    complexity_max: 15
    coverage_min: 80
    duplication_max: 3

  checks:
    - eslint --max-warnings 0
    - tsc --noEmit
    - jest --coverage --coverageThreshold='{"global":{"lines":80}}'

Tool Stack

| Tool | Purpose | Configuration | |------|---------|---------------| | ESLint | Linting | `eslint.config.js` | | Prettier | Formatting | `.prettierrc` | | TypeScript | Type checking | `tsconfig.json` | | Jest | Testing/Coverage | `jest.config.js` | | Husky | Git hooks | `.husky/` | | lint-staged | Pre-commit | `package.json` |

Quick Setup

# Install core tools
npm install -D eslint prettier typescript @typescript-eslint/parser @typescript-eslint/eslint-plugin

# Install formatting
npm install -D eslint-config-prettier eslint-plugin-prettier

# Install git hooks
npm install -D husky lint-staged
npx husky init

# Configure lint-staged
npm pkg set lint-staged='{"*.{ts,tsx}":["eslint --fix","prettier --write"]}'