Markdown Review with textlint

VerifiedSafe

Checks Markdown files for typos, spelling errors, and runs textlint to detect style rule violations. Helps when proofreading and correcting technical articles before publication.

Sby Skills Guide Bot
DocumentationIntermediate
6/2/2026
Claude Code
#markdown#review#textlint#proofreading#japanese

Recommended for

Automated summary

This skill checks for typos and applies textlint corrections on Markdown files.

Strengths

  • Accurate detection of typos in Japanese and English
  • Integration with textlint for advanced style rules
  • Automatic fixes with user confirmation
  • Smart file search within articles/ directory

Limitations

  • Requires mise and pnpm to be pre-installed
  • Limited to Markdown files inside articles/
  • Some corrections may need manual review
When to use it

Use this skill to proofread and automatically correct Markdown articles before publishing.

When not to use it

Do not use it for files outside the articles/ directory or for non-Markdown formats.

Security analysis

Safe
Quality score90/100

No destructive, exfiltrating, or obfuscated actions. The skill only reads a specified file and runs textlint, a linter, with user confirmation before applying fixes via --fix. No network requests, no sensitive data exposure.

No concerns found

How this analysis is made

Examples

Review a specific file
/review-md a.md
Review without extension
/review-md getting-started

review-md スキル

Markdown 記事の誤字脱字チェックと textlint による校正を行うスキルです。

使い方

/review-md <ファイル名>

例: /review-md a.md または /review-md a

引数

  • <ファイル名>: チェック対象のファイル名(必須)。articles/ 配下を自動で検索する

ファイル解決

対象ファイルは常に articles/ ディレクトリ配下から検索する。以下の順序で解決を試みる。

  1. articles/ 配下で指定されたファイル名に完全一致するファイルを Glob で検索する(例: articles/**/a.md)
  2. 見つからない場合、拡張子 .md を付与して再検索する(例: articles/**/a.md)
  3. それでも見つからない場合、部分一致で検索する(例: articles/**/*a*.md)
  4. 候補が複数ある場合はユーザーに選択を求める
  5. 候補が0件の場合はエラーを報告して終了する

重要: 検索は指定されたファイル名に対してのみ行う。articles/ 配下の全ファイル一覧を列挙してはならない

実行手順

  1. 上記のファイル解決手順で対象ファイルを特定する
  2. 対象ファイルを読み込む
  3. 以下の観点で誤字脱字をチェックする
    • 日本語の誤字・脱字(漢字の誤変換、送り仮名の誤りなど)
    • 英単語のスペルミス(技術用語を含む)
    • 固有名詞の表記ミス
  4. mise x -- pnpm textlint <ファイルパス> を実行して校正ルール違反を検出する
  5. 検出した問題を一覧で報告する
    • 誤字・スペルミスの一覧(行番号、修正前、修正後)
    • textlint の指摘事項一覧
  6. ユーザーに修正を適用するか確認する
  7. 承認された場合、以下の順序で修正を適用する
    • mise x -- pnpm textlint --fix <ファイルパス> で自動修正可能な項目を修正
    • textlint の自動修正で意図しない変換が発生していないか確認し、あれば修正する(例: パッケージ名内の単語が誤って大文字化されるケース)
    • 手動修正が必要な項目(誤字、長文分割、弱い表現など)を個別に修正
  8. 最後に mise x -- pnpm textlint <ファイルパス> を再実行してエラーが0件であることを確認する

注意事項

  • 対象ファイルは必ず引数で明示的に指定すること
  • 修正の適用前に必ずユーザーに確認を取ること

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/markdown-review-with-textlint-mm5t89zj/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/markdown-review-with-textlint-mm5t89zj' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/markdown-review-with-textlint-mm5t89zj/download' --output '.skill-downloads/markdown-review-with-textlint-mm5t89zj/SKILL.md.part' && mv '.skill-downloads/markdown-review-with-textlint-mm5t89zj/SKILL.md.part' '.skill-downloads/markdown-review-with-textlint-mm5t89zj/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

This file does not provide a usable name/description header for this native procedure. It remains available to download and inspect; use the manual method below.

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/markdown-review-with-textlint-mm5t89zj/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills