← Back to list

markdown-lint
by tqer39
Personal blog monorepo powered by Next.js, Hono, and Cloudflare.
⭐ 0🍴 0📅 Jan 25, 2026
SKILL.md
name: markdown-lint description: Markdown ファイル編集後のリント実行。Markdown を作成・編集したら必ず実行。
Markdown Lint
Markdown ファイルを作成・編集した後に lint を実行するスキル。
重要
Markdown ファイル (*.md) を作成・編集した場合は、必ずこのスキルに従って lint を実行すること。
実行コマンド
just lint
対象ファイル
*.md(すべての Markdown ファイル)- 例:
README.md,DEVELOPMENT.md,CHANGELOG.md - 例:
.claude/skills/**/SKILL.md - 例:
apps/blog/src/contents/*.md
手順
- Markdown ファイルを作成・編集
just lintを実行してエラーを確認- エラーがあれば修正
- 再度
just lintで確認(すべて Passed になるまで繰り返す)
よくあるエラーと修正方法
| エラー | 原因 | 修正方法 |
|---|---|---|
| MD041 | 最初の行が見出しでない | # タイトル を先頭に追加 |
| MD040 | コードブロックに言語指定がない | ```bash のように言語を指定 |
| textlint | 日本語の文法エラー | エラーメッセージに従って修正 |
| cspell | 不明な単語 | cspell.json の words に追加 |
注意事項
- YAML front-matter がある場合、見出しはその直後に記述
- コードブロックには必ず言語を指定(
textでも可) - 日本語の助詞の重複に注意(textlint が検出)
Score
Total Score
65/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
○説明文
100文字以上の説明がある
0/10
○人気
GitHub Stars 100以上
0/15
✓最近の活動
1ヶ月以内に更新
+10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
✓タグ
1つ以上のタグが設定されている
+5
Reviews
💬
Reviews coming soon


