k-skill/scripts
Jeffrey (Dongkyu) Kim 81c81cb5da Document the approved real-estate MCP skill without vendoring upstream
Issue #53 is intentionally doc-only, so this change adds the
real-estate-search skill, feature guide, setup/security notes,
and regression coverage around the upstream real-estate-mcp
integration instead of importing server code.

The new docs keep the original MCP link, cover Codex/Claude
registration, and spell out the self-host + Cloudflare Tunnel +
launchd path for environments where no fixed hosted endpoint is
available.

Constraint: Must use tae0y/real-estate-mcp without copying its source into this repository
Constraint: Must include the original MCP link and a stable self-host fallback when no hosted endpoint is available
Rejected: Vendor the upstream MCP source | issue explicitly requires skill docs only
Rejected: Assume a public hosted MCP endpoint exists | upstream docs did not publish one
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Keep this integration doc-only; do not add a workspace or vendored server without revisiting issue #53 constraints
Tested: node --test scripts/skill-docs.test.js
Tested: npm run ci
Tested: upstream bootstrap smoke (`uv sync`, `uv run real-estate-mcp --help`, HTTP initialize on 127.0.0.1:8017)
Not-tested: live property data queries with a valid DATA_GO_KR_API_KEY
2026-04-05 14:10:45 +09:00
..
fixtures Add local air-quality lookup so k-skill covers location-based dust checks 2026-03-27 22:06:19 +09:00
check-setup.sh Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
fine_dust.py Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
korean_spell_check.py Prevent clean spell-check chunks from crashing mixed file runs 2026-04-03 22:29:50 +09:00
ktx_booking.py Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
run-k-skill-proxy.sh Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
sillok_search.py Make joseon-sillok-search installs work outside the repo 2026-04-04 00:15:50 +09:00
skill-docs.test.js Document the approved real-estate MCP skill without vendoring upstream 2026-04-05 14:10:45 +09:00
test_fine_dust.py Make the fine-dust proxy easier to consume than the upstream APIs 2026-03-28 17:14:18 +09:00
test_korean_spell_check.py Prevent clean spell-check chunks from crashing mixed file runs 2026-04-03 22:29:50 +09:00
test_ktx_booking.py Keep waiting-list reservations aligned with the selected train 2026-03-27 11:26:38 +09:00
test_sillok_search.py Restore the sillok CLI's verified stdlib transport fallback 2026-04-04 00:28:58 +09:00
validate-skills.sh Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00