Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Dannykkh/skill-olympus --skill project-gotchasgit clone --depth 1 https://github.com/Dannykkh/skill-olympusWrote 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/dannykkh/skill-olympus/project-gotchas)<a href="https://agentmods.dev/skills/dannykkh/skill-olympus/project-gotchas"><img src="https://agentmods.dev/badge/skills/dannykkh/skill-olympus/project-gotchas.svg" alt="Measured on agentmods" 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.00200 | $0.02868 |
| Opus 5 | $0.00100 | $0.01434 |
| Sonnet 5 | $0.00040 | $0.00574 |
| Haiku 4.5 | $0.00020 | $0.00287 |
Grade A, and why
project-gotchas 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 3d ago.
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 — 235 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Project Gotchas (오답노트 + 성공 패턴)
CLI의 실패 패턴과 성공 패턴을 자동 수집하고 명시적으로 정제합니다.
글로벌 설치 1회로 어떤 프로젝트에서든 자동 작동합니다.
므네모(mnemo)가 생성하는 memory/ 폴더 안에 관리하여 Claude/Codex/Antigravity/Grok 모두 참조 가능합니다.
단순 오타·일회성 실수·이미 전역 지침에 등록된 규칙은 새 항목으로 만들지 않습니다.
2계층 저장 구조
어떤-프로젝트/memory/
├── gotchas/ ← 실패 패턴 (오답노트)
│ ├── index.md
│ ├── observations.jsonl ← 에러 관찰 로그 (자동 생성)
│ ├── 001-특정API-반올림주의.md
│ └── 002-빌드설정-함정.md
└── learned/ ← 성공 패턴 (학습 노트)
├── index.md
├── observations.jsonl ← 성공 관찰 로그 (자동 생성)
├── 001-grep-먼저-edit-나중에.md
└── 002-테스트-먼저-구현-나중에.md
memory/폴더가 없으면 자동 생성- 므네모가 이미
memory/를 관리하므로 별도.gitignore처리 불필요 - Claude, Codex, Antigravity 어떤 CLI에서든 접근 가능
참조 순서
- 글로벌 글로벌 스킬 레포의
memory/gotchas/+memory/learned/확인 - 프로젝트 현재 프로젝트의
memory/gotchas/+memory/learned/확인 - 현재 작업과 관련된 키워드 매칭 → 해당 파일만 읽기
저장 범위 판단
| 범위 | 기준 | 예시 |
|---|---|---|
| 글로벌 | CLI 버릇, OS/도구 함정, 프레임워크 공통 패턴 | YAML 파싱, PowerShell 성능, 서브에이전트 return 폭발 |
| 프로젝트 | 특정 API, 특정 라이브러리 설정, 프로젝트 고유 규칙 | 특정 DB 스키마, 사내 API 주의점, 빌드 설정 |
판단이 애매하면 사용자에게 "글로벌과 프로젝트 중 어디에 기록할까요?" 확인.
기록 유형
| 유형 | 설명 | 예시 |
|---|---|---|
| CLI 오답 | Claude/Codex/Antigravity가 반복 실수하는 패턴 | return text 폭발, YAML 형식 오류 |
| 환경 함정 | OS/도구/라이브러리의 예상치 못한 동작 | PowerShell tail 성능, .bat 인코딩 |
| 설치 함정 | dependency 누락, 설정 오류 | node_modules 누락 handshake 실패 |
워크플로우
1. 참조 (작업 시작 시)
- 글로벌
memory/gotchas/index.md존재 여부 확인 - 프로젝트
memory/gotchas/index.md존재 여부 확인 - 양쪽 인덱스에서 현재 작업과 관련된 키워드 매칭
- 매칭된 항목의 개별 파일만 읽기 (전체 읽기 금지)
2. 기록 (사용자 요청 또는 자발적 제안)
기록 트리거:
- 사용자가 "실수였어", "gotcha 추가", "오답노트" 등 요청
- CLI가 실수를 수정당한 후 반복 가능한 패턴이라 판단되면 자발적 제안
기록 절차:
- 저장 범위 판단 (글로벌 vs 프로젝트)
memory/gotchas/디렉토리가 없으면 자동 생성index.md가 없으면 빈 인덱스 테이블로 초기화- 기존 파일명에서 마지막 번호 확인 → 다음 번호로 파일 생성
index.md테이블에 행 추가
3. 자발적 제안 판단 기준
기록을 제안할 것:
- CLI가 2회 이상 같은 유형의 실수를 했을 때
- 사용자가 "아까도 그랬잖아" 류의 지적을 했을 때
- 환경/도구의 문서화되지 않은 동작을 발견했을 때
What ships with it
2 files 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.
- 3d ago First seen · 235 lines · 200 tokens per session scan A 3e420633b1f4
project-gotchas is a skill published in the GitHub repository Dannykkh/skill-olympus (5 stars, last pushed yesterday), licensed MIT. It adds 200 tokens to every session and 2,868 once invoked, about $0.0010 per session on Opus 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-09-03.
Other skills, from other repositories
handoff
Structured session handoff — preserves context for seamless continuation across sessions.
lesson-learned
Extract learnings and save as memory files (file-based memory system). Use when: "lesson learned", "what did we learn", "learning", "remember".
context-budget
Analyzes where context tokens are being spent and identifies optimization opportunities. Use when sessions feel slow or context is running out.
pattern-extractor
Analyzes captured patterns from continuous learning to extract reusable workflows and anti-patterns. Use when you want to review what's been learned across sessions.
context-preservation
State capture and restore across context window compactions. Monitors usage thresholds and serializes quality, task, and spec state for seamless continuation.
session-management
Context preservation, tiered summarization, resumability.