hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-skill
hyper-skill
FlaggedUse this skill when the user asks to create or refactor a reusable agent skill folder, including SKILL.md trigger wording, instruction contracts, rules, references, scripts, assets, and validation checks. Do not use for generic documentation that is not a skill.
rules/self-containment.ko.md
View on GitHub# 자립성 (Self-Containment)
**목적**: 스킬이 자기 폴더만으로 쓸 수 있게 유지합니다. 다른 스킬이 설치되어 있거나 호출되거나 존재해야만 동작하는 상태를 만들지 않습니다.
스킬은 배포 단위입니다. 다른 스킬을 이름으로 가리키거나 경로로 가리키거나 그 스킬의 명령 실행을 요구하면, 이 스킬만 설치한 사람은 가리키는 대상을 찾지 못합니다. 해결책은 이웃 스킬을 함께 설치하게 만드는 것이 아니라, 필요한 내용을 이 폴더 안으로 가져오거나 경계를 이름 없이 서술하는 것입니다.
## 1. 규범 규칙
- SK-S-1: 스킬은 자기 폴더만으로 온전합니다. 다른 스킬의 설치, 호출, 경로, 문서를 요구하지 않습니다. 바깥의 내용이 꼭 필요하면 그 대상을 가리키는 대신 이 스킬의 `references/`에 로컬 스냅샷으로 복사합니다. 다른 스킬의 경로를 담은 저장소 유지보수 명령이 대표적인 경우인데, 이런 명령은 스킬 산출물에 두지 않습니다. 저장소 정책 문서가 그 명령을 소유합니다.
- SK-S-2: 경계는 상대 스킬의 이름이 아니라 산출물의 형태로 서술합니다. "산출물이 재사용 가능한 스킬 폴더일 때 이 스킬을 쓰고, 일반 문서와 런북, 프롬프트, 계획은 범위 밖이다"라고 쓰면 트리거 경계는 그대로 유지되고 다른 스킬 이름은 남지 않습니다. 이웃 이름을 쓰면 읽는 사람이 해석할 수 없는 참조가 생깁니다.
- SK-S-3: 예외는 사용자 지시뿐입니다. 사용자가 다른 스킬 참조를 명시적으로 요구하면 그 이름에 대해 `--allow <형제 이름>`으로 검사를 돌리고, 발견 항목은 경고로 남겨 보이게 하며, 지시 내용을 작업 기록에 남깁니다. 예외가 기본값이 되지는 않습니다.
## 2. 검출 규칙
`skills/hyper-skill/scripts/validate-hyper-skill.sh`의 `checkSelfContainment`가 패키지 안 텍스트 파일을 훑어 다음을 찾습니다.
- 하이픈이 들어간 형제 스킬 이름이 맨이름이나 백틱 형태로 나오는 경우. 경계는 더 긴 식별자를 제외하도록 잡아서, 확장된 이름을 그 앞부분으로 잘못 읽지 않습니다.
- 형제 스킬 이름이 `$<이름>` 호출 형태로 나오는 경우.
- 형제 스킬 이름이 `skills/<이름>/` 경로 조각으로 나오는 경우.
형제 이름은 패키지 루트 옆의 디렉터리에서 가져오고, `SKILL.md`를 가진 디렉터리만 스킬로 봅니다. 기본 모드에서 이 검사는 이 계약을 채택한 패키지에는 오류를, 그 밖의 패키지에는 경고를 냅니다. `--require-self-containment`는 패키지 이름과 무관하게 발견 항목을 오류로 올립니다. 이 스킬이 새로 만든 스킬에 쓰는 모드가 그것입니다. 이 모드는 경로 규칙도 넓혀서, 패키지 자신의 경로가 아닌 `skills/<이름>/` 경로를 그 스킬이 옆에 설치되어 있지 않아도 보고합니다. 따로 배포되었거나 옮겨진 패키지도 잡기 위해서입니다. `$<이름>` 형태는 두 모드 모두에서 형제 기반으로 남습니다. 벤더 런타임 내장 기능이 같은 문법을 쓰기 때문입니다. `--allow <형제 이름>`(반복 가능)은 사용자 지시에 따른 예외를 기록합니다.
## 3. 한계
- 단어 하나짜리 형제 이름은 산문이나 백틱 형태로 검출하지 않습니다. 능력 이름으로도 쓰이는 보통 단어와 구별되지 않기 때문입니다. `$<이름>` 형태와 `skills/<이름>/` 형태만 검출합니다. 산문 형태는 저자가 직접 피합니다.
- 검출은 텍스트를 읽으므로, 조각을 실행 시점에 이어 붙여 만든 참조는 보지 못합니다.
- 이 검사는 자기가 아는 형태가 없다는 것을 증명합니다. 스킬이 혼자 동작한다는 것까지 증명하지는 않습니다. 그 확인은 스킬을 직접 읽고 돌려야 합니다.
## Sources
> Links checked 2026-09-21.
| Claim | Source |
|---|---|
| The self-containment requirement, the output-shape boundary rule, and the user-instruction-only exception | user instruction, 2026-09-21 |
| The detection rules, the `--require-self-containment` and `--allow` flags, and the sibling-name discovery | `skills/hyper-skill/scripts/validate-hyper-skill.sh` |
| One canonical home per rule and a lean core, which is why this rule lives in one file instead of being restated in the core | `rules/progressive-disclosure.md` |
### Evidence grade
`LOCAL` - 이 규칙은 저장소 정책과 사용자 지시를 서술합니다. 외부 주장이 아니고, 어떤 벤더 문서도 근거로 인용하지 않습니다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 197k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |