Back to list
vuralserhat86

docs-readme

by vuralserhat86

OS for Agents: 130+ Agentic Skills, Gemini Protocols, and Autonomous Workflows. (Antigravity System)

19🍴 9📅 Jan 23, 2026

SKILL.md


name: docs_readme router_kit: ManagementKit description: README best practices ve proje dokümantasyon şablonları. metadata: skillport: category: operations tags: [architecture, automation, best practices, clean code, coding, collaboration, compliance, debugging, design patterns, development, docs readme, documentation, efficiency, git, optimization, productivity, programming, project management, quality assurance, refactoring, software engineering, standards, testing, utilities, version control, workflow] - docs-code

📄 Docs README

README ve proje dokümantasyonu best practices.


📋 README Template

# Project Name

> Tek cümleyle projenin ne yaptığını açıkla.

## Features
- ✅ Feature 1
- ✅ Feature 2

## Quick Start

### Prerequisites
- Node.js 20+

### Installation
npm install && npm run dev

## Documentation
- [API Reference](./docs/api.md)
- [Contributing](./CONTRIBUTING.md)

## License
MIT

📝 README Kuralları

KuralAçıklama
Başlık açıkNe olduğu hemen anlaşılmalı
Quick start kısa5 dakikada çalıştırabilmeli
Copy-paste readyKod blokları doğrudan çalışmalı
Görsel kullanBadge, screenshot, diagram

📊 Badges

![Build](https://img.shields.io/badge/build-passing-green)
![Coverage](https://img.shields.io/badge/coverage-95%25-green)

Docs README v1.1 - Enhanced

🔄 Workflow

Kaynak: Awesome README

Aşama 1: First Impression

  • Hero: Proje ismi, kısa açıklama ve mümkünse logo/banner ekle.
  • Badges: CI/CD durumu, lisans ve versiyon badge'lerini en üste koy.
  • Demo: Canlı demo linki veya GIF/Screenshot ekle.

Aşama 2: Content Structure

  • Installation: Tek satırlık kurulum komutu (npm install ...).
  • Usage: En yaygın kullanım senaryosu için kod örneği.
  • Contributing: Katkı sağlama rehberine link (CONTRIBUTING.md).

Aşama 3: Maintenance

  • Links: Kırık link kontrolü yap (Link Checker).
  • License: LICENSE dosyası ile README'deki lisans beyanı tutarlı mı?
  • Update: Her major release sonrası README'yi güncelle.

Kontrol Noktaları

AşamaDoğrulama
1Okuyucu projenin ne işe yaradığını 5 saniyede anlıyor mu?
2Kurulum komutları "copy-paste" ile hatasız çalışıyor mu?
3Görseller optimize edilmiş (hafif) ve yükleniyor mu?

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon