इस प्रोजेक्ट के बारे में

यह रिपॉज़िटरी Jon Hill का पोर्टेबल Agent Skills का सार्वजनिक संग्रह है — स्व-निहित, मॉडल- और हार्नेस-अज्ञेय निर्देश जिन्हें AI कोडिंग एजेंट मांग पर लोड कर सकता है। प्रत्येक स्किल अलग से इंस्टॉल करने योग्य है और कुछ भी किसी एक हार्नेस के लिए विशिष्ट नहीं है या निजी टूलिंग पर निर्भर नहीं करता। ## इंस्टॉलेशन `npx skills add jonhill90/skills --list` से संग्रह ब्राउज़ करें, या वर्तमान प्रोजेक्ट में विशिष्ट स्किल्स इंस्टॉल करें: `npx skills add jonhill90/skills --skill tmux --skill github-cli`। `npx skills` CLI पुनरुत्पादन के लिए `skills-lock.json` में कंटेंट हैश द्वारा इंस्टॉल को पिन करता है। यह रिपॉज़िटरी Agent Plugins 1.0.0 प्लगइन के रूप में भी कार्य करती है (रूट में `plugin.json` और `skills/<name>/SKILL.md` पर स्किल्स), और `.claude-plugin/` के माध्यम से Claude Code प्लगइन के रूप में — मार्केटप्लेस जोड़ें `claude plugin marketplace add jonhill90/skills` और इंस्टॉल करें `claude plugin install jonhill90-skills@jonhill90`। प्लगइन का कोई पिन किया गया संस्करण नहीं है, इसलिए यह `main` पर नवीनतम कमिट को ट्रैक करता है और पूरा संग्रह लोड करता है (प्रति सत्र स्किल विवरणों के लगभग 5.6k टोकन)। ## इस संग्रह में स्किल्स संग्रह में 42 स्किल्स शामिल हैं, प्रत्येक में एक अपलोड ऑडिट स्थिति (PASS या FAIL) है जो दर्शाती है कि स्थानीय-मशीन या CLI मान्यताएँ पाई गईं या नहीं। उदाहरणों में शामिल हैं: - `ask-a-council` — कई दृष्टिकोणों से परामर्श करें - `devils-advocate` — मान्यताओं को चुनौती दें - `failing-test-first` — टेस्ट-ड्रिवन डेवलपमेंट - `github-cli` — GitHub CLI का उपयोग - `obsidian` — Obsidian नोट प्रबंधन - `prd` — उत्पाद आवश्यकता दस्तावेज़ - `spec-driven-development` — स्पेसिफिकेशन-प्रथम विकास - `tdd` — टेस्ट-ड्रिवन डेवलपमेंट - `tmux` — tmux टर्मिनल मल्टीप्लेक्सर - और कई अन्य जो योजना, शोध, मेमोरी और सुरक्षित विलोपन जैसे वर्कफ़्लो को कवर करते हैं। ## एक स्किल कहाँ होनी चाहिए README सलाह देता है कि अधिकांश स्किल्स इस रिपॉज़िटरी में नहीं रहनी चाहिए। स्थान उपयोग पर निर्भर करता है: कई असंबंधित प्रोजेक्ट्स में उपयोगी स्किल्स इस जैसे सार्वजनिक संग्रह में होनी चाहिए; केवल एक रिपॉज़िटरी में सत्य स्किल्स उस रेपो के `.claude/skills/` या `.agents/skills/` में होनी चाहिए; और एकबारगी या बाहरी रूप से अनुरक्षित स्किल्स को सीधे `npx skills use <package>@<skill>` के माध्यम से उपयोग किया जा सकता है। ## लेखन अनुबंध प्रत्येक स्किल `skills/<name>/SKILL.md` पर रहती है, वैकल्पिक `scripts/`, `references/`, और `assets/` निर्देशिकाओं के साथ। पोर्टेबल फ्रंटमैटर में `name` और `description` (साथ ही वैकल्पिक `license`, `compatibility`, `metadata`, `allowed-tools`) शामिल हैं। निर्देशिका का नाम `name` से मेल खाना चाहिए, और `SKILL.md` 500 पंक्तियों से कम रहना चाहिए, विवरण लिंक किए गए संदर्भों में स्थानांतरित किया जाना चाहिए। पूर्ण परंपराएँ `AGENTS.md` में हैं। ## सत्यापन रिपॉज़िटरी को सत्यापित करने के लिए `python3 scripts/validate_repository.py` और `python3 -m unittest discover -s tests -v` चलाएँ। CI प्रत्येक पुल रिक्वेस्ट पर और `main` पर पुश पर दोनों चलाता है। ## सामग्री सीमाएँ यह रिपॉज़िटरी केवल पोर्टेबल स्किल सामग्री और न्यूनतम सत्यापन/टेस्ट/CI रखती है। व्यक्तिगत हार्नेस कॉन्फ़िगरेशन (कैनोनिकल निर्देश, हुक, एजेंट, सेटिंग्स, MCP घोषणाएँ, इंस्टॉल/सिंक टूलिंग) एक अलग व्यक्तिगत हार्नेस रिपॉज़िटरी में रहता है। अभी के लिए यहाँ कोई व्यवहारिक eval प्रणाली नहीं है; एक समुदाय-अनुरक्षित प्रतिस्थापन issue #309 में ट्रैक किया गया है। नियोक्ता-स्वामित्व वाली या प्रोजेक्ट-विशिष्ट सामग्री यहाँ कभी कॉपी नहीं की जाती।