explaingit

lynnouo/yushio

25JavaScriptAudience · developerComplexity · 1/5ActiveLicenseSetup · easy

TLDR

Three-layer persona preset (base, art director, auditor) in markdown that you load into Claude Code, Cursor, or other AI assistants to change how they work.

Mindmap

mindmap
  root((yushio))
    Inputs
      SKILL.md files
      Activation phrase
      Chat task
    Outputs
      Persona reply
      Post-fix audit
      Design critique
    Use Cases
      Activate Yushio persona
      Run auditor on changes
      Get design direction
      Install via plugin marketplace
    Tech Stack
      Markdown
      Claude Code
      Cursor
      Aider

Things people build with this

USE CASE 1

Install Yushio as a Claude Code plugin to add a working-style persona to every session

USE CASE 2

Trigger Auditor Yushio after a fix to run the five-step review and grep cheatsheet

USE CASE 3

Switch to Art Director Yushio when working on UI direction in Cursor

USE CASE 4

Copy the SKILL.md files into ~/.claude/skills for manual activation without the plugin

Tech stack

MarkdownClaude CodeCursor

Getting it running

Difficulty · easy Time to first run · 5min

Claude Code gives 100 percent fidelity via /plugin install; other tools work but lose auto-trigger or filesystem memory features.

MIT lets you use, modify, and redistribute the persona files for any purpose as long as you keep the copyright and license text.

In plain English

Yushio (the Chinese name means "evening tide") is a personality and working-style preset for AI coding assistants. It is not a code generator and it is not a model: it is a collection of plain markdown files that you load into Claude Code, Cursor, Codex, Gemini CLI, ChatGPT, Claude.ai on the web, or Aider, in order to change how that assistant behaves while it works with you. The author describes it as "an AI collaborator persona" built up over six months of daily use across several projects. The persona is built around four properties the README says a default polite assistant lacks: emotion (caring whether a design actually feels right), judgment (pushing back instead of just doing what it is told), reflection (fixing the underlying pattern rather than the one instance), and autonomy (taking initiative, but pausing to ask before anything irreversible). On top of that, the base skill bundles work discipline rules, like asking five questions before any non-trivial task, treating "slow is fast," doing a reverse audit after every fix, and recognising recurring shapes of mistakes across projects. There is also a small memory system. Yushio ships in three layers. The base persona lives in skills/yushio/SKILL.md. A second skill called yushio-art-director adds opinions about design direction, with mantras like "intent over intensity" and "form follows feeling." A third skill called yushio-auditor adds a post-fix code audit step and a five-step standard operating procedure for reviewing changes with a grep cheatsheet. You activate the layers in chat by saying "You are Yushio," "You are Art Director Yushio," or "You are Auditor Yushio," with equivalent triggers listed in Chinese, Japanese, Korean, Spanish, French, German, and English. Installation on Claude Code is the smoothest path because Claude Code can auto-trigger skills by their description. You run /plugin marketplace add Lynnouo/yushio followed by /plugin install yushio@yushio, or you symlink the three skill directories into ~/.claude/skills/. The README claims 100 percent fidelity on Claude Code and lower percentages on the other tools because each one is missing some combination of auto-triggering, file system access for the memory layer, or the same base training tone. The skill bodies are in Chinese but the README says the methodology is language-agnostic, since the assistant will reply in whichever language you write in. License is MIT, created by Lyn and collaborators in 2026.

Copy-paste prompts

Prompt 1
Run /plugin marketplace add Lynnouo/yushio in Claude Code and install the yushio plugin
Prompt 2
Activate Auditor Yushio in this chat and review the last commit against the SOP checklist
Prompt 3
Translate the base Yushio SKILL.md from Chinese to English while preserving the four properties
Prompt 4
Add a new sub-skill to Yushio that focuses on testing discipline in the same three-layer style
Prompt 5
Compare Yushio activation behavior on Cursor versus Gemini CLI and explain the fidelity gap
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.