Skip to content
CAI
Software that uses CAICheck a score

luongnv89/claude-howto

42.6

Weak · 15 November 2026

7.2k

lines of production code

Python

with JavaScript

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add code refactoring skill with complexity and smell detection scripts

The \03-skills/refactor\ directory now includes Python scripts to support code refactoring based on Martin Fowler's methodology. \analyze-complexity.py\ calculates metrics such as cyclomatic and cognitive complexity, maintainability index, and function counts for Python, JavaScript, and TypeScript files. \detect-smells.py\ identifies common code smells including long methods, long parameter lists, duplicate code, large classes, dead code, complex conditionals, magic numbers, feature envy, and deeply nested code. A Ukrainian localization of the complexity analyzer is also added under \uk/03-skills/refactor/scripts/\.

python · high confidence

Japanese (ja) translation added

Added Japanese translations for issue templates, security reporting, testing guidelines, pull request templates, slash command documentation, memory guides, agent skills documentation, and several built-in skills (blog-draft, brand-voice, claude-md). Also in this area: 3 commits (2 fixes) fixing ja, uk, vi; Claude Code documentation updated to v2.1.302 with significant feature and configuration changes; Claude Code v2.1.300 documentation sync.

ja · medium confidence · unverified

New DevOps Automation plugin for Kubernetes deployment and health monitoring

This location introduces a new DevOps automation plugin that provides scripts and hooks for managing Kubernetes deployments. It includes pre-deployment checks (validating kubectl and cluster connectivity), post-deployment hooks (waiting for pod readiness), and shell scripts for deploying to environments, performing health checks on APIs and databases, and rolling back deployments. The plugin also adds an MCP configuration for the Kubernetes server and updates agent tool definitions to use capitalized names (e.g., 'Read' instead of 'read'). Also in this area: 3 commits (2 fixes) fixing ja, uk, vi.

vi/07-plugins/devops-automation · medium confidence · unverified

New EPUB and static website generation tools with local diagram rendering

Users can now generate a static website and an EPUB guide from the repository's Markdown sources using new Python scripts (\build\_website.py\ and \build\_epub.py\). The EPUB builder embeds Mermaid diagrams as flattened SVG images using a locally cached, checksum-verified 'Pele' bundle, ensuring compatibility with EPUB readers that lack CSS custom property support. The website builder produces a responsive, self-hosted site with light/dark themes and renders diagrams in the browser using the same Pele bundle. Validation scripts (\check\_mermaid.py\ and \check\_epub\_diagrams.py\) are included to verify diagram syntax and EPUB integrity.

claude-howto · high confidence

New Vietnamese documentation for advanced Claude Code features

Added a new Vietnamese (Tiếng Việt) translation of the advanced features guide, including the main README, planning mode examples, configuration examples, and a Python script for setting up auto-mode permissions. This provides Vietnamese-speaking users with localized documentation for capabilities such as planning mode, extended thinking, permission modes, and configuration management. Also in this area: 3 commits (2 fixes) fixing ja, uk, vi; Claude Code documentation updated to v2.1.302 with significant feature and configuration changes; Claude Code v2.1.300 documentation sync.

vi/09-advanced-features · medium confidence · unverified

New advanced features documentation and auto-mode permission setup tool

This location introduces comprehensive documentation for Claude Code's advanced capabilities, including planning mode, extended thinking, auto mode, background tasks, permission modes, and session management, alongside example configurations for various development workflows. It also adds a Python script that seeds a conservative, read-only permission baseline for auto mode, with optional flags to widen access for editing, testing, git operations, and package management.

09-advanced-features · high confidence

New build, validation, and localization tooling in scripts/

The scripts directory now includes a suite of Python tools to generate and validate the documentation site. The EPUB builder (build\_epub.py) and static website builder (build\_website.py) convert markdown sources into distributable formats, with the website builder supporting multiple languages (en, vi, zh, ja, uk) and self-hosting assets like Tailwind CSS and Mermaid JS to remove external runtime dependencies. Quality is enforced by new validation scripts: check\_cross\_references.py ensures internal links and anchors stay within the repo root, check\_links.py verifies external URLs, check\_markdown\_rendering.py catches structural markdown errors (like unescaped pipes or stray placeholders), and check\_mermaid.py validates diagram syntax. Additionally, sync\_translations.py helps track outdated Vietnamese translations, and vendor\_assets.py manages the caching and self-hosting of third-party libraries.

scripts · high confidence

New hook examples for security, formatting, and context tracking

The 06-hooks directory now includes a comprehensive set of example scripts demonstrating practical hook usage. These include a pre-tool safety check (pre-tool-check.sh) that blocks destructive commands and logs warnings, a security scanner (security-scan.sh) that detects hardcoded secrets and API keys, and a dependency vulnerability checker (dependency-check.sh) that scans manifest files using tools like npm audit and pip-audit. Additional examples cover automatic code formatting (format-code.sh), bash command logging (log-bash.sh), team notifications (notify-team.sh), and pre-commit testing (pre-commit.sh). The directory also introduces two context usage trackers (context-tracker.py and context-tracker-tiktoken.py) for monitoring token consumption, and a session-end progress logger (session-end.sh) for tracking learning modules.

06-hooks · high confidence

New local progress tracking UI

Added a new local progress tracking interface that displays learning modules with completion status, progress bars, and interactive expandable sections for detailed item views.

local-progress · high confidence

New static website templates for the Claude How-To landing page and documentation

The \scripts/website\_templates\ directory now contains the core assets for generating the static site, including a new landing page (\landing.html.j2\, \landing.css\, \landing.js\) with an interactive learning roadmap and dark/light theme support, a reusable documentation page template (\page.html.j2\) with sidebar navigation and Mermaid diagram styling, and the necessary Tailwind configuration (\tailwind.config.js\, \tailwind.input.css\) and site-specific styles (\site.css\). A \roadmap.json\ file defines the structured learning path data used by the landing page. Also in this area: 2 commits (0 fixes) modifying scripts; Mermaid diagram rendering switches from mmdc to Pele.

_scripts/website\templates · medium confidence · unverified

Ukrainian localization for Claude Code documentation and skills

Added Ukrainian translations for the Claude Code documentation and agent skills, including slash commands, memory management, and skill definitions. This enables users to interact with and understand the tool's features in Ukrainian.

uk · high confidence

Vietnamese localization for Hooks documentation and example scripts

This change adds Vietnamese (Tiếng Việt) translations for the Hooks module, including a new README (\vi/06-hooks/README.md\) that documents hook configuration, types (command, HTTP, MCP tool, prompt, agent), and events, alongside a suite of example scripts (\context-tracker.py\, \context-tracker-tiktoken.py\, \format-code.sh\, \log-bash.sh\, \notify-team.sh\, \pre-commit.sh\, \security-scan.sh\, \validate-prompt.sh\) translated into Vietnamese to demonstrate practical hook usage. Also in this area: 3 commits (2 fixes) fixing ja, uk, vi; Claude Code documentation updated to v2.1.302 with significant feature and configuration changes; Claude Code v2.1.300 documentation sync.

vi/06-hooks · medium confidence · unverified

Behavioural changes

1 commit (0 fixes) modifying 07-plugins/devops-automation/scripts

A change to existing behaviour in 07-plugins/devops-automation/scripts — 1 commit, 3 files: “refactor: Reorganize repository structure for optimal learning path”.

07-plugins/devops-automation/scripts · medium confidence · unverified

2 commits (1 fix) modifying 07-plugins

A change to existing behaviour in 07-plugins — 2 commits (1 fix), 12 files: “fix(plugins): make the example plugins load their commands, hooks and MCP servers (\#265)”; “docs: sync to Claude Code v2.1.323 (\#273)” (refs \#265, \#273). Also in this area: New DevOps Automation plugin for deployment and incident response.

07-plugins/devops-automation/hooks, 07-plugins/pr-review/hooks · medium confidence · unverified

3 commits (0 fixes) modifying 06-plugins

A change to existing behaviour in 06-plugins — 3 commits, 8 files: “docs: Add project logo to all README files”; “Update all concept README files with comprehensive documentation”; “Initial commit: Claude How To project”.

06-plugins · medium confidence · unverified

Code Review Specialist skill restructured with new templates and metrics scripts

The Code Review Specialist skill has been moved to a new location (03-skills/code-review-specialist) and updated to align with Claude Code v2.1.220. The skill now explicitly references and utilizes new supporting files: a structured review checklist (templates/review-checklist.md), a standardized finding template (templates/finding-template.md), and two Python scripts for quantitative analysis (scripts/analyze-metrics.py and scripts/compare-complexity.py). These scripts calculate code metrics like function/class counts and complexity scores, and compare complexity between code versions to aid in refactoring reviews. The skill description and trigger conditions have been broadened to include security analysis and performance optimization mentions. The underlying Python scripts have also been refactored to use double quotes and modern type hinting (dict instead of Dict).

03-skills/code-review-specialist · high confidence

Doc-generator skill updated for Claude Code v2.1.220 and restructured

The doc-generator skill has been moved to the 03-skills directory and updated to align with Claude Code v2.1.220. The skill metadata now includes specific compatible models (Claude Fable 5, Opus 5, Sonnet 5, etc.) and a last-updated date. The underlying Python script has been refactored to use modern Python typing (list\[dict\] instead of List\[Dict\]), removed unused imports (json, typing), and standardized string quotes to double quotes.

03-skills/doc-generator · high confidence

Fixes

3 commits (2 fixes) fixing ja, uk, vi

A fix in ja, uk, vi — 3 commits (2 fixs), 65 files: “fix(plugins): make the example plugins load their commands, hooks and MCP servers (\#265)”; “docs: sync to Claude Code v2.1.323 (\#273)”; “fix(hooks): harden hook templates and the auto-mode baseline (\#263)” (refs \#265, \#273, \#263). Also in this area: PR Review plugin updated for Claude Code v2.1+ with corrected tooling.

vi/07-plugins/pr-review/hooks · medium confidence · unverified

Test coverage

Added test coverage for EPUB builder, static website generator, and documentation validation scripts

This change introduces a new test suite in the \scripts/tests\ directory to verify the correctness of the project's build and validation tooling. The tests cover the EPUB builder (\test\_build\_epub.py\), validating build state, configuration defaults, input validation, and Mermaid diagram processing. They also cover the static website generator (\test\_build\_website.py\), ensuring correct URL mapping, link rewriting, and exclusion of internal or temporary files. Additionally, tests are added for the cross-reference checker (\test\_check\_cross\_references.py\) to ensure it correctly handles repo-root boundaries and missing files, and for the markdown rendering validator (\test\_check\_markdown\_rendering.py\) to enforce rules around inline code, tables, and code fences. Also in this area: 2 commits (2 fixes) fixing scripts; 2 commits (0 fixes) modifying scripts; 1 commit (1 fix) fixing claude-howto, scripts; Mermaid diagram rendering switches from mmdc to Pele.

scripts/tests · low confidence · unverified

Dependencies

Introduce Python build tooling and pinned dependencies for scripts

The repository now includes a structured Python environment for the \scripts/\ directory, featuring a \pyproject.toml\ that defines the core application (\claude-howto\) and its runtime dependencies (\ebooklib\, \markdown\, \beautifulsoup4\, \pillow\, \jinja2\). To ensure reproducibility, \requirements.txt\ pins these core packages to specific versions (e.g., \pillow==11.1.0\, \jinja2==3.1.4\). Additionally, \requirements-dev.txt\ and \pyproject.toml\ introduce development tooling, including testing frameworks (\pytest\, \pytest-asyncio\), code quality and linting tools (\ruff\, \mypy\, \bandit\, \pre-commit\), and their respective version constraints.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 54 → 43 (-11.6)
  • Rubric changed (rubric-2026.11.1 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 47 → 24 (-23.3)
  • Architecture 98 → 98 (-0.0)
  • Maturity 81 → 85 (+3.6)
  • Readiness 45 → 34 (-10.9)
  • Security 81 → 76 (-4.5)
  • Accessibility 64 → 75 (+10.5)
  • Performance 100 → 100 (+0.0)

Resolved (6)

  • Coverage read from a committed report
  • Edited copy of a member (46 corresponding lines) (03-skills/refactor/scripts/analyze-complexity.py)
  • Off-boarding risk: anonymized user #1
  • redundant comment (07-plugins/devops-automation/hooks/post-deploy.js)
  • redundant comment (uk/07-plugins/devops-automation/hooks/post-deploy.js)
  • redundant comment (vi/07-plugins/devops-automation/hooks/post-deploy.js)

New (21)

  • Critical CVE: [GHSA redacted] (scripts/requirements.txt)
  • Edited copy of a member (21 corresponding lines) (scripts/check_markdown_rendering.py)
  • Edited copy of a member (29 corresponding lines) (scripts/build_website.py)
  • Medium CVE: [GHSA redacted] (scripts/requirements.txt)
  • Medium CVE: [GHSA redacted] (scripts/requirements.txt)
  • Off-boarding risk: anonymized user #1
  • isDeployCommand (cognitive 18) (07-plugins/devops-automation/hooks/post-deploy.js)
  • isDeployCommand (cognitive 18) (07-plugins/devops-automation/hooks/pre-deploy.js)
  • isDeployCommand (cognitive 18) (uk/07-plugins/devops-automation/hooks/post-deploy.js)
  • isDeployCommand (cognitive 18) (uk/07-plugins/devops-automation/hooks/pre-deploy.js)
  • isDeployCommand (cognitive 18) (vi/07-plugins/devops-automation/hooks/post-deploy.js)
  • isDeployCommand (cognitive 18) (vi/07-plugins/devops-automation/hooks/pre-deploy.js)
  • main (cognitive 19) (07-plugins/devops-automation/hooks/post-deploy.js)
  • main (cognitive 19) (uk/07-plugins/devops-automation/hooks/post-deploy.js)
  • main (cognitive 19) (vi/07-plugins/devops-automation/hooks/post-deploy.js)
  • post-deploy.isDeployCommand (cyclomatic 20) (07-plugins/devops-automation/hooks/post-deploy.js)
  • post-deploy.isDeployCommand (cyclomatic 20) (uk/07-plugins/devops-automation/hooks/post-deploy.js)
  • post-deploy.isDeployCommand (cyclomatic 20) (vi/07-plugins/devops-automation/hooks/post-deploy.js)
  • pre-deploy.isDeployCommand (cyclomatic 20) (07-plugins/devops-automation/hooks/pre-deploy.js)
  • pre-deploy.isDeployCommand (cyclomatic 20) (uk/07-plugins/devops-automation/hooks/pre-deploy.js)
  • …and 1 more

Changes since last survey

  • 23 commits — 18 feature/other, 5 fixes

By area

  • (root) — 4 commits
  • .github/workflows — 3 commits
  • .claude/skills — 2 commits
  • 09-advanced-features/README.md — 2 commits
  • fa/07-plugins — 2 commits
  • scripts/tests — 2 commits
  • vi/07-plugins — 2 commits
  • 03-skills/README.md — 1 commit
  • ja/06-hooks — 1 commit
  • uk/07-plugins — 1 commit
  • vi/04-subagents — 1 commit
  • vi/06-hooks — 1 commit
  • vi/09-advanced-features — 1 commit

Notable commits

  • fix: fix(ci): pin Python 3.11 in release workflow (#250)
  • fix: fix(hooks): harden hook templates and the auto-mode baseline (#263)
  • fix: fix(plugins): make the example plugins load their commands, hooks and MCP servers (#265)
  • fix: fix(skills): add Fable 5.2 to the ultrathink lists in the learner skills (#268)
  • fix: fix: recognize mermaid fences with info strings or trailing space (#240)
  • change: ci(release): publish EPUBs for all six languages (#253)
  • change: ci(release): publish a draft naming missing languages when a build fails (#257)
  • change: docs(advanced-features): output style switches apply on the next message (#239)
  • change: docs(advanced-features): tighten output-style timing wording and port it to fa and vi (#245)
  • change: docs(i18n): add Persian (Farsi) translation (#208)
  • change: docs(skills): retitle skillOverrides section as a visibility control (#242)
  • change: docs(vi): fully translate 09-advanced-features (#234)
  • change: docs(vi): sync 04-subagents and 05-mcp READMEs with English source (#237)
  • change: docs(vi): sync 06-hooks README with English source (#236)
  • change: docs(vi): sync 07-plugins and 10-cli READMEs with English source (#238)
  • change: docs(vi): translate memory, plugin and checkpoint example files (#235)
  • change: docs: drop unsourced v2.1.145 for /run, /verify and /run-skill-generator (#262)
  • change: docs: make version stamps and Compatible Models footers true (#259)
  • change: docs: sync to Claude Code v2.1.322 (#247)
  • change: docs: sync to Claude Code v2.1.323 (#273)
  • …and 3 more

Architecture

  • Unchanged — 0 containers · 2 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

luongnv89/claude-howto was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 5609e68a6ce838579e15fd31ceb6025be08841df — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.73+preprod-52de90b74216.