code-qualities-assessment

code-qualities-assessment is a skill for Claude Code from rjmurillo/ai-agents. It costs 108 tokens per session (3,844 once invoked), scanned A, original, MIT.

A maintainability assessment for code based on cohesion, coupling, encapsulation, testability, and non-redundancy. It scores methods, classes, or modules and produces reports with suggested improvements.

In plain words
What is it for?
Use it to assess code quality, review changed files, evaluate maintainability, and create Markdown, JSON, or HTML assessment reports.
Why use it?
It gives a structured way to find design problems that make code harder to change, test, or understand.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: reads .claude/ paths.

Part of the project-toolkit plugin — 95 skills, 26 commands, 33 agents, 4 hooks shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/rjmurillo/ai-agents/code-qualities-assessment
Any agent
npx skills add rjmurillo/ai-agents --skill code-qualities-assessment
Clone the repo
git clone --depth 1 https://github.com/rjmurillo/ai-agents

Made for: Claude Code.

Or install project-toolkit, the plugin that ships this one along with the rest of its 95 skills, 26 commands, 33 agents, 4 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for code-qualities-assessment

README.md
[![agentmods](https://agentmods.dev/badge/skills/rjmurillo/ai-agents/code-qualities-assessment.svg)](https://agentmods.dev/skills/rjmurillo/ai-agents/code-qualities-assessment)
Your own site
<a href="https://agentmods.dev/skills/rjmurillo/ai-agents/code-qualities-assessment"><img src="https://agentmods.dev/badge/skills/rjmurillo/ai-agents/code-qualities-assessment.svg" alt="Measured on agentmods" height="20"></a>
Per session 108 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,844 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00108 $0.03844
Opus 5 $0.00054 $0.01922
Sonnet 5 $0.00022 $0.00769
Haiku 4.5 $0.00011 $0.00384

Measured 2d ago against content hash 92c1271c4a97, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

code-qualities-assessment scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/assess.py, tests/test_assess.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/code-qualities-assessment/SKILL.md · 490 lines

How it starts

The opening of the file, as written. The whole thing — 490 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Code Qualities Assessment

Evaluate code maintainability using 5 timeless design qualities with quantifiable scoring rubrics.

Triggers

  • assess code quality
  • evaluate maintainability
  • check code qualities
  • testability review
  • run quality assessment

Quick Start

# Assess a single file
python3 scripts/assess.py --target src/services/auth.py

# Assess changed files from the PR base (CI mode)
python3 scripts/assess.py --target . --changed-only --base origin/main --format json

# Full module assessment with HTML report
python3 scripts/assess.py --target src/services/ --format html --output quality-report.html

Scripts

Script Purpose Usage
scripts/assess.py Scores target code across the five quality axes. python3 scripts/assess.py --target <path> --format markdown

Use --changed-only for diff-scoped checks and --format json for automation.


The 5 Code Qualities

Quality Question Score 10 Score 1-3
Cohesion How related are responsibilities? Single, well-defined responsibility Unrelated responsibilities jammed together
Coupling How dependent on other code? Minimal deps, depends on abstractions Tightly coupled, hard-coded dependencies
Encapsulation How well are internals hidden? All internals private, minimal API Everything public, no information hiding
Testability How easily verified in isolation? Pure functions, injected dependencies Hard to test, requires full integration
Non-Redundancy How unique is each piece of knowledge? Zero duplication, appropriate abstractions Pervasive copy-paste

When to Use

Use this skill when:

  • Reviewing code quality before merge
  • Identifying refactoring priorities
  • Establishing quality baselines
  • Teaching code design principles
  • Tracking quality trends over time
  • Enforcing quality gates in CI

Read the full file on GitHub · 490 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 490 lines · 108 tokens per session scan A 92c1271c4a97

Subscribe to this mod's changes

code-qualities-assessment is a skill published in the GitHub repository rjmurillo/ai-agents (45 stars, last pushed yesterday), licensed MIT. It adds 108 tokens to every session and 3,844 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

ci-cd-pipeline-builder

../../../engineering/skills/ci-cd-pipeline-builder/SKILL.md.

alirezarezvani/claude-skills · 0 tokens

test-generator

Automatically suggest tests for new functions and components. Use when new code is written, functions added, or user mentions testing. Creates test scaffolding with Jest, Vitest, Pytest patterns. Triggers on new functions, components, test requests, testing mentions.

alirezarezvani/claude-code-tresor · 55 tokens

azure-deployment-operations

Production deployment patterns for Azure Static Web Apps, Container Apps, App Service, and infrastructure.

fabioc-aloha/Alex_Skill_Mall · 23 tokens

azure-devops-automation

CI/CD pipelines, infrastructure as code, and deployment automation for Azure workloads.

fabioc-aloha/Alex_Skill_Mall · 20 tokens

repository-readiness-eval

Evaluate a repository's readiness for AI-assisted development across 4 axes: code understanding, dependency restore, build success, and test execution. Use when onboarding to a new repo, assessing CI readiness, or validating that an AI agent can work effectively in a codebase.

fabioc-aloha/Alex_Skill_Mall · 59 tokens

test-quality-analysis

Analyze test code quality to detect coverage-only tests, test smells, and low-value assertions. Use when asked to "analyze test quality", "find coverage-only tests", "audit our tests", "are these tests valuable", "find test smells", or "which tests should we delete". Scores tests 1-5 on real value and produces…

fabioc-aloha/Alex_Skill_Mall · 77 tokens