okw0204/japanese-documentation
dot_config/opencode/skills/japanese-documentation/SKILL.md
Use when writing or editing human-readable documentation such as README, docs, Markdown, AGENTS.md, SKILL.md, design docs, specs, guides, notes, or HTML.
development
Updated Jun 6, 2026
$ install --global
skillsauthnpx skillsauth add okw0204/dotfiles japanese-documentationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 6, 2026, 6:58 AM108.3s1 file scanned
SKILL.md
- name:
- japanese-documentation
- description:
- Use when writing or editing human-readable documentation such as README, docs, Markdown, AGENTS.md, SKILL.md, design docs, specs, guides, notes, or HTML.
Japanese Documentation
原則
人が読む文書は、日本語で記述する。opencode が README、docs、Markdown、AGENTS.md、SKILL.md、設計書、仕様書、手順書、Obsidian ノート、HTML などを作成または編集するときに適用する。
この方針は、読み手がユーザー本人である文書にも、将来のエージェントや共同作業者が読む文書にも適用する。
英語のままでよいもの
次の内容は、読みやすさや正確性のために英語のままでよい。
| 種類 | 例 |
| --- | --- |
| コード識別子 | getUser, ConfigInvalidError |
| API名・型名 | tool.execute.before, PluginInput |
| コマンド・パス | node --test, docs/guide.md |
| ログ・エラーメッセージ | ENOENT, ConfigInvalidError |
| 引用 | 外部文書からの原文引用 |
| 固有名詞 | 製品名、ライブラリ名、仕様名 |
書き方
- 見出し、説明文、手順、注意書きは日本語で書く。
- 英語の用語を残す場合は、必要に応じて日本語で補足する。
- 外部公開や upstream への提出など、英語が明確に必要な場合は、その理由を簡潔に示して英語で書く。
- 太字は強調が本当に必要な語句に限り、多用し過ぎない。
- 英語直訳調を避け、日本語として自然に読める表現にする。
- 何を伝えたいかを先に明確にし、定型句や雰囲気で意味をぼかさない。
- 短く言える場合は短く書き、抽象的な言い回しより具体的な表現を選ぶ。
判断基準
迷ったら「人間が読むための本文か」を基準にする。
| 対象 | 方針 | | --- | --- | | README、docs、設計書、仕様書、手順書 | 日本語 | | AGENTS.md、SKILL.md、エージェント向け説明 | 日本語 | | コード、設定キー、コマンド、ログ | 英語のままでよい |
よくある失敗
| 失敗 | 修正 |
| --- | --- |
| Skill の本文を英語で書く | SKILL.md も人が読む文書なので日本語で書く |
| README の追記だけ英語にする | 日本語が適切な文書では、追記も日本語で書く |
| コード名まで翻訳する | コード識別子、API名、コマンドは翻訳しない |
Related Skills
okw0204/managing-llm-wiki
development
VerifiedTrustedCommunity
Manages the user's Obsidian-based LLM Wiki. Use this skill whenever the user mentions `LLM Wiki`, wants to ingest or import source material into `LLM Wiki/raw/`, passes a URL or web page to be incorporated as source, wants to update or reorganize synthesized notes in `LLM Wiki/wiki/`, wants to refresh `LLM Wiki/index.md` or `LLM Wiki/log.md`, wants to ask questions grounded in that wiki, or wants a lint/health-check of the wiki. Use it even when the user does not explicitly say `ingest`, `query`, or `lint`, as long as the request is clearly about operating this LLM Wiki while preserving the raw/wiki boundary, Japanese writing style, frontmatter tag rules, and `[[wikilink]]` conventions.
SKILL.mdUpdated Jun 6, 2026
okw0204/design-taste-frontend
development
VerifiedTrustedCommunity
Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check.
SKILL.mdUpdated Jun 3, 2026
okw0204/skill-creator
testing
VerifiedTrustedCommunity
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
SKILL.mdUpdated Jun 3, 2026
okw0204/omarchy
development
VerifiedTrustedCommunity
REQUIRED for end-user customization of Linux desktop, window manager, or system config. Use when editing ~/.config/hypr/, ~/.config/waybar/, ~/.config/walker/, ~/.config/alacritty/, ~/.config/kitty/, ~/.config/ghostty/, ~/.config/mako/, or ~/.config/omarchy/. Triggers: Hyprland, window rules, animations, keybindings, monitors, gaps, borders, blur, opacity, waybar, walker, terminal config, themes, wallpaper, night light, idle, lock screen, screenshots, layer rules, workspace settings, display config, and user-facing omarchy commands. Excludes Omarchy source development in ~/.local/share/omarchy/ and omarchy-dev-* workflows.
SKILL.mdUpdated Apr 10, 2026