المهارات readme
📦

readme

آمن

Создание комплексной документации README

Этот навык создает подробную документацию README.md для любого проекта, охватывая настройку, архитектуру, развертывание и устранение неполадок. Идеально подходит для разработчиков, которые хотят получить полную документацию проекта без ручного написания.

يدعم: Claude Codex Code(CC)
⚠️ 62 ضعيف
1

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "readme". Create a README for my Rails app

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

Генерирует комплексный README с: названием проекта и обзором, таблицей технологического стека, предварительными требованиями, пошаговым руководством по началу работы, объяснением структуры каталогов, схемой базы данных, справочником переменных окружения, доступными скриптами, инструкциями по тестированию, руководством по развертыванию для определенной платформы, разделом устранения неполадок

استخدام "readme". Document my Node.js project

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

Создает README с: описанием проекта, зависимостями, инструкциями по настройке, справочником npm-скриптов, конфигурацией окружения, обзором архитектуры, инструкциями по развертыванию для определенной платформы (Vercel, Render и т.д.), распространенными шагами по устранению неполадок

التدقيق الأمني

آمن
v1 • 2/24/2026

All 268 static findings are FALSE POSITIVES. This is a documentation generation skill that provides instructions for writing README files. The flagged patterns (external commands, environment variables, URLs) are all example content within the documentation templates, not actual code execution or credential access. No real security risks identified.

1
الملفات التي تم فحصها
843
الأسطر التي تم تحليلها
5
النتائج
1
إجمالي عمليات التدقيق

مشكلات عالية المخاطر (5)

SKILL.md:75-842
External Commands False Positive
Static scanner flagged 208 instances of 'external_commands' (Ruby/shell backtick execution) - these are example commands in documentation templates, not actual code execution. The skill generates README documentation and does not execute any commands.
SKILL.md:190-633
Environment Access False Positive
Static scanner flagged 16 instances of 'env_access' (DATABASE_URL, SECRET_KEY_BASE, etc.) - these are documented environment variables in example documentation, not actual environment access.
SKILL.md:4-377
Network Access False Positive
Static scanner flagged 6 instances of 'network' (URLs, SMTP settings) - these are example URLs and configuration documentation, not actual network requests.
SKILL.md:45-770
Sensitive Files False Positive
Static scanner flagged references to credentials files (.env.example, credentials.yml.enc, master.key) - these are documentation about configuration files, not actual file access.
SKILL.md:3-555
Weak Cryptographic Algorithm False Positive
Static scanner flagged 10 instances of 'weak cryptographic algorithm' - these are standard Rails terms (encrypted_password, credentials.yml.enc) in documentation, not actual crypto implementation.
تم تدقيقه بواسطة: claude

درجة الجودة

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

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

Документация нового проекта

Создайте полный README для только что созданного проекта, чтобы задокументировать настройку и архитектуру с первого дня.

Обновление README существующего проекта

Обновите устаревшие файлы README с актуальными инструкциями по настройке, деталями архитектуры и шагами развертывания.

Улучшение документации открытого проекта

Создайте подробную документацию для открытых проектов, чтобы улучшить адаптацию новых участников.

جرّب هذه الموجهات

Базовая генерация README 
Create a README.md for this project using the readme skill. Explore the codebase first to understand the structure.
Обновление существующего README 
Update the existing README.md with more thorough documentation. The current README is outdated and missing key sections.
Добавление раздела о развертывании 
Add a deployment section to our README. Check for deployment configuration files like Dockerfile, docker-compose.yml, or deploy configs.
Полная переработка документации 
Create an absurdly thorough README that covers everything: local setup, architecture deep-dive, environment variables, testing, deployment, and troubleshooting.

أفضل الممارسات

  • Позвольте навыку полностью исследовать кодовую базу перед генерацией документации для точного содержания
  • Предоставьте доступ ко всем конфигурационным файлам (.env.example, database.yml и т.д.) для полной документации
  • Просмотрите сгенерированные таблицы переменных окружения и добавьте отсутствующие конфиденциальные значения

تجنب

  • Не просите навык документировать проект без предоставления ему доступа к файлам
  • Избегайте прерывания фазы исследования - позвольте ему собрать все детали проекта
  • Не ожидайте, что навык будет знать бизнес-логику, не очевидную в коде

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

Какие фреймворки поддерживает этот навык?
Этот навык работает с любым фреймворком. Он определяет Ruby/Rails, Node.js, Python, Go и другие, анализируя файлы проекта. Затем он адаптирует документацию соответствующим образом.
Работает ли он с монорепозиториями?
Навык может документировать монорепозитории, но может потребоваться указание, на какие пакеты или сервисы сосредоточиться. Предоставьте контекст о структуре проекта.
Может ли он обновить существующий README?
Да. Навык может прочитать существующий README и дополнить его отсутствующими разделами или полностью переписать с более подробным содержанием.
Какие платформы развертывания он определяет?
Он определяет развертывания Docker, Kamal, Heroku, Fly.io, Render, Vercel, Netlify, AWS Elastic Beanstalk, Serverless, Kubernetes и универсальные VPS.
Насколько подробна сгенерированная документация?
Цель - «абсолютно подробная» документация. Она включает разделы настройки, архитектуры, переменных окружения, скриптов, тестирования, развертывания и устранения неполадок.
Выполняет ли этот навык какие-либо команды?
Нет. Это навык генерации документации. Он только читает файлы для понимания проекта и генерирует markdown-документацию. Он не выполняет никаких команд.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/readme

مرجع

main

بنية الملفات

📄 SKILL.md