المهارات baoyu-format-markdown
📝

baoyu-format-markdown

مخاطر منخفضة ⚙️ الأوامر الخارجية📁 الوصول إلى نظام الملفات🌐 الوصول إلى الشبكة

تنسيق ملفات Markdown

يحول النص العادي وملفات markdown إلى مستندات جيدة التنسيق مع frontmatter مناسب، وعلامات طباعية، وتنسيق صحيح. يُنتج markdown نظيف وجاهز للنشر مع دعم لغات CJK.

يدعم: Claude Codex Code(CC)
📊 69 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "baoyu-format-markdown". My Article Title This is plain text content. First point is important. Second point matters too.

النتيجة المتوقعة:

تمت إضافة Frontmatter مع العنوان، والslug، والملخص. تم تنظيم المحتوى مع تسلسل هرمي للعناوين، ونص غامق للعبارات الرئيسية، وقوائم نقطية.

استخدام "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.

6
الملفات التي تم فحصها
1,631
الأسطر التي تم تحليلها
8
النتائج
1
إجمالي عمليات التدقيق

مشكلات عالية المخاطر (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:409scripts/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:102scripts/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)
scripts/package-lock.json:45 scripts/package-lock.json:53 scripts/package-lock.json:61 scripts/package-lock.json:87 scripts/package-lock.json:105 scripts/package-lock.json:115 scripts/package-lock.json:130 scripts/package-lock.json:141 scripts/package-lock.json:148 scripts/package-lock.json:158 scripts/package-lock.json:166 scripts/package-lock.json:174 scripts/package-lock.json:188 scripts/package-lock.json:210 scripts/package-lock.json:226 scripts/package-lock.json:243 scripts/package-lock.json:258 scripts/package-lock.json:273 scripts/package-lock.json:286 scripts/package-lock.json:301 scripts/package-lock.json:315 scripts/package-lock.json:327 scripts/package-lock.json:346 scripts/package-lock.json:357 scripts/package-lock.json:365 scripts/package-lock.json:369 scripts/package-lock.json:398 scripts/package-lock.json:402 scripts/package-lock.json:427 scripts/package-lock.json:452 scripts/package-lock.json:480 scripts/package-lock.json:498 scripts/package-lock.json:512 scripts/package-lock.json:530 scripts/package-lock.json:546 scripts/package-lock.json:561 scripts/package-lock.json:572 scripts/package-lock.json:587 scripts/package-lock.json:595 scripts/package-lock.json:599 scripts/package-lock.json:614 scripts/package-lock.json:618 scripts/package-lock.json:634 scripts/package-lock.json:638 scripts/package-lock.json:652 scripts/package-lock.json:656 scripts/package-lock.json:672 scripts/package-lock.json:676 scripts/package-lock.json:692 scripts/package-lock.json:696 scripts/package-lock.json:710 scripts/package-lock.json:714 scripts/package-lock.json:727 scripts/package-lock.json:731 scripts/package-lock.json:746 scripts/package-lock.json:750 scripts/package-lock.json:764 scripts/package-lock.json:768 scripts/package-lock.json:781 scripts/package-lock.json:785 scripts/package-lock.json:801 scripts/package-lock.json:805 scripts/package-lock.json:815 scripts/package-lock.json:819 scripts/package-lock.json:829 scripts/package-lock.json:833 scripts/package-lock.json:846 scripts/package-lock.json:850 scripts/package-lock.json:863 scripts/package-lock.json:867 scripts/package-lock.json:882 scripts/package-lock.json:886 scripts/package-lock.json:902 scripts/package-lock.json:906 scripts/package-lock.json:916 scripts/package-lock.json:920 scripts/package-lock.json:931 scripts/package-lock.json:961 scripts/package-lock.json:977 scripts/package-lock.json:991 scripts/package-lock.json:1004 scripts/package-lock.json:1012 scripts/package-lock.json:1029 scripts/package-lock.json:1040 scripts/package-lock.json:1051 scripts/package-lock.json:1064 scripts/package-lock.json:1076 scripts/package-lock.json:1088 scripts/package-lock.json:1100 scripts/package-lock.json:1113 scripts/package-lock.json:1121
تم تدقيقه بواسطة: claude

درجة الجودة

45
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
61
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

تنسيق منشورات المدونة

تنسيق مسودات منشورات المدونة من نص عادي أو تحسين مقالات markdown الموجودة مع frontmatter مناسب، وعناوين، وعلامات طباعية.

تنظيف التوثيق

تطبيق تنسيق وهيكل متسقين على التوثيق التقني أو ملفات 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 فقط عندما تكون علامات الاقتباس fullwidth مطلوبة على وجه التحديد
  • لمستندات CJK، أبقِ التباعد مفعلاً للحفاظ على تنسيق صحيح للمستندات متعددة اللغات

تجنب

  • لا تستخدم على ملفات لديها بالفعل markdown معقد - استخدم خيار 'Keep original formatting'
  • تجنب التشغيل على ملفات كبيرة جداً لأن عملية التنسيق تُعالج المستند بالكامل
  • لا تتوقع توليد المحتوى - هذه المهارة تنسّق المحتوى الموجود فقط

الأسئلة المتكررة

ماذا يحدث لملفي الأصلي؟
يبقى الملف الأصلي دون تغيير. يتم حفظ المخرجات المنسقة كـ {filename}-formatted.md.
هل يمكنني تخصيص حقول frontmatter؟
تُولّد المهارة تلقائياً العنوان، والslug، والملخص. يمكنك تحرير هذه بعد التنسيق أو استخدام EXTEND.md للتفضيلات.
هل يعمل هذا مع النصوص الصينية أو اليابانية أو الكورية؟
نعم، تتضمن المهارة تنسيقاً متوافقاً مع CJK ويمكنها إصلاح مشاكل التشديد والتباعد في المستندات متعددة اللغات.
ما الفرق بين Optimize و Keep Original؟
Optimize يضيف أو يُحسّن هيكل markdown. Keep Original يحافظ على تنسيقك الموجود ويطبق إصلاحات الطباعة فقط.
كيف أُفعّل استبدال علامات الاقتباس fullwidth؟
استخدم علامة --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