projelerden
agent-skills-mcp
Markdown skill'leri tek bir MCP sunucusu üzerinden yayınlayan açık kaynak template. Claude, Cursor, kendi agent'ın — hepsi aynı kaynaktan okur.
agent-skills-mcp, Anthropic'in SKILL.md formatına dayalı markdown skill'leri tek bir MCP sunucusu üzerinden yayınlamanı sağlayan açık kaynak bir template'tir. Bir kere skill yaz — Claude, Cursor, kendi yazdığın agent, MCP konuşan ne varsa hepsi aynı kaynaktan okuyor.
- Üç MCP tool: list_skills, get_skill, read_skill_file
- Anthropic SKILL.md formatı (progressive disclosure)
- /skills'te REST view ile elle inceleme
- Streamable HTTP transport
- MIT lisanslı, Node ≥ 18
Nasıl çalışıyor?
Skill'ler, sunucunun skills/ klasörü altındaki markdown dosyalarıdır. Her skill bir klasör; içinde SKILL.md (YAML frontmatter + body) ve isteğe bağlı reference/ ve examples/ dosyaları yer alır. Sunucu açıldığında bu yapıyı tarar ve agent'lara üç tool üzerinden sunar: önce katalog, sonra SKILL.md, gerektiğinde ek dosyalar. Kod yok, plugin yok, sadece markdown.
Kurulum
Repoyu forkla, skills/ altına markdown skill'lerini bırak, deploy et. Klone'dan canlı URL'ye yaklaşık 5 dakika. Node çalışan herhangi bir yere kurulur — Railway, Render, Fly, Coolify ya da kendi VPS'in.
Tek dikkat noktası
Sunucu uzun-ömürlü bir Node process. Vercel/Netlify gibi serverless platformlar Streamable HTTP'de timeout sorunu çıkarabilir. Long-running Node destekleyen platformlar (Railway, Render, Fly, Coolify) tercih edilir.
Hangi durumlar için ideal?
- Birden fazla projede aynı kodlama standartlarını ve commit kurallarını paylaşmak
- Şirket içinde her developer'ın aynı skill setiyle agent çalıştırması
- Skill'leri proje klasöründen çıkarıp tek merkezden güncelleyebilmek
- Claude, Cursor ve kendi agent'larının ortak bir bilgi tabanından okuması
Açık kaynak ve template — kendi instance'ını kurup kendi domain'inde çalıştırırsın. Skill'lerin sende kalır, dışarıya bir şey gitmez. Canlı bir örnek için demo landing'e bakabilirsin.