awesome-design-md-jp — Claude Code skill: what it does & setup
Provides Japanese UI specifications in DESIGN.md format for AI agents. It sets up CJK typography, font fallback chains, and punctuation line-break rules.
npx skills add reason-machines/trending-skills --skill awesome-design-md-jp -a claude-codeWhat awesome-design-md-jp does
AI agents read DESIGN.md for UI guidance. This skill extends the Google Stitch specification format specifically for Japanese websites. It configures CJK font fallback stacks, expands body line-height to values between 1.5 and 2.0, and sets letter-spacing between 0.04em and 0.1em. It also activates OpenType attributes palt and kern for proportional glyph spacing.
The package supplies 24 reference files based on services like MUJI, SmartHR, Mercari, and LINE. Each spec defines mixed Latin and Japanese typesetting alongside kinsoku shori line-breaking rules using line-break: strict. Without these rules in DESIGN.md, coding agents fall back to Western text styling, creating cramped Japanese paragraphs with orphaned punctuation marks.
What it helps with
- configure kinsoku shori line-break rules for CJK punctuation
- build mixed typography font stacks for Japanese and Latin text
- generate a DESIGN.md spec matching MUJI or SmartHR styles
- adjust line-height and letter-spacing for Japanese web layouts
Example prompts for the agent
- Create a DESIGN.md file for a Japanese web app with kinsoku shori rules
- Generate a Japanese UI design spec modeled after the MUJI style
- Add Japanese font stacks and OpenType palt settings to DESIGN.md
How to install awesome-design-md-jp
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awesome-design-md-jp -a claude-code2Manually: put the files in place
~/.claude/skills/awesome-design-md-jp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/awesome-design-md-jp/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awesome-design-md-jp -a codex2Manually: put the files in place
.agents/skills/awesome-design-md-jp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awesome-design-md-jp -a cursor2Manually: put the files in place
.cursor/skills/awesome-design-md-jp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills awesome-design-md-jp2Manually: put the files in place
.github/skills/awesome-design-md-jp/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awesome-design-md-jp -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/awesome-design-md-jpManually: put the files in place
.devin/skills/awesome-design-md-jp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill awesome-design-md-jp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about awesome-design-md-jp
How do I install awesome-design-md-jp in Claude Code?
Run npx skills add reason-machines/trending-skills --skill awesome-design-md-jp -a claude-code. The skill file will be placed at ~/.claude/skills/awesome-design-md-jp/SKILL.md.
What does awesome-design-md-jp do?
It provides templates and 24 reference DESIGN.md files for Japanese web applications. AI coding agents read these files to apply correct CJK typography and layout rules.
What layout settings does the template include?
It specifies line-height from 1.5 to 2.0, letter-spacing up to 0.1em, strict punctuation line breaks, and OpenType palt and kern flags.