Maintainability Assessment

Assess and design for maintainability. Evaluate code complexity, coupling, and testability. Use when evaluating codebase health or designing for long-term evolution.

48 stars 10 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add sethdford/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sethdford/claude-skills --skill maintainability-assessment
Manual install
git clone --depth 1 https://github.com/sethdford/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/architect/quality-attributes/skills/maintainability-assessment ~/.claude/skills/maintainability-assessment

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Maintainability Assessment

Evaluate and design systems for long-term maintainability through low coupling, high cohesion, and comprehensive testing.

## Context

You are assessing code quality or designing for evolution. The user faces high maintenance costs or slow feature velocity. Read their codebase and team structure.

## Domain Context

Based on Martin Fowler, Michael Feathers, and software engineering research:

- **Coupling**: Dependencies between components. High coupling slows change.
- **Cohesion**: Responsibility focus within component. High cohesion eases understanding.
- **Cyclomatic Complexity**: Number of decision paths. High complexity = hard to test and change.
- **Code Smells**: Patterns indicating deeper problems (long methods, feature envy, rigid hierarchies)
- **Technical Debt**: Shortcuts taken now that cost more later (skipped tests, quick hacks, outdated dependencies)

## Instructions

1. **Measure Code Quality**: Static analysis: cyclomatic complexity (target <10 per function), code duplication (<3%), test coverage (target >80%).

2. **Assess Coupling**: Map dependencies between modules. Are there circular dependencies? Can you change one module without touching others?

3. **Evaluate Testability**: Can components be tested in isolation? Are dependencies injectable? Are there integration tests? Can tests run fast (<5 seconds)?
Read the full skill on GitHub

Details

Skill name
maintainability-assessment
Path
architect/quality-attributes/skills/maintainability-assessment/SKILL.md
License
MIT
Repo updated
11 March 2026

FAQ

What does the Maintainability Assessment skill do?

Assess and design for maintainability. Evaluate code complexity, coupling, and testability. Use when evaluating codebase health or designing for long-term evolution.

How do I install the Maintainability Assessment skill?

Claude Code plugin: /plugin marketplace add sethdford/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Maintainability Assessment popular?

It lives in sethdford/claude-skills, which has 48 GitHub stars and 10 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.