k-skill/docs/features
Jeffrey (Dongkyu) Kim d7aca1bcbe
Merge dev into main (#197)
* fix(toss-securities): clarify session expiry and quote 403 handling

* Clarify toss empty-output session expiry

Portfolio and watchlist reads can exit successfully with empty payloads when the stored Toss session has expired. The empty-output path now verifies the session before JSON parsing and only promotes confirmed invalid auth doctor data into TossSessionExpiredError.

Constraint: Scope is limited to toss-securities issue #126 follow-up on PR #192

Rejected: Treat auth doctor execution failures as expired sessions | unsupported or failing doctor output is inconclusive without parsed session.valid=false

Confidence: high

Scope-risk: narrow

Directive: Keep empty-result session expiry classification tied to explicit auth doctor confirmation

Tested: npm run test --workspace toss-securities; npm run lint --workspace toss-securities; npm run ci; manual mock tossctl blank stdout invalid/inconclusive doctor checks

* Avoid false session-expiry labels for validation errors

The toss wrapper now treats bare validation_error text as an upstream command failure instead of a session-expired signal. Structured auth doctor JSON remains the source of truth for empty portfolio/watchlist invalid-session promotion, while known stored-session-invalid stderr still maps to TossSessionExpiredError.\n\nConstraint: PR #192 follow-up must stay scoped to issue #126 toss-securities behavior.\nRejected: Keep validation_error in the global regex | it mislabels auth doctor transport failures and quote 403 validation errors as session expiry.\nConfidence: high\nScope-risk: narrow\nDirective: Do not broaden the free-text session classifier without regressions for auth doctor and quote upstream validation failures.\nTested: npm run lint --workspace toss-securities; npm run test --workspace toss-securities; npm run ci; manual mock tossctl validation_error checks; architect verification CLEAR\nNot-tested: Live tossctl network/auth session against real Toss upstream

* Align court auction lookup with monthly site search (#196)

The court auction notice page posts a YYYYMM search key from its 조회 button and returns a month of rows. Keep day inputs as a compatibility filter over the monthly response and normalize the current nested detail payload shape.

Constraint: courtauction.go.kr has no public API and blocks bursty automated calls.

Rejected: querying every day independently | the upstream search surface is month-based and day calls return false empty results.

Confidence: high

Scope-risk: narrow

Directive: Preserve the site-observed YYYYMM notice search contract unless the PGJ143M01 XHR changes again.

Tested: npm --workspace packages/court-auction-notice-search test; npm run ci; live 서울중앙지방법원 2026-05 notice/detail smoke lookup.

Not-tested: PR CI after push.

Co-authored-by: OmX <omx@oh-my-codex.dev>

* Guide crawler skills toward reusable discovery (#195)

* chore: version packages

* Guide crawler skills toward reusable discovery

Constraint: User requested insane-search-style guidance for future crawling k-skills without unrelated implementation changes.
Rejected: Adding crawler code or a standalone template | too broad for a docs guidance change and risks dependency creep.
Confidence: high
Scope-risk: narrow
Directive: Keep site-specific access details inside individual skills after a site-agnostic discovery pass.
Tested: npm run ci
Not-tested: Live crawler behavior; documentation-only change.

* Clarify crawler skill discovery guidance

Constraint: Crawling k-skills need site-dependent recipes, but should derive them through a reusable discovery pass.
Rejected: Leaving guidance only in docs/adding-a-skill.md | AGENTS.md and CLAUDE.md also guide future agents.
Confidence: high
Scope-risk: narrow
Directive: Use site-agnostic discovery to find, then explicitly package, the target site's stable access path.
Tested: npm run ci
Not-tested: Live crawler behavior; documentation-only change.

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Ground corporate registration guidance in official form sources

Keep the consulting skill focused on draft/checklist support while pointing users to current IROS and law.go.kr form sources for submission-ready artifacts.

Constraint: official registry forms can change outside the repository and must be re-downloaded at use time

Rejected: committing copied official HWP/HWPX/PDF forms | they would become stale and risk misleading users

Confidence: high

Scope-risk: narrow

Directive: do not treat Markdown templates as substitutes for official registry submission forms

Tested: npm test

* Ground incorporation drafting in real HWP forms

Bundle official court incorporation forms plus public startup incorporation attachments, and make rhwp-filled HWP outputs the default drafting path for the corporate-registration skill. Replace the listed-company articles reference with a startup-suitable Ministry of Justice stock-company form and record source manifests for bundled binaries.

Constraint: user requires actual sourced HWP templates, not generated placeholder binaries.
Rejected: markdown-only drafting | it cannot produce submission-shaped Korean registry forms.
Rejected: listed-company standard articles as the default reference | it is mismatched for typical startup incorporation.
Confidence: high
Scope-risk: moderate
Directive: keep bundled HWP forms source-backed, sanitized, and edited only through copied working files.
Tested: node --test scripts/skill-docs.test.js; npm run lint; k-skill-rhwp info on bundled HWP files; kordoc conversion spot checks.
Not-tested: manual opening every HWP in Hancom Office and live registry submission.
Co-authored-by: OmX <omx@oh-my-codex.dev>

* Streamline corporate registration forms workflow

Prioritize saved HWP forms for ordinary stock-company promoter incorporations, make required court-registry receipts and director identity certificates explicit, and remove the redundant markdown articles template so the skill stays HWP-first.

Constraint: 법원등기소 기준 체크리스트 must include fee receipts, director seal/signature certificates, and resident-record documents.

Rejected: Keeping a separate markdown articles template | duplicated the stored HWP articles workflow and encouraged non-HWP drafting.

Confidence: high

Scope-risk: narrow

Directive: Keep corporate-registration-consulting focused on stored HWP form copies and explicit issued-document checklists.

Tested: node --test --test-name-pattern 'corporate-registration-consulting' scripts/skill-docs.test.js; node --check scripts/skill-docs.test.js; ./scripts/validate-skills.sh; git diff --check

Not-tested: Full npm run ci was not run because this is a skill documentation/template refactor, not release or package automation.

---------

Co-authored-by: galvaomica <galvaomica@galvaomicaui-MacBookAir.local>
Co-authored-by: OmX <omx@oh-my-codex.dev>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-05-02 23:51:59 +09:00
..
blue-ribbon-nearby.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
bunjang-search.md Sync dev → main: 84 commits incl. korea-weather, korean-stock-search, korean-patent-search, bunjang-search (#80) 2026-04-08 21:13:55 +09:00
catchtable-sniper.md feat: add catchtable-sniper skill (#146) 2026-04-22 16:20:38 +09:00
cheap-gas-nearby.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
corporate-registration-consulting.md Merge dev into main (#197) 2026-05-02 23:51:59 +09:00
coupang-product-search.md Sync dev → main: MFDS proxy fixes, cache hardening, HWP kordoc, KRX degraded handling + new skills (#152) 2026-04-21 09:53:03 +09:00
court-auction-notice-search.md Merge dev into main (#197) 2026-05-02 23:51:59 +09:00
daiso-product-search.md Keep Daiso online-stock lookups aligned with live product ids 2026-03-27 19:31:24 +09:00
delivery-tracking.md Document the verified public tracking outputs explicitly 2026-03-27 02:44:48 +09:00
fine-dust-location.md Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
foresttrip-vacancy.md Merge pull request #188 from seolcoding/feature/foresttrip-vacancy 2026-04-30 01:28:57 +09:00
geeknews-search.md Add a repeatable GeekNews lookup path without unofficial APIs 2026-04-13 00:16:35 +09:00
han-river-water-level.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
hipass-receipt.md Sync dev → main: 84 commits incl. korea-weather, korean-stock-search, korean-patent-search, bunjang-search (#80) 2026-04-08 21:13:55 +09:00
hola-poke-yeoksam.md Sync dev → main: scholarship, public restroom, KBL, Hola Poke + HWP/stock proxy upgrades (#136) 2026-04-18 11:50:47 +09:00
household-waste-info.md feat(k-skill-proxy): 생활쓰레기 페이지네이션 검증 및 문서 보강 2026-04-11 03:02:09 +09:00
hwp.md Sync dev → main: scholarship, public restroom, KBL, Hola Poke + HWP/stock proxy upgrades (#136) 2026-04-18 11:50:47 +09:00
iros-registry-automation.md Prevent IROS download path failures after payment 2026-04-28 14:47:30 +09:00
joseon-sillok-search.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
k-dart.md feat: add k-dart skill for DART OpenAPI financial disclosures (#147) 2026-04-22 12:46:42 +09:00
k-schoollunch-menu.md NEIS 급식·학교검색 프록시, k-schoollunch-menu 스킬 및 문서 2026-04-10 13:14:15 +09:00
k-skill-cleaner.md Clarify cleaner usage evidence boundaries 2026-04-28 18:08:17 +09:00
k-skill-proxy.md Sync dev → main: MFDS proxy fixes, cache hardening, HWP kordoc, KRX degraded handling + new skills (#152) 2026-04-21 09:53:03 +09:00
kakao-bar-nearby.md Keep Kakao smoke docs aligned with verified live output 2026-03-29 17:05:17 +09:00
kakaotalk-mac.md Sync dev → main: scholarship, public restroom, KBL, Hola Poke + HWP/stock proxy upgrades (#136) 2026-04-18 11:50:47 +09:00
kbl-results.md Sync dev → main: scholarship, public restroom, KBL, Hola Poke + HWP/stock proxy upgrades (#136) 2026-04-18 11:50:47 +09:00
kbo-results.md Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
kleague-results.md Add an official K League results client and skill 2026-03-29 15:57:15 +09:00
korea-weather.md Sync dev → main: 84 commits incl. korea-weather, korean-stock-search, korean-patent-search, bunjang-search (#80) 2026-04-08 21:13:55 +09:00
korean-character-count.md Keep published Korean count examples aligned with the shipped helper 2026-04-08 23:57:31 +09:00
korean-jangbu-for.md Protect jangbu wrapper installs from incomplete payloads 2026-04-29 00:50:37 +09:00
korean-law-search.md Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
korean-patent-search.md Sync dev → main: 84 commits incl. korea-weather, korean-stock-search, korean-patent-search, bunjang-search (#80) 2026-04-08 21:13:55 +09:00
korean-privacy-terms.md Sync dev → main: MFDS proxy fixes, cache hardening, HWP kordoc, KRX degraded handling + new skills (#152) 2026-04-21 09:53:03 +09:00
korean-scholarship-search.md Sync dev → main: scholarship, public restroom, KBL, Hola Poke + HWP/stock proxy upgrades (#136) 2026-04-18 11:50:47 +09:00
korean-slang-writing.md korean-slang-writing (#133): add feature doc 2026-04-22 12:48:21 +09:00
korean-spell-check.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
korean-stock-search.md Sync dev → main: scholarship, public restroom, KBL, Hola Poke + HWP/stock proxy upgrades (#136) 2026-04-18 11:50:47 +09:00
ktx-booking.md Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
lck-analytics.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
lh-notice-search.md Add lh-notice-search skill and /v1/lh-notice/{search,detail} proxy routes 2026-04-22 10:58:03 +09:00
library-book-search.md Sync dev → main: MFDS proxy fixes, cache hardening, HWP kordoc, KRX degraded handling + new skills (#152) 2026-04-21 09:53:03 +09:00
lotto-results.md Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
market-kurly-search.md Add a supported Market Kurly price-lookup skill 2026-04-09 14:51:30 +09:00
mfds-drug-safety.md Route MFDS drug-safety and food-safety lookups through k-skill-proxy 2026-04-14 00:07:18 +09:00
mfds-food-safety.md Route MFDS drug-safety and food-safety lookups through k-skill-proxy 2026-04-14 00:07:18 +09:00
naver-blog-research.md feat: 네이버 블로그 리서치 스킬 추가 (#107) 2026-04-13 00:06:18 +09:00
naver-news-search.md Document preflight 400 and full canonical dedup contract in naver-news feature doc 2026-04-22 16:03:18 +09:00
naver-shopping-search.md Sync dev → main: MFDS proxy fixes, cache hardening, HWP kordoc, KRX degraded handling + new skills (#152) 2026-04-21 09:53:03 +09:00
olive-young-search.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
parking-lot-search.md Fix parking lot lookups: force HTTPS, cache full dataset, normalize provider fields (#156) 2026-04-22 10:52:57 +09:00
public-restroom-nearby.md Improve restroom coverage with Kakao source merging 2026-04-28 23:28:12 +09:00
real-estate-search.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
rhwp-advanced.md Add rhwp-edit and rhwp-advanced skills with k-skill-rhwp CLI 2026-04-22 12:45:13 +09:00
rhwp-edit.md rhwp-edit (#155): guard replace-all case-insensitive path against UTF-16 length-drift 2026-04-22 15:23:23 +09:00
seoul-subway-arrival.md Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
srt-booking.md Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
subway-lost-property.md Keep LOST112 curl guidance usable under live latency 2026-04-10 13:01:01 +09:00
toss-securities.md Add a safe Toss Securities lookup surface without trading mutations 2026-03-30 11:25:43 +09:00
used-car-price-search.md Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
zipcode-search.md Document direct zipcode helper execution so the executable follow-up stays discoverable 2026-04-10 10:59:22 +09:00