संदर्भ
स्किल
SKILL.md फ़ाइलों में पुन: प्रयोज्य, पहचान-योग्य तकनीकें, प्लान सूट और इकोसिस्टम ऑडिट के लिए पहचान संकेतों, प्रक्रियाओं और प्रवर्तन हुक के साथ।
स्किल src/apothem/skills/ के अंतर्गत फ़ोल्डरों के रूप में रहती हैं, प्रत्येक में
एक SKILL.md एंट्री पॉइंट होता है। स्किल पुन: प्रयोज्य, पहचान-योग्य तकनीकों को
समेटती हैं — उनमें एक पहचान संकेत, एक प्रक्रिया और एक प्रवर्तन हुक होता है।
पूरी स्किल सूची नीचे जनित स्किल इन्वेंट्री में जनित होती है।
Frontmatter अनुबंध
SKILL.md विहित आठ-कुंजी frontmatter रखती है। मशीन-पठनीय अनुबंध
skill.schema.json
(additionalProperties: false) है; यह ब्लॉक उसी को प्रतिबिंबित करता है:
---
name: <skill name>
version: <semver>
updated: <YYYY-MM-DD>
description: <one-line role>
archetype: <class-template, e.g. workflow-template>
userInvocable: <true | false>
disable-model-invocation: <true | false>
allowed-tools: <comma-separated read-only tools and scoped rules, e.g. "Read, Glob, Grep" or "Read, Bash(git log *)">
---प्रति-हार्नेस उत्सर्जन
स्रोत स्किल ऊपर दी गई कुंजियों का उपयोग करती हैं। कुछ हार्नेस अलग कुंजियाँ पढ़ते हैं, इसलिए इंस्टॉल केवल उसी हार्नेस के लिए उनका अनुवाद करता है:
| हार्नेस | इंस्टॉल क्या बदलता है |
|---|---|
| Claude Code (इंस्टॉल और प्लगइन) | userInvocable का नाम बदलकर user-invocable करता है, वह कुंजी जिसे Claude Code पढ़ता है। Claude Code camelCase कुंजी को अनदेखा करता है, इसलिए नाम बदले बिना userInvocable: false चिह्नित स्किल फिर भी / मेनू में दिखाई देती। |
साझा उपयोगकर्ता-स्तरीय स्किल फ़ोल्डर: ~/.agents/skills/ (Codex, Cursor, GitHub Copilot, Windsurf, और Zed द्वारा लिखा गया) तथा ~/.codebuddy/skills/, ~/.kiro/skills/, और ~/.trae/skills/ | इनमें से किसी एक फ़ोल्डर को लिखने वाले हर इंस्टॉल के लिए एक ही रूप, ताकि इंस्टॉल कभी एक-दूसरे की फ़ाइलें दोबारा न लिखें। यह userInvocable का नाम बदलकर user-invocable करता है, version, updated, archetype, और portability को उद्धृत स्ट्रिंग के एक अंतिम metadata: मैप के अंतर्गत ले जाता है, और हर उस स्किल के बगल में policy.allow_implicit_invocation: false के साथ agents/openai.yaml लिखता है जिसका स्रोत disable-model-invocation: true सेट करता है, क्योंकि Codex उस कुंजी को अनदेखा करता है और ~/.agents/skills/ को पढ़ता है, चाहे उसे किसी Codex अडैप्टर ने लिखा हो या नहीं। स्किल के रूप में लपेटा गया कमांड अपना मुख्य भाग पूरा रखता है और एक निश्चित टिप्पणी से शुरू होता है जो नियम और टेम्पलेट फ़ोल्डरों, ~/.config/apothem/rules/ और ~/.config/apothem/templates/, का नाम बताती है। बची हुई शीर्ष-स्तरीय कुंजियाँ name, description, user-invocable, disable-model-invocation, allowed-tools, argument-hint, और metadata हैं। |
| Qwen Code | अल्पविराम-विभाजित allowed-tools स्ट्रिंग को एक allowedTools सूची के रूप में, प्रति पंक्ति एक YAML प्रविष्टि, दोबारा लिखता है, क्योंकि Qwen Code केवल camelCase कुंजी पढ़ता है और एक सूची की माँग करता है। हर प्रविष्टि स्रोत की वर्तनी बनाए रखती है, जिसमें Bash(git status *) जैसे पैटर्न शामिल हैं। हर अन्य कुंजी और स्किल का मुख्य भाग अपरिवर्तित इंस्टॉल होते हैं। |
| अन्य हार्नेस | कोई परिवर्तन नहीं। |
skill.schema.json उपयोगकर्ता-आह्वान-योग्यता फ़्लैग की दोनों में से कोई भी
वर्तनी स्वीकार करता है और ठीक उनमें से एक की माँग करता है।
लेखन अनुशासन
- प्रति-स्किल फ़ोल्डर। हर स्किल अपना स्वयं का फ़ोल्डर है, जिसका एंट्री पॉइंट
SKILL.mdपर है। - पहचान संकेत। स्किल के मुख्य भाग उस पहचान संकेत से शुरू होते हैं जो तकनीक को ट्रिगर करता है।
- प्रक्रिया + प्रवर्तन। स्किल दोनों रखती हैं — लागू करने की प्रक्रिया और लूप को बंद करने वाला प्रवर्तन संकेत।
- विवरण की लंबाई।
descriptionअधिकतम 1,024 वर्णों का होता है, जो Agent Skills की सीमा है। अधिक सख़्त टूल लंबे विवरण को अस्वीकार कर देते हैं या काट देते हैं, और स्कीमा इस सीमा को लागू करता है।
जनित स्किल इन्वेंट्री
| Name | Description | Source |
|---|---|---|
decision-matrix | Choose between two or more options with a weighted, evidence-cited matrix, a runner-up and a first step. Use when the user asks to 'compare these options', 'help me choose between', 'weigh the trade-offs' or 'which one should we pick'. Not for single-answer lookups or building a chosen option. | src/apothem/skills/decision-matrix/SKILL.md |
dependency-upgrade | Upgrade a project's third-party dependencies with changelog review, pinned versions and the host's lint, test and type-check gates. Runs only when the user invokes it (for example to bump deps or refresh the lockfile). Breaking and major bumps stop for a question; --dry-run classifies without writing; --package NAME scopes to one dependency. | src/apothem/skills/dependency-upgrade/SKILL.md |
dev-toolkit | Run a disciplined engineering loop: reproduce-first debugging, test-first red-green-refactor, vertical slices, or a requirement split into issues. Use for 'diagnose a bug', 'do TDD', 'break this into vertical slices' or 'turn this into issues'. Not for one-line edits or multi-agent orchestration. | src/apothem/skills/dev-toolkit/SKILL.md |
diagram-authoring | Author, validate and render diagrams (flowchart, sequence, state, ER, architecture) and data visualizations to SVG, PNG or PDF. Use when the user asks to 'draw a diagram', 'make a flowchart', 'render this Mermaid' or 'export a diagram to SVG'. Source is syntax-validated before render. | src/apothem/skills/diagram-authoring/SKILL.md |
document-authoring | Write a long, cited document (thesis, report, LaTeX) from an approved outline, with checked citations and a PDF compile. Use when the user asks to 'write a thesis', 'author a LaTeX document', 'compile this to PDF' or 'manage the bibliography'. Not for short edits; pipeline papers: research-paper. | src/apothem/skills/document-authoring/SKILL.md |
ecosystem-audit | Audit the apothem configuration tree as a whole for drift, orphans, dangling references and invalid frontmatter. Use when the user asks to 'audit the ecosystem', 'validate the apothem tree' or 'sweep for drift'. Report-only unless --fix is passed. Changed artifacts only: convention-auditor. | src/apothem/skills/ecosystem-audit/SKILL.md |
eval-harness | Build a reproducible evaluation harness for a prompt or model: versioned labeled dataset, scorer, runner and a report with pass rate, interval and regressions. Use when the user asks to 'build an eval' or 'compare models on a labeled task'. One campaign: eval; rubric scoring: prompt-evaluator. | src/apothem/skills/eval-harness/SKILL.md |
incident-runbook | Write or run an incident runbook (Trigger, Diagnosis, Action, Verification, Rollback) with a rollback per action and confirmation before live changes. Use when the user asks to 'write a runbook', 'define an on-call procedure' or 'document recovery steps'. Not for post-mortems. | src/apothem/skills/incident-runbook/SKILL.md |
issue-lifecycle | Takes a reported defect from issue to fix, one stage per run. Use for 'create an issue', 'size this issue', 'reproduce this bug', 'fix issue 123', 'ask the reporter for details' or 'open a draft PR'. Manual only; posts nothing unasked. Debug loops go to dev-toolkit, advisories to vuln-triage. | src/apothem/skills/issue-lifecycle/SKILL.md |
knowledge-wiki | Adds sources to and audits an index-first Markdown knowledge base, when the user asks to 'add this paper to the wiki', 'ingest these sources', 'lint the wiki' or 'what changed in the knowledge base'. Modes: ingest, lint, drift, hubs. Not source discovery or a one-off summary. | src/apothem/skills/knowledge-wiki/SKILL.md |
multi-source-research | Produces a cited, cross-verified research report with confidence levels, when the user asks to 'research X deeply', 'find sources on' or 'gather evidence about'. Finds new sources and writes the report; given documents: source-synthesis, one claim: fact-checker, a bare source list: research-scout. | src/apothem/skills/multi-source-research/SKILL.md |
paper-toolkit | Papers with no research suite: 'write a reading note', 'compare these papers', 'draft related work', 'what would reviewers ask', 'dedupe my references', 'turn DOIs into BibTeX entries'. Suite or referee review: research-* commands. Reference checks: citation-auditor. Loose files: source-synthesis. | src/apothem/skills/paper-toolkit/SKILL.md |
perspectives | Answers a contested question by arguing it from several separate viewpoints, then reconciling them, when the user asks to 'argue both sides', 'what would a skeptic say' or 'we are split on'. Weighted choices go to decision-matrix, claim checks to fact-checker, builds and reviews to workflow. | src/apothem/skills/perspectives/SKILL.md |
plan-suite | Master Plan Suite template, read by path by the /plan pipeline stages (spec, generate, review, design, audit, execute, status, amend). Holds master-template.md, the canonical plan-suite specification. A template, not invoked directly and not listed; use the /plan commands instead. | src/apothem/skills/plan-suite/SKILL.md |
projectify | Builds the Description, Instruction and knowledge files for a chat-app Project or custom assistant within a measured context budget, when the user asks to 'projectify this', 'write Project instructions' or 'set up a custom assistant'. Not for repository rules, skills or commands. | src/apothem/skills/projectify/SKILL.md |
prompt-engineering | Designs a structured prompt and validates it against happy, edge and adversarial eval cases, when the user asks to 'design a prompt', 'write a system prompt for' or 'improve this prompt'. Delivers the prompt plus its eval set; not a running agent or a model benchmark (eval-harness). | src/apothem/skills/prompt-engineering/SKILL.md |
refactor-extract | Extracts a symbol or file without changing behavior, interactively: specifies what it does, re-derives it clean-room, then checks nothing regressed, when the user asks to 'extract this function' or 'pull this out into its own module'. Delegated refactors: refactor-surgeon. | src/apothem/skills/refactor-extract/SKILL.md |
research-suite | Research Suite template, read by path by the /research pipeline stages (ideate through disseminate). Holds the canonical research-suite surface: the ten rigor mandates and the thirteen-stage lifecycle. A template, not invoked directly and not listed; use the /research commands instead. | src/apothem/skills/research-suite/SKILL.md |
secret-rotation | Use when a credential has leaked or been committed ('rotate a secret', 'a key leaked') and must be retired safely: revokes the exposed secret at its issuer first, re-issues a least-privilege replacement, rewires config through env vars or a secret manager, then checks no plaintext remains. Runs only when the user invokes it. | src/apothem/skills/secret-rotation/SKILL.md |
source-synthesis | Reconciles given documents into one cited synthesis separating consensus from contested claims, when the user asks to 'synthesize these sources', 'combine these documents' or 'what do these say together'. Needs two or more sources. Finding them: multi-source-research; gap map: research-synthesis. | src/apothem/skills/source-synthesis/SKILL.md |
surgical-guard | Makes a minimal, anchor-bounded edit, then reviews only its diff for swallowed errors, hollow tests and docs drift, when the user asks to 'edit surgically', 'make a minimal diff' or 'guard this change'. Not for working out what the change should be (dev-toolkit). | src/apothem/skills/surgical-guard/SKILL.md |
teaching-pack | Builds a teaching pack from one paper or technical document: goals, curriculum, formula walk-throughs, worked examples, quiz with key, glossary, slides on request. For 'teach me this paper' or 'make a study guide from this spec'. Several sources: source-synthesis; critique: research-review. | src/apothem/skills/teaching-pack/SKILL.md |
test-authoring | Writes new behavior-first tests in Arrange-Act-Assert form, failing assertions first, covering happy path, edge boundaries and failures, when the user asks to 'write tests' or 'test this function'. Authors tests only. Whole-repo suite: test-suite; running tests: test-runner. | src/apothem/skills/test-authoring/SKILL.md |
ui-design | Designs or refines a user interface: classifies the surface, applies design rules and keeps DESIGN.md current, when the user asks to 'design a landing page', 'improve this UI', 'make it look better' or 'pick a palette and type scale'. Not for critique-only review (design-critic) or backend logic. | src/apothem/skills/ui-design/SKILL.md |
vuln-triage | Triages one named CVE or security advisory: severity band, affected surface in the lockfile, reachability, and a patch, upgrade, mitigate or accept route, when the user asks to 'triage this CVE' or 'does this advisory affect us'. Does not apply fixes or scan the whole repository. | src/apothem/skills/vuln-triage/SKILL.md |
workflow | Use for a non-trivial mission that needs independent parallel work plus adversarial verification: decomposes it, dispatches independent subagents under named return contracts, runs a refute-by-default critique on every finding, and discloses any beyond-mission fixes. Runs only when the user invokes it, as in 'fan out and verify'. | src/apothem/skills/workflow/SKILL.md |
नियम
व्यवहार-नियम सेट में समस्या-समाधान, कोड शिल्प, क्लीन आर्किटेक्चर, योजना और गुणवत्ता को नियंत्रित करने वाले सदैव-सक्रिय और पथ-फ़िल्टर किए गए व्यवहार-नियम।
कमांड
प्लान-सूट पाइपलाइन को लागू करने वाली स्लैश-कमांड परिभाषाएँ, साथ ही कोड, आर्किटेक्चर, सुरक्षा, निर्भरताओं और दस्तावेज़ीकरण समीक्षा के लिए ऑडिट।