ref-url-fetcher

URL 콘텐츠를 마크다운으로 변환하는 스킬.

목적

• 웹 페이지 콘텐츠 수집
• HTML을 마크다운으로 변환
• 기술 문서 레퍼런스화

사용법

/ref-url-fetcher https://fastapi.tiangolo.com/tutorial/security/
/ref-url-fetcher https://docs.python.org/3/library/asyncio.html

프로세스

/ref-url-fetcher [url]
    |
    v
[Step 1] URL 검증
    |-- URL 형식 확인
    |-- 접근 가능 여부 확인
    |
    v
[Step 2] WebFetch 실행
    |-- 페이지 콘텐츠 수집
    |-- HTML → Markdown 변환
    |
    v
[Step 3] 콘텐츠 정리
    |-- 불필요한 요소 제거 (광고, 네비게이션)
    |-- 핵심 콘텐츠 추출
    |
    v
[Step 4] 메타데이터 추가
    |-- 원본 URL
    |-- 수집 날짜
    |-- 페이지 제목
    |
    v
[Step 5] 파일 저장
    |-- docs/references/external/{domain}-{slug}.md
    |
    v
완료

출력 템플릿

# {페이지 제목}

> **URL**: {url}
>
> **도메인**: {domain}
>
> **수집일**: {YYYY-MM-DD}

---

## 콘텐츠

{추출된 마크다운 콘텐츠}

---

## 참고

- 원본: [{url}]({url})
- 수집 날짜: {date}

예제

User: /ref-url-fetcher https://fastapi.tiangolo.com/tutorial/security/oauth2-jwt/

Claude:
=== URL 콘텐츠 수집 ===

URL: https://fastapi.tiangolo.com/tutorial/security/oauth2-jwt/

[1/3] WebFetch 실행 중...
  - 페이지 로드 완료
  - 콘텐츠 추출 중

[2/3] 마크다운 변환 중...
  - 코드 블록: 12개
  - 헤딩: 8개
  - 리스트: 5개

[3/3] 파일 저장...

=== 완료 ===

파일: docs/references/external/fastapi-oauth2-jwt.md

### 주요 내용
- OAuth2 with Password flow
- JWT 토큰 생성
- Depends를 이용한 인증 주입

관련 스킬

스킬명	관계	설명
[@skills/ref-web-search/SKILL.md]	선행	검색 후 상세 URL 수집
[@skills/markdown-converter/SKILL.md]	유사	범용 마크다운 변환
[@skills/prd-workflow/SKILL.md]	부모	레퍼런스 수집 단계

Changelog

날짜	변경 내용
2026-01-21	초기 스킬 생성