본문으로 건너뛰기

Context Degradation 스킬

검증된 사실과 작업별 비교를 통해 긴 컨텍스트 오류를 진단하고 복구를 계획합니다.

커뮤니티 · Muratcan Koylan
작성자Muratcan Koylan
라이선스MIT
소스muratcankoylan/Agent-Skills-for-Context-Engineering · GitHub의 SKILL.md
작동 환경Claude Code · Codex, Gemini CLI, Cursor, Copilot
소스 확인 날짜

context-degradation 스킬은 과밀하거나 오해를 유발하거나 충돌하는 에이전트 컨텍스트의 오류를 진단합니다.

중간 정보 누락, 오염, 산만함, 혼동과 충돌을 구분합니다. 보편적 토큰 임계값 대신 증상과 검증된 근거로 복구를 시작합니다.

스킬의 SKILL.md에서: ## Gotchas

Muratcan Koylan의 커뮤니티 스킬로, 저희나 Anthropic이 검토하지 않았습니다. 스킬은 에이전트에게 코드 실행, 파일 읽기, 네트워크 호출을 지시할 수 있습니다. 설치하기 전에 SKILL.md와 폴더 안의 모든 스크립트를 읽고, 설명과 맞지 않는 동작이 없는지 확인하세요.

하는 일

  1. 관찰된 오류를 분류하고 컨텍스트를 검사합니다.
  2. 반복 실행을 작은 컨텍스트 기준선과 비교합니다.
  3. 선택적 검색, 압축, 격리 또는 검증된 재시작을 제안합니다.

얻을 수 있는 결과물

  • 컨텍스트 오류 진단과 복구 실험 계획.

이럴 때 사용하세요

  • 긴 세션에서 요구사항을 놓치거나 이전 실수를 반복할 때.

이럴 때는 맞지 않습니다

  • 영구 메모리를 구현하거나 모든 오류를 컨텍스트 창 탓으로 돌리는 용도.

필요한 것

  • 파일을 다루는 에이전트, 대표 프롬프트, 추적 기록과 예상 결과가 필요합니다.
  • 선택적인 Python 예제는 주의를 모사하고 휴리스틱을 사용합니다. 실제 모델 측정이나 보정된 탐지기가 아닙니다.

스킬에 들어 있는 파일

파일 또는 폴더용도
SKILL.md오류 유형, 진단 비교와 복구 지침.
references/patterns.mdPython 탐지기 예제와 컨텍스트 저하 유형 참고 자료.
scripts/degradation_detector.pyPython 탐지기 예제와 컨텍스트 저하 유형 참고 자료.

2026-11-20 기준 저장소에 있는 라이선스: MIT.

예시 프롬프트

설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.

  • 긴 세션에서 인수 조건을 계속 놓치는 원인을 진단해 주세요.
  • 압축을 제안하기 전에 짧고 긴 컨텍스트 실행을 비교해 주세요.
  • 검증된 사실과 출처만 사용해 재시작을 계획해 주세요.

context-degradation 설치 방법

전체 스킬 폴더 복사

상대 경로를 유지하도록 참고 자료와 스크립트를 SKILL.md와 함께 보관하세요. 플러그인은 컨텍스트 엔지니어링 모음을 설치합니다.

안내를 읽는 데 유료 서비스는 필요 없습니다. 실제 실험에는 본인의 에이전트와 작업이 필요하며 모델 비용이 발생할 수 있습니다. 호스팅 업로드와 API 실행은 여기서 검증하지 않았습니다.

스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.

Claude Code: 플러그인 마켓플레이스에서 설치

  1. 터미널에서 claude로 Claude Code를 시작합니다.
  2. 마켓플레이스를 추가합니다(컴퓨터마다 한 번):
    /plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
  3. 플러그인을 설치합니다. Claude Code가 먼저 세부 정보를 보여 줍니다. 무엇이 추가되는지(스킬, 훅, MCP 서버) 확인한 다음, 나만 쓸지, 이 저장소의 모든 사람이 쓸지, 이 저장소에서 나만 쓸지 고르세요.
    /plugin install context-engineering@context-engineering-marketplace
  4. /를 입력해 /context-engineering:context-degradation가 있는지 확인하거나, 그냥 작업을 요청하세요.

세션 대신 셸에서 설치하려면:

claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplace

플러그인은 통째로 설치되므로 context-fundamentals, context-compression, context-optimization, self-managed-context, multi-agent-patterns, long-horizon-prompting, memory-systems, tool-design, filesystem-context, hosted-agents, evaluation, advanced-evaluation, harness-engineering, project-development, bdi-mental-states, latent-briefing, self-improvement-loops 등 다른 스킬도 함께 설치됩니다.

Claude Code: 스킬 폴더에 복사

이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).

git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p ~/.claude/skills
cp -R Agent-Skills-for-Context-Engineering/skills/context-degradation ~/.claude/skills/

Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /context-degradation를 입력하거나 작업을 설명하면 됩니다.

Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.

Codex, Gemini CLI, Cursor, GitHub Copilot

이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.

git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p .agents/skills
cp -R Agent-Skills-for-Context-Engineering/skills/context-degradation .agents/skills/
에이전트프로젝트 폴더사용자 폴더참고
OpenAI Codex
.agents/skills/
~/.agents/skills/
$를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상).
신뢰할 수 있는 스킬만 설치하세요. Anthropic은 신뢰할 수 있는 출처의 스킬만 사용하고, 그 밖의 스킬은 사용하기 전에 모든 파일을 읽어 보라고 권합니다. 스킬은 설명에 나오지 않는 방식으로 에이전트에게 명령어 실행, 파일 읽기, 데이터 전송을 지시할 수 있기 때문입니다.

이 단계의 출처

2026-11-14에 각 업체의 문서와 대조해 확인했습니다:

실행 체계 변경 전 진단

관련성 높은 작은 컨텍스트에서 프롬프트를 먼저 시험하세요. 반복 비교로 일반적인 변동을 성능 저하로 오인하지 않도록 합니다.

중요 사실의 출처와 우선순위를 기록하세요. 짧은 요약도 오류를 유지하면 다음 세션을 오염시킬 수 있습니다.

예제 탐지기의 한계

모사 곡선과 텍스트 패턴으로 위험을 설명합니다. 특정 문장에 주의를 기울였는지나 주장이 사실인지는 증명하지 못합니다.

실제 작업 결과로 복구를 검증하세요. 모델, 프롬프트, 컨텍스트 구성과 실험 조건을 기록해 비교 가능하게 만드세요.

context-degradation에 관한 질문

예제가 실제 모델 주의를 측정하나요?

아닙니다. 곡선을 모사하며 대략적인 토큰 수와 패턴 검사를 사용합니다.

항상 안전한 컨텍스트 길이가 있나요?

없습니다. 예제 임계값을 일반화하지 말고 모델, 작업과 실행 체계별 기준선을 정하세요.

재시작할 때 이전 답변을 모두 보존하나요?

아닙니다. 출처가 있는 검증된 사실만 보존하세요. 근거 없는 답변을 넘기면 오류가 반복될 수 있습니다.

컨텍스트 압축을 대체하나요?

아닙니다. 문제를 진단하고 복구 방식을 고르며 압축과 영구 메모리는 별도 구현이 필요합니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리