hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-documentation
hyper-documentation
Flagged[Hyper] Use this skill when the user asks to create, refactor, or update a documentation artifact: a project or package README.md, a repository AGENTS.md with its AGENTS.ko.md mirror, an AI-readable instruction base, runbook, specification, or rule pack, a reusable prompt, prompt template, prompt pack, or prompt eval fixture, or an agent's persistent memory files (MEMORY.md index, memory bank, lessons file) with their write, pruning, and deletion rules. It picks one mode from the requested output and grounds every claim in the project and its sources. Do not use for reusable skill folders, CHANGELOG, CONTRIBUTING, LICENSE, release notes, answer-only research, or implementation work; it never writes CLAUDE.md.
rules/agents-md/nested-placement.ko.md
View on GitHub# 중첩 배치
**목적**: 기록한 측정을 바탕으로 디렉터리에 별도 `AGENTS.md`를 둘 가치가 있는지 판정한다. 이는 패키지 heuristic이며 저장소를 실제로 읽는 일을 대신하지 않는다.
## 1. 점수의 성격
배치 점수는 자식 파일을 정당화하는 게이트다. 모든 보고에 패키지 heuristic으로 표기해 vendor 기준이 아닌 것으로 분명히 한다. 디렉터리는 그 하위 트리가 스스로 관할할 만큼 다르다고 점수가 말할 때만 자식 `AGENTS.md`를 가진다. 그렇지 않으면 부모가 그 영역을 담당한다.
점수가 저장소 전체를 쓸어내는 일로 이어지게 하지 않는다. 전체 계층을 한 번에 다시 잡는 bulk hierarchy run은 사용자가 명시적으로 요청했을 때만 하고, 점수는 검토 대상인 자식 파일 하나만 정당화한다.
## 2. 신호와 가중치
각 신호는 저장소 근거가 있을 때만 측정한다. 측정할 수 없는 신호는 `unmeasured`이며, `unmeasured`는 절대로 0으로 취급하지 않는다.
| 신호 | 측정 대상 | 가중치 |
|---|---|---|
| 파일 수 | 하위 트리의 소스 파일 | 2 |
| 하위 디렉터리 수 | shipped code가 담긴 직속 자식 디렉터리 | 2 |
| 코드 비율 | 문서나 데이터가 아니라 코드인 비율 | 2 |
| 고유 패턴 | 하위 트리 안에 있는 서로 다른 build·test·규칙 패턴 | 5 |
| 모듈 경계 | 하위 트리가 넘는 package·workspace·소유 경계 | 3 |
| 심볼 밀도 | 파일당 exports와 entry point | 1 |
| exports | 하위 트리가 소유한 공개 진입점 | 1 |
| 참조 중심성 | 부모 규칙과 이웃 파일이 이 하위 트리를 가리키는 정도 | 2 |
측정한 신호들의 가중치를 합산한다. `unmeasured` 항목은 합계에 넣지 말고 이름 그대로 run snapshot에 적는다.
## 3. 기준치
| 점수 | 판정 |
|---|---|
| 15 초과 | 하위 트리에 자식 `AGENTS.md`가 생긴다 |
| 8 이상 15 이하 | 점수에 덧붙여 뚜렷한 영역 차이가 있어야 자식 파일이 생긴다 |
| 8 미만 | 부모가 그 영역을 담당한다. 자식 파일을 만들지 않는다 |
같은 저장소에서 같은 점수는 두 run에서 다른 계층을 만들지 않는다. 두 run을 비교할 수 있도록 run snapshot에 측정한 내용을 기록한다.
## 4. 깊이 예산
깊이 예산은 기본값 3이며 생성만 제한한다. 예산보다 깊은 자식 파일은 만들지 않는다. 예산은 예산보다 깊은 기존 파일을 지우지 않는다. 예산보다 깊은 기존 파일은 그대로 둔다. 삭제는 사용자가 명시적으로 요청했을 때만 한다.
## 5. 점수 근거 행
각 배치 판정은 점수, 신호별 값, `unmeasured` 항목, 깊이, 예산을 함께 기록한다. 그 행이 없는 배치는 정당하지 않은 것이다.
## Sources
> 링크 확인 2026-11-09. 소스 저장소에서 텍스트나 코드를 복사하지 않았다. 메커니즘은 이 package의 표현으로 다시 썼다.
| 주장 | 출처 |
|---|---|
| 이 파일의 가중 신호, 15 초과와 8 이상 15 이하 기준치, 패키지 heuristic 표기, 기본값 3인 깊이 예산, 예산 아래 파일을 지우지 않는 규칙 | `dbc-hbin/omp-ulw`의 커밋 `74df40f` (2026-11-09). 소스 저장소에 license가 없어 메커니즘을 다시 썼고 복사하지 않았다 |
### Evidence grade
`HEURISTIC` - 이 점수는 위 소스에서 다시 쓴 이 패키지 자체의 판정 보조이며 vendor 기준으로 검증되지 않았다.
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: 468k | 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 |