Borrowing it
Nothing to install: this file belongs to mash-up-kr/Team-MINO-Android. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/mash-up-kr/Team-MINO-Android/develop/.claude/skills/adr-writer/SKILL.mdgit clone --depth 1 https://github.com/mash-up-kr/Team-MINO-AndroidWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/mash-up-kr/team-mino-android/adr-writer)<a href="https://agentmods.dev/skills/mash-up-kr/team-mino-android/adr-writer"><img src="https://agentmods.dev/badge/skills/mash-up-kr/team-mino-android/adr-writer/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/mash-up-kr/team-mino-android/adr-writer"><img src="https://agentmods.dev/badge/skills/mash-up-kr/team-mino-android/adr-writer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00119 | $0.01585 |
| Opus 5.5 | $0.00048 | $0.00634 |
| Sonnet 5.5 | $0.00024 | $0.00317 |
| Haiku 4.5 | $0.00012 | $0.00159 |
Grade A, and why
adr-writer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 79 lines — stays where its author put it; the contents beside it link to each section on GitHub.
adr-writer — 대화 중 자동 ADR 기록
이 Skill의 목적은 문서 자체가 아니라 미래 세션의 토큰 절감이다. 결정 당시의 맥락과 이유를 놓치지 않고 남겨서, 나중에 다른 세션(다른 사람 또는 다른 Claude 인스턴스)이 "왜 이렇게 했지?"를 처음부터 재조사·재논의하지 않게 한다.
입력 (트리거 조건 — 스킬 실행 시 판단 기준)
명시적 파라미터 없이, 대화 중 아래 신호가 확정되는 순간(제안·검토 단계가 아니라 결론이 난 시점) 자동으로 판단한다. 강도 순으로 4단계이며, 마지막 안티-트리거를 반드시 함께 확인한다.
1. AskUserQuestion 호출 — 가장 강한 트리거
AskUserQuestion 호출 그 자체가 "대안이 여러 개 있고 자명하지 않아 사람에게 물었다"는 신호다. 구조가 이미 ADR 재료와 대응한다: options → 고려한 대안, 각 option의 description → 트레이드오프, 사용자가 고른 답 → 결정, question → 맥락.
단, 아래를 모두 만족할 때만 ADR감이다:
- 선택이 코드 한 곳이 아니라 앞으로의 방향·제약에 영향을 준다 (예: "네비게이션을 Activity Launcher로 vs NavHost로")
- 되돌리려면 여러 파일 수정·재합의가 필요하다
- 파일명 A/B, 문구 확인처럼 일회성 확인은 제외한다
2. 대화 흐름에서의 의미 기준 트리거
AskUserQuestion 없이 자연어 대화 중에도 아래 신호가 나타나면 결정이 굳은 것으로 본다.
| 트리거 | 감지 신호 예시 |
|---|---|
| 기술 선택·교체 | "X 라이브러리 쓰자", "Y 대신 Z로 바꾸자", 빌드·의존성 방향 결정 |
| 구조·경계 결정 | 모듈 분리, 레이어 규칙, 공개 표면 범위, 패키지 책임 재정의 |
| 배제 결정 (안 하기로 함) | "이 우회책은 쓰지 말자", "@OptIn 박지 말자" |
| 명시적 트레이드오프 | 2개 이상 대안을 비교하고 하나를 이유와 함께 채택 |
| 컨벤션 신설·변경 | 네이밍·커밋·워크플로 규칙을 새로 정하거나 기존 규칙을 뒤집음 |
| 되돌리기 비용 큼 | 마이그레이션, 데이터·직렬화 포맷, 공개 API 시그니처 |
| 반복되는 논의 | 예전에 정한 걸 또 묻는 상황 → 기록해서 재논의 막기 |
3. 사용자 발화 기준 트리거 — 명시적 의도
아래와 같은 발화는 확신도가 높은 즉시 트리거다.
- "이건 기록해두자 / 남기자 / 나중에 헷갈릴 것 같다"
- "왜 이렇게 했는지 이유를 남겨야"
- "다음에 또 이 고민 하지 않게"
4. 안티-트리거 — 반드시 제외 (노이즈 방지)
자동화의 최대 위험은 사소한 걸 ADR로 남겨 인덱스를 오염시키는 것이다. 아래는 트리거 신호처럼 보여도 남기지 않는다.
- 순수 구현 세부 (변수명, 지역적 리팩터, 파일 위치)
- 이미 문서·컨벤션에 있는 규칙을 그대로 따른 것 (SSOT 재기록 금지)
- 일회성·임시 우회
- 버그 수정 그 자체 (단, "이 방식으로 고치기로 하고 다른 방식은 배제"처럼 정책성 결정이면 대상)
위 기준을 통과해도 애매하면 남기는 쪽보다 사용자에게 "이거 ADR로 남길까요?" 한 줄로 먼저 확인한다.
작업 순서
- 같은 폴더의
adr-format.md를 먼저 Read해 파일명·상태 값·템플릿 형식을 확인한다. 이 Skill 안에서 형식을 재정의하지 않는다. - 대화 맥락에서 아래를 추출한다.
- 컨텍스트: 이 결정이 필요했던 배경, 제약 조건
- 결정: 무엇을 선택했는가
- 근거: 결정 자체와 분리해, 그 결정을 뒷받침하는 이유·트레이드오프
- 결과: 시스템에 미치는 영향, 후속 지침
- 고려한 대안: 채택하지 않은 다른 선택지와 배제 이유
- 작성일: 오늘 날짜
- 작성자: 대화에서 알 수 없으므로
git config user.name값으로 채운다
adr-format.md의 템플릿에 맞춰 새 ADR 파일을 작성한다. 상태는 기본Accepted(사용자가 확정한 결정이므로) — 아직 논의 중이면Proposed.docs/adr/README.md인덱스 표에 새 줄을 추가한다.- 이 결정이 기존 ADR을 대체하는 것이라면,
adr-format.md의 상태 규칙에 따라 기존 ADR의 상태를 갱신한다(README 인덱스의 상태 셀도 함께).
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- today First seen · 79 lines · 119 tokens per session scan A 8ea45f52ccd4
adr-writer is a skill published in the GitHub repository mash-up-kr/Team-MINO-Android (7 stars, last pushed 16d ago), licensed Apache-2.0. It adds 119 tokens to every session and 1,585 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-02.
Other skills, from other repositories
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
next-cache-components-adoption
Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…
chat-pet-sprite-creation
Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.
cpu-profile-analysis
Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…
insight-error-page
Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…
next-cache-components-optimizer
Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next/playwright instant() e2e and work it to green, one verified route at a time; the shipped test then…