openjny/writing-skills

人間らしい文章を書くための Linter とガイドライン。Use when: 文章をレビュー・リライトしたい、AI生成テキストを人間らしく修正したい、新規執筆でAI臭を避けたい。Triggers: 文章を書いて、校正

Use when: Markdown 文書のリンクチェック、リンク切れ、URL 検証、相対リンク・anchor・reference link、見出し・構文・表の構造を著者や生成方法に関係なく検査したいとき。markdown check / doc lint / document check / broken link / validate URLs。既定は offline・report-only。文章の品質評価・リライト、認証付き HTTP、localhost の検査には使わない。

技術文書を、読み手が 1 回で理解して行動できるように書く・レビューする。文書のモード選択（チュートリアル、ハウツー、リファレンス、解説）、手順の書き方、一文一義、誤読の余地の排除、用語統一、見出し・リンク・リストの規約、PR 説明とコミットメッセージを扱う。AI 臭の除去は anti-ai-writing、Markdown のリンク・構造の検査は markdown-check が担当する。Use when: README、設計書、RFC、手順書、リファレンス、PR 説明、コミットメッセージを書く・直す・レビューするとき。Triggers: technical writing、テクニカルライティング、技術文書、手順書、分かりにくい文書、ドキュメントレビュー