PROJECT 004 / 2026 —
yomitoki — Code Readability Skill
DEVELOPER TOOLS / AGENT SKILLS
An AI agent skill for making code easier to understand, with syntax metrics across six languages and before-and-after comparisons to support behavior-preserving changes.
GitHub / yomitoki →- ROLE
- Skill design, check scripts, documentation
- STATUS
- PUBLIC
- TECHNOLOGY
- PYTHON / AST / TREE-SITTER / RUFF / AGENT SKILLS
IMPLEMENTATION
- 01An Agent Skills SKILL.md with 14 review criteria
- 02Syntax metrics for six languages using Python ast and tree-sitter
- 03Python Ruff lint and formatting checks with JSON report comparisons
- 04Language-specific check guides and Japanese, English, and Chinese READMEs
RESULTS / LEARNINGS
- — Consistent metrics for function length, parameters, nesting, complexity, and nested ternaries
- — Comparison reports that distinguish mismatched conditions from execution failures
- — Usable with compatible agents including Claude Code and Codex