How nanaism/yomiyasu works
yomiyasu is an agent skill for revising AI-generated Japanese into clearer, denser prose, especially practical and technical writing. The main workflow is a user asking an AI coding agent to revise a draft; the skill applies its editing principles and optional domain guidance, then returns revised text. The repository also provides standalone linting and rewrite-diff tools. The README documents the skill and domain capabilities; source excerpts show the lint and diff tools, but not the skill prompt or reference-file contents.
Main entry points: SKILL.md Yomiyasu skill · gemini-syntax.md Revision principles · slop-catalog.md Slop catalog · tech.md Tech guidance
Components 11
Revision workflow
- Yomiyasu skill
SKILL.md - Revised text
Editing guidance
- Revision principles
references/gemini-syntax.md - Slop catalog
references/slop-catalog.md - Tech guidance
references/domains/tech.md - Business guidance
references/domains/business.md - Essay guidance
references/domains/essay.md
Review tools
- Text linter
scripts/yomiyasu_lint.py - Rewrite diff
scripts/yomiyasu_diff.py
Other components
- Writer
- AI agent
Connections 10
- Writer → AI agent: requests revision
README.md - AI agent → Yomiyasu skill: uses skill
README.md - Yomiyasu skill → Revision principles: applies principles
README.md - Yomiyasu skill → Slop catalog: checks patterns
README.md - Yomiyasu skill → Tech guidance: uses when selected
README.md - Yomiyasu skill → Business guidance: uses when selected
README.md - Yomiyasu skill → Essay guidance: uses when selected
README.md - AI agent → Revised text: returns revision
README.md - Writer → Text linter: checks text
README.md - Writer → Rewrite diff: compares drafts