スキル baoyu-format-markdown

📝

baoyu-format-markdown

Name: baoyu-format-markdown
Author: jimliu

低リスク ⚙️ 外部コマンド📁 ファイルシステムへのアクセス🌐 ネットワークアクセス

Format Markdown Files

プレーンテキストとmarkdownファイルを、適切なfrontmatter、タイポグラフィ、フォーマットを備えた整然としたドキュメントに変換します。CJK言語サポートを備えた、クリーンで出版可能なmarkdownを出力します。

対応: Claude Codex Code(CC)

📊 69 十分

スキルZIPをダウンロード

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

オンにして利用開始

テストする

「baoyu-format-markdown」を使用しています。 My Article Title This is plain text content. First point is important. Second point matters too.

期待される結果:

title、slug、summaryを含むfrontmatterが追加されました。コンテンツは見出し階層、太字テキストによる重要フレーズ、箇条書きリストで構造化されています。

「baoyu-format-markdown」を使用しています。 Existing markdown file with minimal formatting

期待される結果:

改善されたfrontmatter、一貫した見出しレベル、適切な太字マーカー、適用されたタイポグラフィ修正で強化

セキュリティ監査

低リスク

v1 • 2/17/2026

Security evaluation confirms this is a legitimate markdown formatting skill. Static findings flagged external command execution (autocorrect-node), filesystem operations, and npm package URLs. All are false positives: execSync runs a known typography tool with CLI-provided paths, file I/O is scoped to user-specified files, and network access is limited to standard npm package downloads.

スキャンされたファイル

1,631

解析された行数

検出結果

総監査数

高リスクの問題 (2)

scripts/autocorrect.ts:5

External Command Execution in autocorrect.ts

execSync used to run npx autocorrect-node. This is a legitimate typography tool call, not command injection. The filePath argument comes from CLI input and is enclosed in quotes, minimizing injection risk.

scripts/package-lock.json:409 scripts/package-lock.json:590

Weak Cryptographic Hashes in package-lock.json

SHA-1 hashes detected in npm package-lock.json. These are standard npm integrity verification hashes, not cryptographic vulnerabilities in the skill code.

中リスクの問題 (1)

scripts/main.ts:102 scripts/main.ts:108

Synchronous File Operations

readFileSync and writeFileSync used for file I/O. This is standard synchronous file handling for a formatter tool, not a security issue.

低リスクの問題 (2)

scripts/package-lock.json:45

NPM Registry URLs in package-lock.json

Hardcoded npm registry URLs for package dependencies. Standard npm behavior for package management.

scripts/quotes.ts:3-4

Unicode Escape Sequences in quotes.ts

Unicode escape sequences used for curly quote characters. Legitimate character encoding for typography.

リスク要因

⚙️ 外部コマンド (93)

scripts/autocorrect.ts:1 scripts/autocorrect.ts:5 scripts/autocorrect.ts:5 scripts/main.ts:115 scripts/main.ts:118 scripts/main.ts:144-153 scripts/main.ts:163 SKILL.md:12 SKILL.md:12 SKILL.md:16 SKILL.md:17 SKILL.md:18 SKILL.md:24-30 SKILL.md:30-66 SKILL.md:66-67 SKILL.md:67 SKILL.md:67 SKILL.md:67-68 SKILL.md:68 SKILL.md:68-69 SKILL.md:69 SKILL.md:69-70 SKILL.md:70-71 SKILL.md:71-86 SKILL.md:86-102 SKILL.md:102-112 SKILL.md:112-121 SKILL.md:121-127 SKILL.md:127-128 SKILL.md:128 SKILL.md:128 SKILL.md:128-129 SKILL.md:129-130 SKILL.md:130 SKILL.md:130 SKILL.md:130-135 SKILL.md:135-136 SKILL.md:136-142 SKILL.md:142-144 SKILL.md:144-150 SKILL.md:150-168 SKILL.md:168 SKILL.md:168 SKILL.md:168-169 SKILL.md:169-170 SKILL.md:170 SKILL.md:170-171 SKILL.md:171 SKILL.md:171 SKILL.md:171 SKILL.md:171 SKILL.md:171 SKILL.md:172 SKILL.md:173 SKILL.md:183 SKILL.md:186 SKILL.md:186 SKILL.md:187 SKILL.md:187 SKILL.md:190 SKILL.md:195 SKILL.md:197-203 SKILL.md:203-206 SKILL.md:206 SKILL.md:206-212 SKILL.md:212-214 SKILL.md:214-220 SKILL.md:220 SKILL.md:220 SKILL.md:220-221 SKILL.md:221-222 SKILL.md:222 SKILL.md:222-223 SKILL.md:223-224 SKILL.md:224 SKILL.md:224-225 SKILL.md:225-226 SKILL.md:226 SKILL.md:226-230 SKILL.md:230-242 SKILL.md:242-247 SKILL.md:247 SKILL.md:247-252 SKILL.md:252-262 SKILL.md:262-267 SKILL.md:267-269 SKILL.md:269-272 SKILL.md:272-286 SKILL.md:286-287 SKILL.md:287-292 SKILL.md:292 SKILL.md:201 SKILL.md:197-203

📁 ファイルシステムへのアクセス (6)

scripts/main.ts:1 scripts/main.ts:1 scripts/main.ts:102 scripts/main.ts:108 SKILL.md:29 SKILL.md:37

🌐 ネットワークアクセス (91)

監査者: claude

品質スコア

アーキテクチャ

100

保守性

コンテンツ

コミュニティ

セキュリティ

仕様準拠

作れるもの

ブログ投稿のフォーマット

プレーンテキストから下書きブログ投稿をフォーマットするか、適切なfrontmatter、見出し、タイポグラフィを備えた既存のmarkdown記事の改善します。

ドキュメントのクリーンアップ

技術ドキュメントやreadmeファイルに一貫したフォーマットと構造を適用します。

CJKドキュメントの準備

中国語、日本語、韓国語の混合言語markdownドキュメントのスペーシングと強調の問題を修正します。

これらのプロンプトを試す

基本的なMarkdownフォーマット

Format the file /path/to/document.md using baoyu-format-markdown skill.

プレーンテキスト変換

Convert the plain text file /path/to/draft.txt to well-structured markdown with frontmatter and proper headings.

タイポグラフィ修正のみ

Run typography fixes only on /path/to/article.md without changing the existing markdown structure.

全機能有効な完全なフォーマット

Format /path/to/post.md with all features enabled: frontmatter optimization, typography fixes, and fullwidth quote replacement.

ベストプラクティス

スキルは新しい出力ファイルを作成するため、フォーマット前に常に元のファイルをバックアップしてください
全角引用符のタイポグラフィが特に必要な場合にのみ--quotesフラグを使用してください
CJKドキュメントでは、適切な混合言語フォーマットを維持するためにスペーシングを有効にしてください

回避

複雑なmarkdownが既に含まれているファイルには使用せず、「元のフォーマットを維持」オプションを使用してください
フォーマットプロセスはドキュメント全体を処理するため、非常に大きなファイルでの実行は避けてください
コンテンツ生成を期待しないでください。このスキルは既存のコンテンツのフォーマットのみを行います

よくある質問

元のファイルはどうなりますか？

元のファイルは変更されません。フォーマットされた出力は{filename}-formatted.mdとして保存されます。

frontmatterフィールドをカスタマイズできますか？

スキルはtitle、slug、summaryを自動生成します。フォーマット後に編集するか、EXTEND.mdで設定を指定できます。

中国語、日本語、韓国語のテキストで動作しますか？

はい、スキルにはCJKに優しいフォーマットが含まれており、混合言語ドキュメントの強調とスペーシングの問題を修正できます。

OptimizeとKeep Originalの違いは何ですか？

Optimizeはmarkdown構造を追加または改善します。Keep Originalは既存のフォーマットを維持し、タイポグラフィ修正のみを適用します。

全角引用符の置換を有効にするにはどうすればいいですか？

スクリプト実行時に--quotesまたは-qフラグを使用するか、プロンプト時にワークフローでオプション1を選択してください。

Claude CodeやCodexでこのスキルを使用できますか？

はい、このスキルはclaude、codex、claude-codeをサポートツールとしてサポートしています。

開発者の詳細

作成者

jimliu

ライセンス

MIT

リポジトリ

https://github.com/jimliu/baoyu-skills/tree/main/skills/baoyu-format-markdown/

参照

main

ファイル構成

📁 scripts/

📄 autocorrect.ts

📄 bun.lock

📄 main.ts

📄 package-lock.json

📄 package.json

📄 quotes.ts

📄 SKILL.md