mirror of
https://github.com/NomaDamas/k-skill.git
synced 2026-06-24 02:04:11 +00:00
ca490a5e6e
The zipcode-search docs were directionally correct, but they left a few practical failure modes underexplained for real operator use. This update makes the retry order explicit, adds guidance for temp-file based parsing in wrapped shells, and documents the benign curl (23) case when downstream readers close early. Constraint: Keep the change docs-first without adding runtime code or dependencies Constraint: The official ePost endpoint remains intermittently flaky, so guidance must focus on stable operator behavior rather than pretending transport is deterministic Rejected: Replace the docs example with a larger shell wrapper script | too heavy for a small skill-doc improvement Rejected: Ignore curl (23) and here-doc issues as user error | repeated operator confusion is worth documenting Confidence: high Scope-risk: narrow Reversibility: clean Directive: If the zipcode-search example changes again, keep the retry order and shell-wrapper caveats aligned between the skill doc, feature doc, and regression test Tested: node --check scripts/skill-docs.test.js Tested: node --test scripts/skill-docs.test.js Tested: npm run ci Tested: npx --yes skills add . --list Not-tested: Live ePost requests for this doc-only follow-up |
||
|---|---|---|
| .. | ||
| check-setup.sh | ||
| skill-docs.test.js | ||
| validate-skills.sh | ||