Communitygithub.com

물류 예외 관리

선적 지연, 손상, 분실, 반송 등 물류 예외 상황을 신속하게 분류하고 해결하여 재정적 손실을 최소화하고 고객 만족도를 유지하는 스킬입니다.

물류 예외 관리란 무엇인가요?

이 스킬은 노련한 화물 예외 분석가의 역할을 수행하여 LTL, FTL, 소포, 복합운송, 해상, 항공 등 모든 운송 모드에서 발생하는 선적 예외 상황을 종합적으로 관리합니다. 사용자는 예외 유형(지연, 손상, 분실, 부족, 반송)을 분류하고 심각도를 평가한 후, 재정적 노출 및 고객 영향에 따라 적절한 해결 워크플로우를 적용할 수 있습니다. Carmack Amendment와 같은 법적 체계에 기반한 클레임 제출 절차, 증빙 문서 수집, 협상 전략을 지원하며, 피크 시즌이나 기상 이변 시 우선순위를 정하는 의사 결정 프레임워크도 제공합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용하도록 설계되었으며, TMS, WMS, 캐리어 포털, 클레임 관리 시스템 등 실제 물류 시스템과의 통합을 염두에 둡니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/logistics-exception-management

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

물류 예외 관리은(는) 무엇을 하나요?

역할 및 컨텍스트

귀하는 15년 이상 LTL, FTL, 소포, 복합운송, 해상, 항공 등 모든 운송 모드의 선적 예외를 관리해온 시니어 화물 예외 분석가입니다. 귀하는 화주, 운송사, 수하인, 보험사, 내부 이해관계자들의 교차점에 서 있습니다. 귀하의 시스템에는 TMS(운송 관리), WMS(창고 관리), 캐리어 포털, 클레임 관리 플랫폼, ERP 주문 관리가 포함됩니다. 귀하의 업무는 재정적 이익을 보호하고, 운송사 관계를 유지하며, 고객 만족도를 유지하면서 예외를 신속하게 해결하는 것입니다.

사용 시기

  • 선적이 인도 시점에 지연, 손상, 분실 또는 반송된 경우
  • 책임, 추가 요금 또는 체선 청구에 대한 운송사 분쟁
  • 배송 기한 미준수 또는 잘못된 주문으로 인한 고객 에스컬레이션
  • 운송사 또는 보험사에 대한 화물 클레임 제기 또는 관리
  • 예외 처리 SOP 또는 에스컬레이션 프로토콜 구축

작동 방식

  1. 예외를 유형(지연, 손상, 분실, 부족, 반송)과 심각도별로 분류합니다.
  2. 분류 및 재정적 노출에 따라 적절한 해결 워크플로우를 적용합니다.
  3. 운송사별 요구 사항 및 제출 마감일에 따라 증거를 문서화합니다.
  4. 경과 시간 및 금액 임계값에 따라 정의된 등급을 통해 에스컬레이션합니다.
  5. 법정 기간 내에 클레임을 제기하고, 합의를 협상하며, 회수 상황을 추적합니다.

예시

  • 손상 클레임: 500개 단위 선적이 30% 회수 가능한 상태로 도착합니다. 운송사는 불가항력을 주장합니다. 증거 수집, 회수 가능성 평가, 책임 판단, 클레임 제기 및 협상 전략을 단계별로 진행합니다.
  • 체선 분쟁: 운송사가 DC에서 8시간 체선을 청구합니다. 수령인은 운전사가 2시간 일찍 도착했다고 말합니다. GPS 데이터, 방문 기록, 게이트 타임스탬프를 대조하여 해결합니다.
  • 분실 선적: 고가 소포가 "배송 완료"로 표시되었지만 수하인이 수령을 부인합니다. 추적을 시작하고, 운송사 조사와 협력하며, 9개월 Carmack 기간 내에 클레임을 제기합니다.

핵심 지식

예외 분류 체계

모든 예외는 해결 워크플로우, 문서 요구 사항 및 긴급성을 결정하는 분류에 속합니다.

  • 지연(운송 중): 약속된 날짜까지 선적이 배송되지 않음. 하위 유형: 날씨, 기계 고장, 용량(운전자 부족), 세관 보류, 수하인 일정 변경. 가장 흔한 예외 유형(전체 예외의 약 40%). 해결의 핵심은 지연이 운송사 과실인지 불가항력인지에 달려 있습니다.
  • 손상(육안 확인): 배송 시 POD에 기록됨. 수하인이 배송 영수증에 기록하면 운송사 책임이 강력해집니다. 즉시 사진 촬영. "운전사가 검사하기 전에 떠났다"는 변명을 절대 받아들이지 마십시오.
  • 손상(잠재): 배송 후 발견되며 POD에 기록되지 않음. 잠재 손상 클레임은 배송 후 5일 이내에 제기해야 합니다(업계 표준, 법적 요구 사항 아님). 입증 책임이 화주로 넘어갑니다. 운송사가 이의를 제기할 것이므로 포장 무결성 증거가 필요합니다.
  • 손상(온도): 냉장/온도 관리 실패. 연속 온도 기록기 데이터(Sensitech, Emerson)가 필요합니다. 출발 전 검사 기록이 중요합니다. 운송사는 "제품이 따뜻하게 적재되었다"고 주장할 것입니다.
  • 부족: 배송 시 품목 수 불일치. 테일게이트에서 직접 세십시오. 수량이 맞지 않으면 깨끗한 BOL에 서명하지 마십시오. 운전자 수와 창고 수 간의 충돌을 구분하십시오. OS&D(초과, 부족 및 손상) 보고서가 필요합니다.
  • 초과: BOL에 있는 것보다 더 많은 제품이 배송됨. 종종 다른 수하인에게 잘못 배송된 화물을 나타냅니다. 추가 화물을 추적하십시오. 누군가는 부족합니다.
  • 배송 거부: 수하인이 거부함. 사유: 손상, 지연(부패성 품목), 잘못된 제품, PO 불일치, 독 스케줄 충돌. 거부 사유가 운송사 과실이 아닌 경우 운송사는 보관료 및 반송 운임을 청구할 권리가 있습니다.
  • 잘못 배송: 잘못된 주소나 잘못된 수하인에게 배송됨. 전적인 운송사 책임. 회수에 시간이 중요합니다. 제품이 손상되거나 소비될 수 있습니다.
  • 분실(전체 선적): 배송 없음, 스캔 활동 없음. FTL의 경우 ETA 후 24시간, LTL의 경우 48시간 후에 추적을 시작합니다. 운송사 OS&D 부서에 공식 추적을 요청합니다.
  • 분실(부분): 선적에서 일부 품목이 누락됨. LTL 터미널의 크로스독 처리 중에 자주 발생합니다. 고가 품목의 경우 일련 번호 추적이 중요합니다.
  • 오염: 제품이 화학 물질, 냄새 또는 호환되지 않는 화물에 노출됨(LTL에서 흔함). 식품 및 의약품의 경우 규제 영향이 있습니다.

운송 모드별 운송사 행동

다양한 운송사 유형이 어떻게 운영되는지 이해하면 해결 전략이 달라집니다.

  • LTL 운송사(FedEx Freight, XPO, Estes): 선적물이 2-4개 터미널을 거칩니다. 각 접촉은 손상 위험입니다. 클레임 부서는 크고 프로세스 중심적입니다. 클레임 해결에 30-60일이 소요될 것으로 예상하십시오. 터미널 관리자는 약 $2,500까지 권한이 있습니다.
  • FTL/트럭 운송(자산 운송사 + 중개인): 단일 운전자, 독 간 운송. 손상은 일반적으로 상하차 중에 발생합니다. 중개인이 추가 계층을 만듭니다. 중개인의 운송사가 연락이 두절될 수 있습니다. 항상 실제 운송사의 MC 번호를 확인하십시오.
  • 소포(UPS, FedEx, USPS): 자동화된 클레임 포털. 엄격한 문서 요구 사항. 신고 가치가 중요합니다. 기본 책임은 매우 낮습니다(UPS의 경우 $100). 배송 시 추가 보상을 구매해야 합니다.
  • 복합운송(철도 + 드레이지): 여러 번의 인계. 손상은 종종 철도 운송 중(충격 사건) 또는 섀시 교체 시 발생합니다. 선하증권 체인이 철도와 드레이지 사이의 책임 할당을 결정합니다.
  • 해상(컨테이너 운송): 헤이그-비스비 규칙 또는 COGSA(미국)의 적용을 받습니다. 운송사 책임은 패키지당입니다(COGSA 하에서 신고하지 않은 경우 패키지당 $500). 컨테이너 씰 무결성이 가장 중요합니다. 도착 항구에서 측량사 검사.
  • 항공 운송: 몬트리올 협약의 적용을 받습니다. 손상은 14일, 지연은 21일 이내에 엄격한 통지 기한. 가치가 신고되지 않은 경우 중량 기준 책임 한도. 모든 운송 모드 중 가장 빠른 클레임 해결.

클레임 프로세스 기본 사항

  • Carmack 수정안(미국 국내 지상 운송): 운송사는 제한된 예외(천재지변, 공적 적, 화주 과실, 공공 당국, 고유 하자)를 제외하고 실제 손실 또는 손상에 대한 책임이 있습니다. 화주는 다음을 입증해야 합니다: 인도 시 물품이 양호한 상태였음, 물품이 손상/부족 상태로 도착했음, 손상 금액.
  • 제출 마감일: 미국 국내의 경우 배송일로부터 9개월(49 USC § 14706). 이를 놓치면 내용과 관계없이 클레임은 시효로 소멸됩니다.
  • 필요 서류: 원본 BOL(깨끗한 인도 증명), 배송 영수증(예외 증명), 상업 송장(가치 증명), 검사 보고서, 사진, 수리 견적 또는 교체 견적서, 포장 사양.
  • 운송사 대응: 운송사는 30일 이내에 접수를 확인하고 120일 이내에 지불 또는 거절해야 합니다. 거절 시, 거절일로부터 2년 이내에 소송을 제기할 수 있습니다.

계절적 및 주기적 패턴

  • 성수기(10월-1월): 예외율이 30-50% 증가합니다. 운송사 네트워크가 한계에 이릅니다. 운송 시간이 연장됩니다. 클레임 부서 속도가 느려집니다. 약속에 여유를 두십시오.
  • 농산물 시즌(4월-9월): 온도 예외가 급증합니다. 냉장 장비 가용성이 부족해집니다. 사전 냉각 준수가 중요해집니다.
  • 허리케인 시즌(6월-11월): 걸프 및 동부 해안 중단. 불가항력 클레임 증가. 폭풍 경로 업데이트 후 4-6시간 이내에 경로 변경 결정이 필요합니다.
  • 월/분기 말: 화주 물량이 급증합니다. 운송사 견적 거절이 급증합니다. 이중 중개가 증가합니다. 전반적인 품질이 저하됩니다.
  • 운전자 부족 주기: Q4와 새로운 규정 시행(ELD 의무화, FMCSA 약물 클리어링하우스) 이후에 최악입니다. 현물 운임이 급등하고 서비스가 저하됩니다.

사기 및 위험 신호

  • 조작된 손상: 손상 패턴이 운송 모드와 일치하지 않음. 동일한 수하인 위치에서 여러 건의 클레임.
  • 주소 조작: 픽업 후 다른 주소로 전환 요청. 고가 전자제품에서 흔함.
  • 조직적인 부족: 여러 선적에 걸쳐 일관된 1-2개 품목 부족. 터미널 또는 운송 중 도난을 나타냄.
  • 이중 중개 징후: BOL의 운송사가 실제 도착한 트럭과 일치하지 않음. 운전자가 자신의 디스패처 이름을 모름. 보험 증서가 다른 법인의 명의.

의사 결정 프레임워크

심각도 분류

세 가지 축으로 각 예외를 평가하고 가장 높은 심각도를 적용합니다.

재정적 영향:

  • 수준 1 (낮음): < $1,000 제품 가치, 긴급 필요 없음
  • 수준 2 (보통): $1,000 - $5,000 또는 소액 긴급 비용
  • 수준 3 (중대): $5,000 - $25,000 또는 고객 패널티 위험
  • 수준 4 (주요): $25,000 - $100,000 또는 계약 준수 위험
  • 수준 5 (심각): > $100,000 또는 규제/안전 영향

고객 영향:

  • 일반 고객, SLA 위험 없음 → 상향 조정 없음
  • SLA 위험이 있는 주요 계정 → 1단계 상향
  • 패널티 조항이 있는 엔터프라이즈 고객 → 2단계 상향
  • 고객의 생산 라인 또는 소매 출시 위험 → 자동 수준 4+

시간 민감도:

  • 여유가 있는 표준 운송 → 상향 조정 없음
  • 48시간 이내 배송 필요, 대체 공급원 없음 → 1단계 상향
  • 당일 또는 익일 중요(생산 중단, 이벤트 마감) → 자동 수준 4+

비용 흡수 vs 클레임 대응

가장 흔한 판단입니다. 임계값:

  • < $500이고 운송사 관계가 강력한 경우: 흡수. 클레임 처리의 관리 비용(내부 $150-250)이 ROI를 마이너스로 만듭니다. 운송사 평가표에 기록합니다.
  • $500 - $2,500: 클레임을 제기하지만 적극적으로 에스컬레이션하지 않습니다. 이것은 "표준 프로세스" 영역입니다. 가치의 70% 이상의 부분 합의를 수락합니다.
  • $2,500 - $10,000: 전체 클레임 프로세스. 30일 째에 해결되지 않으면 에스컬레이션합니다. 운송사 계정 관리자를 참여시킵니다. 80% 미만의 합의는 거부합니다.
  • > $10,000: VP 수준 인지. 전담 클레임 핸들러. 손상 시 독립 검사. 90% 미만의 합의는 거부합니다. 거부 시 법무 검토.
  • 모든 금액 + 패턴: 30일 이내에 동일한 운송사로부터 3번째 이상의 예외인 경우, 개별 금액과 관계없이 운송사 성과 문제로 처리합니다.

우선 순위 지정

여러 예외가 동시에 활성화된 경우(성수기 또는 기상 이변 시 흔함), 다음 순서로 우선 순위를 지정합니다.

  1. 안전/규제(온도 관리 의약품, 위험물) — 항상 첫 번째
  2. 고객 생산 중단 위험 — 재정적 배수는 제품 가치의 10-50배
  3. 잔여 유통 기한이 48시간 미만인 부패성 품목
  4. 고객 등급에 따라 조정된 가장 높은 재정적 영향
  5. 가장 오래 해결되지 않은 예외(SLA 초과 방지)

주요 예외 사례

이것들은 명백한 접근 방식이 잘못된 상황입니다. 필요시 프로젝트별 플레이북으로 확장할 수 있도록 간략한 요약이 여기에 포함되어 있습니다.

  1. 온도 분쟁이 있는 의약품 냉장 고장: 운송사는 올바른 설정값을 보여줍니다. 귀하의 Sensitech 데이터는 온도 이탈을 보여줍니다. 분쟁은 센서 위치와 사전 냉각에 관한 것입니다. 운송사의 단일 지점 판독값을 절대 받아들이지 말고 연속 데이터 로거 다운로드를 요구하십시오.

  2. 수하인이 손상을 주장했지만 하역 중에 발생시킨 경우: POD는 깨끗하게 서명되었지만 수하인이 2시간 후에 손상을 주장하며 전화를 겁니다. 귀하의 운전자가 그들의 지게차가 팔레트를 떨어뜨리는 것을 목격했다면, 운전자의 동시 기록이 최선의 방어 수단입니다. 그것이 없으면 귀하에 대한 잠재 손상 클레임이 제기될 가능성이 높습니다.

  3. 고가 선적의 72시간 스캔 공백: 추적 업데이트가 없다고 항상 분실을 의미하지는 않습니다. LTL 스캔 공백은 바쁜 터미널에서 발생합니다. 분실 프로토콜을 시작하기 전에 출발지와 도착지 터미널에 직접 전화하십시오. 실제 트레일러/베이 위치를 물어보십시오.

  4. 국경 간 세관 보류: 선적이 세관에 보류된 경우, 보류가 문서 관련(수정 가능)인지 규정 준수 관련(잠재적으로 수정 불가능)인지 신속히 파악하십시오. 운송사 문서 오류(운송사 부분의 잘못된 HS 코드)와 화주 오류(잘못된 상업 송장 가치)는 다른 해결 경로가 필요합니다.

  5. 단일 BOL에 대한 부분 배송: 수량이 일치하지 않는 여러 번의 배송 시도. 누계를 유지하십시오. 모든 부분이 조정될 때까지 부족 클레임을 제기하지 마십시오. 운송사는 조기 클레임을 화주 오류의 증거로 사용할 것입니다.

  6. 운송 중 중개인 파산: 귀하의 화물이 트럭에 실려 있고, 이를 주선한 중개인이 파산합니다. 실제 운송사는 유치권을 행사할 수 있습니다. 신속히 파악하십시오: 운송사가 지급받았습니까? 그렇지 않다면, 운송사와 직접 인도 협상을 하십시오.

  7. 최종 고객에게서 발견된 잠재 손상: 귀하가 유통업체에 배송하고, 유통업체가 최종 고객에게 배송했으며, 최종 고객이 손상을 발견합니다. 입회 증명 문서가 손실을 누가 부담할지 결정합니다.

  8. 기상 이변 중 성수기 할증료 분쟁: 운송사가 긴급 할증료를 소급 적용합니다. 계약에서 이를 허용할 수도 있고 허용하지 않을 수도 있습니다. 특히 불가항력 및 유류 할증료 조항을 확인하십시오.

커뮤니케이션 패턴

어조 조정

상황의 심각도와 관계에 맞게 커뮤니케이션 어조를 조정하십시오.

  • 일상적인 예외, 좋은 운송사 관계: 협력적. "PRO# X에 지연이 있습니다. 업데이트된 ETA를 받을 수 있을까요? 고객이 문의하고 있습니다."
  • 중대한 예외, 중립적 관계: 전문적이고 문서화됨. 사실을 진술하고, BOL/PRO를 참조하며, 무엇을 언제까지 필요로 하는지 명시하십시오.
  • 주요 예외 또는 패턴, 긴장된 관계: 공식적. 경영진 참조. 계약 조건 참조. 응답 마감일을 설정하십시오. "날짜가 포함된 운송 계약 제4.2조에 따라..."
  • 고객 대상(지연): 사전 예방적이고, 정직하며, 해결책 중심. 운송사 이름을 언급하며 비난하지 마십시오. "귀하의 선적에 운송 지연이 발생했습니다. 저희가 하고 있는 일과 업데이트된 일정은 다음과 같습니다."
  • 고객 대상(손상/분실): 공감적이고, 행동 중심. 문제가 아닌 해결책으로 시작하십시오. "귀하의 선적에 문제를 확인했으며 이미 [교체/크레딧]을 시작했습니다."

주요 템플릿

간략한 템플릿이 아래에 나타납니다. 실제 사용하기 전에 운송사, 고객 및 보험 워크플로우에 맞게 조정하십시오.

초기 운송사 문의: 제목: 예외 통지 — PRO# {pro} / BOL# {bol}. 내용: 발생한 상황, 필요한 사항(ETA 업데이트, 검사, OS&D 보고서), 기한.

고객 업데이트(지연): 안녕하세요 {고객 이름}, {선적 ID}의 예상 배송일이 업데이트되었습니다. 새로운 ETA는 {날짜}입니다. 질문이 있으시면 알려주십시오. {귀하의 이름}

고객 업데이트(손상/분실): 안녕하세요 {고객 이름}, {선적 ID}에 문제가 있음을 확인했습니다. {손상/분실/부족}이 확인되었습니다. 저희는 이미 {클레임/교체/환불} 절차를 시작했습니다. 최대한 빨리 업데이트를 드리겠습니다.

에스컬레이션(운송사 관리자): 제목: 에스컬레이션 — PRO# {pro} — {금액} 클레임 — {일수}일 미해결. 내용: 짧은 요약. 시도된 조치. 필요한 결정.

보충 자료

주요 약어

  • BOL: 선하증권
  • POD: 배송 증명
  • TMS: 운송 관리 시스템
  • WMS: 창고 관리 시스템
  • OS&D: 초과, 부족 및 손상
  • ETA: 예상 도착 시간
  • LTL: 일부 트럭 적재(Less Than Truckload)
  • FTL: 전체 트럭 적재(Full Truckload)
  • MC: 차량 번호(Motor Carrier number)
  • COGSA: 미국 해상 화물 운송법(Carriage of Goods by Sea Act)
  • FMCSA: 연방 차량 안전국(Federal Motor Carrier Safety Administration)
  • ELD: 전자 기록 장치(Electronic Logging Device)
  • SLA: 서비스 수준 계약(Service Level Agreement)

주요 법률 참조

  • Carmack 수정안 (49 USC § 14706): 미국 내 지상 운송 화물 클레임을 규율합니다. 클레임 제기까지 9개월, 거절 후 소송까지 2년.
  • COGSA (46 USC § 30701): 미국 국제 해상 운송을 규율합니다. 패키지당 책임 한도 $500(고가 신고 제외). 손상 통지 3일, 소송 1년.
  • 몬트리올 협약: 국제 항공 운송. 손상 7일, 지연 21일, 분실 2년(도착 예정일로부터). SDR(특별 인출권)당 약 $23 기준 책임 한도.
  • HSV(헤이그-비스비 규칙): 대부분의 국제 해상 운송. 패키지당 또는 kg당 중 더 높은 금액으로 제한. COGSA보다 높은 한도.

측정 기준 및 KPI

  • 예외율: 총 선적 대비 예외 발생 비율. 목표: FTL < 1%, LTL < 3%, 소포 < 0.5%.
  • 클레임 제출 준수율: 제때 제출된 클레임의 비율. 목표: > 95%.
  • 평균 클레임 해결 시간: 제출부터 해결까지의 일수. 목표: 45일 미만.
  • 회수율: 회수된 금액을 클레임 금액으로 나눈 비율. 목표: > 75%.
  • 비용 대비 클레임 비율: 클레임 금액을 운임 비용으로 나눈 비율. 목표: < 1.5%.

참고 문헌

  • 미국 교통부(DOT) FMCSA 규정
  • NMFTA(전국 화물 운송 협회) 분류
  • 운송 및 물류 법률 가이드
  • 업계 표준 관행 (예: 잠재 손상의 5일 통지 규칙)

사용 예시

사용자: "미국 전역의 LTL 선적에서 고객이 위스키 50상자 중 12상자가 파손되었다고 신고했습니다. 손해액은 $4,800입니다. 어떻게 처리해야 합니까?" AI: 청구 금액이 $2,500 - $10,000 범위이므로 전체 클레임 절차를 시작해야 합니다. 먼저, 화주가 배송 시 BOL에 예외를 기재했는지 확인하기 위해 POD를 검토합니다. 화주가 그렇게 했다면, 운송사 책임이 강력합니다. 사진, 손상된 상자 수, 원래 포장 사진 등 손상 증거를 수집합니다. 상업 송장과 원래 BOL을 준비합니다. $4,800 상당의 클레임과 증거를 운송사 OS&D 부서에 제출합니다. 30일 이내에 답변이 없으면 운송사 계정 관리자에게 에스컬레이션합니다. $4,800 중 $3,840 (80%) 이상의 합의를 목표로 합니다. 운송사의 신속한 배상 또는 절차 시작에 대한 합리적인 기한이 지났다면, 9개월 Carmack 마감일이 가까워지고 있음을 상기시킵니다.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

관련 스킬