mirror of https://github.com/NomaDamas/k-skill.git synced 2026-06-24 02:04:11 +00:00

Jeffrey (Dongkyu) Kim 43e8625986 Add a repeatable GeekNews lookup path without unofficial APIs

Issue #108 needs a dedicated read-only skill that can browse,
search, and inspect GeekNews posts using the public feed alone.
The implementation adds a fixture-backed Atom helper, skill/docs
surfaces, and install/README wiring, then verifies the helper
against the live GeekNews feed.

Constraint: Must stay RSS-first and avoid new dependencies or unofficial APIs
Constraint: Skill development requires syncing the skill into ~/.claude/skills and ~/.agents/skills during verification
Rejected: Fetch article pages directly for v1 | expands scope beyond the approved RSS-driven workflow
Rejected: Use XML parser modules | current python3 environment has expat issues, so regex + HTML parsing is safer here
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Keep the root helper and geeknews-search/scripts copy behaviorally identical because the installed skill must remain self-contained
Tested: PYTHONPATH=.:scripts python3 -m unittest scripts.test_geeknews_search; node --test scripts/skill-docs.test.js; python3 scripts/geeknews_search.py list --limit 3; python3 scripts/geeknews_search.py search --query Claude --limit 3; python3 scripts/geeknews_search.py detail --id 28439; npm run ci
Not-tested: Non-default feed mirrors or future Atom schema changes beyond the current public GeekNews feed shape
Related: Issue #108

2026-04-13 00:16:35 +09:00

2.2 KiB

Raw Permalink Blame History

name

description

license

metadata

geeknews-search

GeekNews public RSS/Atom feed로 긱뉴스 게시물을 조회, 검색, 상세 확인하는 읽기 전용 스킬.

MIT

category	locale	source
news	ko-KR	geeknews-rss

GeekNews Search

What this skill does

GeekNews 공개 RSS/Atom 피드(https://feeds.feedburner.com/geeknews-feed)를 사용해 최신 글을 읽기 전용으로 조회한다.

최신 글 목록 조회
제목/요약/작성자 기준 검색
항목 id/link 기준 상세 확인

When to use

"긱뉴스 오늘 뭐 올라왔어?"
"긱뉴스에서 Claude 관련 글 찾아줘"
"이 GeekNews 글 요약/링크 확인해줘"

Inputs

기본: 별도 인증 없이 public feed만 사용
목록 조회: limit
검색: query, 선택 limit
상세 조회: id 또는 링크/토픽 번호 일부

Official surface

GeekNews RSS/Atom feed: https://feeds.feedburner.com/geeknews-feed
GeekNews home: https://news.hada.io

Workflow

1) List recent entries

python3 scripts/geeknews_search.py list --limit 10

2) Search the feed conservatively

python3 scripts/geeknews_search.py search --query Claude --limit 5

검색은 제목, 요약, 작성자, 링크/id 기준으로만 동작한다.

3) Inspect a specific item

python3 scripts/geeknews_search.py detail --id 28439

상세 조회는 RSS 피드에 포함된 content/요약과 원문 링크를 함께 돌려준다.

Done when

최신 GeekNews 글 목록을 바로 보여줄 수 있다.
키워드 검색 결과에서 제목/링크/작성자/요약을 정리할 수 있다.
특정 항목의 RSS 기반 내용을 보수적으로 확인하고 원문 링크를 함께 제시할 수 있다.

Failure modes

FeedBurner/GeekNews feed가 일시적으로 응답하지 않을 수 있다.
RSS 피드가 제공하는 범위를 넘는 전체 본문/댓글/투표 정보는 포함되지 않는다.
HTML 요약은 feed 원문 기준이라 일부가 잘릴 수 있다.

Notes

v1은 RSS-first, read-only 범위다.
비공식 API나 로그인 세션에 의존하지 않는다.
테스트/오프라인 검증 시 --feed-file 로 저장된 Atom XML을 넣을 수 있다.

2.2 KiB Raw Permalink Blame History