Human Maintainability

Assess a programming project's HUMAN maintainability (HMAP): 0-100 score, nine-tier verdict, per-dimension scores, and file:line evidence — built to catch vibe-coding / AI-generated slop, including semantic incoherence (name/contract/concept/vocabulary drift). Triggers: assess maintainability / rate this project / code quality score / readability score / AI slop detection / vibe coding check / semantic consistency check / HMAP / human maintainability / 评估项目可维护性 / 给项目打分 / 代码质量评估 / 可读性评分 / AI屎山检测 / vibe coding 体检 / 是否适合人类维护 / 语义一致性. Anti-trigger: the user asks to fix, refactor, optimize, or writ

5 starsAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add hmr-BH/HMAP --skill human-maintainability

Manual install

git clone --depth 1 https://github.com/hmr-BH/HMAP.git /tmp/HMAP
mkdir -p ~/.claude/skills
cp -r /tmp/HMAP/. ~/.claude/skills/human-maintainability

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

From the SKILL.md

# human-maintainability (HMAP)

Human Maintainability Assessment of Programming Projects — scores whether a project is maintainable by **human programmers** (0-100, nine tiers), with dedicated forensics for vibe-coding / AI-generated slop.

**Core principle: assess only, never modify.** No refactoring, no bug fixes, no touching source files; findings go into the report, period.

## Trigger / anti-trigger

- **Trigger**: the user asks to "assess maintainability / score this project / check for AI slop / rate code quality / is it human-maintainable" for any path, with the target given or inferable.
- **Anti-trigger**: the user wants bugs fixed, refactoring, features, or performance work — do NOT apply this skill. If asked to "assess then fix", finish the assessment first; handle fixes only under a new instruction.

## Scoring model (4 weighted dimensions, 100 max)

> **Read before scoring**: this is a **human readability & maintainability** assessment, not a style-compliance review — comment coverage, naming consistency, DRY and similar "standards" earn no points by themselves, only when they serve human understanding and maintenance. **Core question**: after reading the code, ask yourself "if this project were handed to you, would you maintain it yourself? Why?" The total score must agree with the answer.
>

Read the full skill on GitHub

Details

Skill name: human-maintainability
Repository: hmr-BH/HMAP
License: MIT
Repo updated: 12 August 2026

FAQ

What does the Human Maintainability skill do?

How do I install the Human Maintainability skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add hmr-BH/HMAP --skill human-maintainability. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Human Maintainability popular?

It lives in hmr-BH/HMAP, which has 5 GitHub stars and 0 forks.

Related skills

Industrial Waste Heat Recovery

dungnotnull/industrial-waste-heat-recovery-agent-skill

Industrial Waste-Heat Recovery System Design — Production-grade evidence-backed analysis harness with flexible agent architecture, skill registry, and modular sub-agents. Use for: waste-heat recovery design, heat exchanger selection, ORC systems, pinch analysis, energy efficiency assessment, industrial thermal system optimization. Triggers on: "waste heat", "heat recovery", "ORC", "pinch analysis", "heat exchanger", "energy efficiency", "thermal optimization", "industrial heat", "steam system", "condensate recovery".

AI, LLMs & Agents

Goodcode

SpinaBuilds/goodcode

Host-agnostic exhaustive multi-agent orchestration for any coding agent that can spawn subagents (Claude Code, Codex, Cursor, OpenCode, OpenHands, …). Pipeline: recon → cheap baseline → a-priori specialist roles cast by routing → parallel fan-out → adversarial verification → loop-until-dry → dedup/score/synthesize. Optimizes for the most exhaustive, correct answer — not the fastest or cheapest. Use for audits, deep reviews, multi-source research, design exploration, large migrations, or any substantial task where completeness beats latency. Triggers: '/goodcode', 'goodcode', 'orchestrate exhau

AI, LLMs & Agents

Ml Architecture Diagram

Ztsdut/ml-architecture-diagram-skill

Create accurate, publication-ready, editable machine-learning and deep-learning architecture diagrams from model code, configuration files, model summaries, graph exports, or written specifications. Use for neural-network figures, architecture schematics, model block diagrams, training/inference diagrams, paper figures, and editable SVG/draw.io/PPTX outputs. Recover the real computation graph first, compress unimportant implementation detail, emphasize the scientific contribution, and never invent modules for aesthetics.

AI, LLMs & Agents

Game Architect

rhino-ty/game-architect

End-to-end indie game design AI skill — system mechanics, numeric balancing, GDD writing, narrative design, platform fit analysis, engine selection (Unity/ Godot/Unreal), audio strategy, indie marketing, post-launch operations, procedural generation, and Claude Code project document scaffolding. Acts as "The Architect": a 15-year senior game system designer persona tuned for solo and small indie teams targeting Steam, console, and mobile. ALWAYS use this skill when the user mentions making, designing, balancing, shipping, or operating a game — even if they don't say "game design" explicitly. T

AI, LLMs & Agents

No AI Tone

mckenizemanfull5678-ctrl/no-ai-tone

中文长文写作五步管线：把杂乱素材整理成一篇读起来「不像 AI 写的」文章。当用户要写公众号 / 知乎 / 博客等中文长文，要把素材·笔记·链接整理成稿，抱怨 AI 写的东西有「AI 腔 / AI 味」，或想给一篇已有文章去 AI 腔、提炼金句、规划配图时使用。主线五步写作 + 配图落地：选题研判 → 内容线设计 → 大纲打磨 → 风格化初稿 → 双重精修（去 AI 腔 + 金句提炼） → 配图落地（信息图为主、配图也去 AI 味）。核心心法是「人决策、AI 执行」——每一步产出后停下来等用户拍板，绝不一口气跑完。

AI, LLMs & Agents

Dspy Rb

vicentereig/dspy-rb-skill

Build type-safe LLM applications with DSPy.rb - Ruby's programmatic prompt framework with signatures, modules, agents, and optimization

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.