defuddle

defuddle skill 개요

defuddle skill이 하는 일

defuddle skill은 일반 웹페이지를, 단순 fetch 결과보다 훨씬 덜 지저분한 깔끔하고 읽기 쉬운 markdown으로 바꿔줍니다. 기사, 문서, 가이드, 블로그 글처럼 메뉴·광고·사이드바·내비게이션이 토큰만 낭비하고 분석을 방해하는 HTML 페이지에 특히 잘 맞습니다.

Web Research에 가장 잘 맞는 경우

실제 목적이 사이트 크롬이나 raw HTML을 들여다보는 것이 아니라, 페이지 내용을 읽고·요약하고·비교하고·인용하고·분석하는 것이라면 defuddle for Web Research를 쓰는 편이 좋습니다. 핵심 가치는 후속 추론에 더 적합한, 정제된 입력을 만드는 데 있습니다. 사용자가 일반 페이지 URL을 주고 그 안의 콘텐츠를 원한다면, defuddle usage는 보통 범용 웹 fetch보다 더 나은 출발점입니다.

주요 한계와 쓰지 말아야 할 때

가장 분명한 경계는 하나입니다. URL이 .md로 끝나면 defuddle을 쓰지 마세요. 그런 페이지는 이미 markdown이므로, 직접 fetch하는 편이 더 깔끔하고 불필요한 변환도 피할 수 있습니다. 또한 정확한 페이지 구조, 인터랙티브 요소, 스크립트, 전체 DOM 충실도가 필요한 경우에도 잘 맞지 않습니다.

사용자가 defuddle을 선택하는 이유

실제 차별점은 “페이지를 가져올 수 있느냐”가 아니라 “핵심 텍스트를 토큰 효율적인 형식으로 빠르게 얻을 수 있느냐”입니다. 그래서 defuddle skill은 리서치 파이프라인, 노트 수집, 기사 요약, 문서 읽기처럼 더 깨끗한 markdown이 결과 품질에 직접 영향을 주는 작업에서 특히 매력적입니다.

defuddle skill 사용 방법

defuddle install과 기본 명령

defuddle install 기준으로, 저장소에서는 Defuddle CLI 자체를 안내합니다:

npm install -g defuddle

기본 명령:

defuddle parse <url> --md

--md는 일관되게 사용하는 것이 좋습니다. 대부분의 리서치·분석 워크플로에서 권장되는 출력 형식으로, 시각적 노이즈를 걷어내면서도 읽기 좋은 구조는 유지해 줍니다.

defuddle skill에 필요한 입력

defuddle skill은 페이지 URL과, 가능하면 분명한 의도를 함께 받는 것이 좋습니다. 좋은 입력은 보통 다음을 포함합니다:

• 정확한 URL
• 그 페이지에서 무엇이 필요한지
• 전체 markdown이 필요한지, 파일로 저장할지, 메타데이터만 필요한지

예시:

• “이 글을 읽고 핵심 주장을 요약해줘: <url>”
• “이 docs 페이지에서 깔끔한 markdown을 추출해서 content.md로 저장해줘: <url>”
• “<url>의 페이지 title과 description만 가져와줘”

유용한 명령:

defuddle parse <url> --md -o content.md
defuddle parse <url> -p title
defuddle parse <url> -p description
defuddle parse <url> -p domain

막연한 요청을 강한 defuddle 프롬프트로 바꾸기

약한 요청: “이 URL 좀 봐줘.”

더 나은 defuddle guide 프롬프트:

• “<url>에 defuddle을 markdown 출력으로 사용해. 사이트 내비게이션은 무시하고, 핵심 내용을 5개 불릿으로 요약한 뒤 가장 중요한 구간을 인용해줘.”
• “이 문서 페이지 <url>에 defuddle을 사용해. markdown을 추출하고, 설정 단계·사전 요구사항·주의사항을 식별한 다음 체크리스트로 다시 정리해줘.”
• “먼저 <url>에서 metadata만 가져와. title과 description이 주제와 맞으면 그다음 전체 markdown을 추출해.”

이 방식이 더 잘 작동하는 이유는, 에이전트에게 defuddle을 어떻게 호출할지뿐 아니라 정제된 콘텐츠로 그다음 무엇을 해야 하는지까지 함께 알려주기 때문입니다.

추천 워크플로와 먼저 읽어야 할 파일

이 skill은 의도적으로 작게 설계되어 있습니다. 먼저 skills/defuddle/SKILL.md를 읽으세요. 설치, 파싱 명령, 출력 형식, metadata 속성까지 실제로 필요한 워크플로가 모두 들어 있습니다. 실전에서는 보통 다음 순서로 진행하면 됩니다:

1. URL이 일반 HTML 페이지인지, .md 파일인지 먼저 확인합니다.
2. defuddle parse <url> --md를 실행합니다.
3. 재사용 가능한 결과물을 남겨야 한다면 -o content.md를 추가합니다.
4. 라우팅이나 유효성 확인만 필요하다면 -p로 metadata를 조회합니다.
5. 정제된 markdown을 요약, 정보 추출, 노트 정리에 넘깁니다.

defuddle skill FAQ

일반 프롬프트 + fetch보다 defuddle이 더 낫나요?

대체로 기사형 페이지에서는 그렇습니다. 일반 fetch는 header, footer, 쿠키 안내, 내비게이션까지 함께 가져오는 경우가 많습니다. defuddle usage는 분석을 시작하기 전에 신호 대 잡음비를 높여 주므로, 토큰 비용을 낮추고 관련 없는 페이지 요소 때문에 생기는 요약 오류도 줄일 수 있습니다.

언제 defuddle skill을 쓰지 말아야 하나요?

.md URL, raw 파일, 혹은 정확한 HTML, 임베디드 미디어 동작, 페이지 스크립트, 레이아웃 세부 정보가 필요한 경우에는 defuddle을 건너뛰세요. 이것은 콘텐츠 추출 도구이지, 브라우저 자동화나 DOM 검사 도구가 아닙니다.

defuddle skill은 초보자도 쓰기 쉬운가요?

네. 명령 표면이 매우 작습니다. 한 번 설치한 뒤 defuddle parse <url> --md만 쓰면 됩니다. 그래서 defuddle skill은 리서치나 노트 정리를 위해 더 깨끗한 원문 텍스트만 필요할 때도 부담 없이 도입할 수 있습니다.

defuddle은 어떤 출력을 반환할 수 있나요?

--md로 markdown, --json으로 JSON, 기본값으로 HTML을 받을 수 있고, -p <name>으로 특정 metadata만 가져올 수도 있습니다. 대부분의 읽기·리서치 작업에서는 markdown이 가장 좋은 기본값이고, metadata 모드는 빠른 검증과 라우팅에 유용합니다.

defuddle skill 개선 방법

defuddle에는 정확한 콘텐츠 페이지를 지정하세요

defuddle 결과를 가장 쉽게 개선하는 방법은 홈페이지, 검색 페이지, 목록 페이지가 아니라 실제 canonical 콘텐츠 페이지를 넣는 것입니다. 기사 URL이나 단일 문서 페이지는 내비게이션과 반복 링크가 많은 허브 페이지보다 더 깔끔한 markdown을 만들어냅니다.

같은 요청 안에서 후속 작업까지 함께 지정하세요

defuddle skill은 추출 이후의 다음 단계가 구체적일수록 더 강해집니다. 단순히 “이걸 parse해”라고만 하지 말고, 다음 중 무엇이 필요한지 함께 요청하세요:

• 요약
• 핵심 주장
• 설정 단계
• FAQ
• 인용문
• 비교 포인트

이렇게 하면 handoff의 모호함이 줄고, 에이전트도 실제로 해결해야 하는 작업에 맞춰 출력을 구조화하기 쉬워집니다.

확신이 없을 때는 전체 추출 전에 metadata 모드부터 쓰세요

URL이 리다이렉트될 수 있거나, 품질이 낮아 보이거나, 원하는 페이지가 아닐 수 있다면 먼저 다음부터 실행하세요:

defuddle parse <url> -p title
defuddle parse <url> -p description
defuddle parse <url> -p domain

이건 단순하지만 효과적인 defuddle guide 전략입니다. 먼저 관련성을 검증한 뒤, 그다음 전체 markdown 추출에 시간을 쓰세요.

흔한 실패 패턴과 개선 방법

출력이 지나치게 빈약하거나 구조가 이상하게 느껴진다면, 문제는 CLI보다 원본 페이지에 있는 경우가 많습니다. 더 구체적인 URL을 써 보거나, 카테고리 페이지 대신 기사 페이지로 바꾸거나, markdown을 저장해서 직접 확인해 보세요. 첫 결과가 너무 넓게 잡혔다면, “설정 단계만 추출해” 또는 “인증 관련 섹션만 인용해”처럼 더 좁은 지시로 defuddle for Web Research를 다시 실행해 보세요.