Audit: repair broken OKF example link and enforce resource-link validation #94

New issue

Closed

opened 2026-07-11 09:18:41 -04:00 by magnus · 0 comments

magnus commented

2026-07-11 09:18:41 -04:00

Owner

Finding

open-knowledge-format/SKILL.md links to datasets/sales.md in its example dataset list, but that file does not exist relative to the skill root. The adjacent absolute /tables orders and customers links are example output paths rather than bundled resources, so the broken relative link is especially misleading because it appears navigable.

Acceptance criteria

Replace datasets/sales.md with a real bundled file, correct it to the intended destination, or mark it clearly as an illustrative path.
Validate every relative Markdown link in SKILL.md files during CI, excluding anchors and external URLs.
Report missing relative links with skill path and target.

## Finding open-knowledge-format/SKILL.md links to datasets/sales.md in its example dataset list, but that file does not exist relative to the skill root. The adjacent absolute /tables orders and customers links are example output paths rather than bundled resources, so the broken relative link is especially misleading because it appears navigable. ## Acceptance criteria - Replace datasets/sales.md with a real bundled file, correct it to the intended destination, or mark it clearly as an illustrative path. - Validate every relative Markdown link in SKILL.md files during CI, excluding anchors and external URLs. - Report missing relative links with skill path and target.

magnus referenced this issue from a pull request that will close it,

2026-07-11 09:25:27 -04:00

fix: resolve skill audit findings #97

magnus closed this issue

2026-07-11 09:25:53 -04:00