Skip to content

docs: fix SKILL.html 404 and rewrite README agent-skill section - #8

Merged
ShixiangWang merged 1 commit into
mainfrom
fix/skill-page-and-readme
Oct 25, 2026
Merged

ShixiangWang merged 1 commit into
mainfrom
fix/skill-page-and-readme

Conversation

@ShixiangWang

Copy link
Copy Markdown
Contributor

Summary

Two reported problems, both fixed:

  1. https://wanglabcsu.github.io/geokit/skills/geokit/SKILL.html returned 404. Only SKILL.md was deployed (every article has an HTML page, the skill did not). This PR adds a small self-contained landing page at that exact URL: it explains what the skill file is, shows the canonical curl fetch, and links to SKILL.md, the GitHub source, and the documentation home. No build changes — the page is a static asset alongside SKILL.md, which remains the canonical agent-facing artifact.

  2. The README's last section ("Agent skill (remote)") was unprofessional. Rewritten in README.Rmd (and regenerated README.md): explains what the Agent Skills file is, how to fetch it for an assistant, and links the file, the new landing page, and the source. The awkward "(remote)" qualifier and uppercase host name are gone, a comma-splice sentence in "Learning geokit" is fixed, and the uppercase host in SKILL.md is normalized to the canonical lowercase form.

Validation

  • agentskills.io link verified live (200)
  • README.md regenerated from README.Rmd via rmarkdown::render
  • The landing page is dependency-free (inline CSS, light/dark aware) and cannot break the pkgdown build

- serve a human-readable SKILL.html next to SKILL.md so the previously
  404ing URL resolves; the Markdown file remains the canonical artifact
  for agents
- rewrite the 'Agent skill (remote)' section: explain what the file is,
  how to fetch it, and link the file, landing page, and source; drop the
  awkward '(remote)' qualifier and the uppercase host name
- fix the comma-splice sentence in 'Learning geokit'
- normalize https://WangLabCSU.github.io to the lowercase canonical host
  throughout SKILL.md
@ShixiangWang
ShixiangWang merged commit 83335ba into main Oct 25, 2026
7 checks passed
@ShixiangWang
ShixiangWang deleted the fix/skill-page-and-readme branch October 25, 2026 14:18
@codecov

codecov Bot commented Oct 25, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant