Skip to content

feat: serve version-matched skill instructions from the CLI - #5

Merged
suraciii merged 2 commits into
mainfrom
feat/cli-skill
Aug 13, 2026
Merged

feat: serve version-matched skill instructions from the CLI#5
suraciii merged 2 commits into
mainfrom
feat/cli-skill

Conversation

@suraciii

@suraciii suraciii commented Aug 13, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add pages skill, a read-only command that prints a complete SKILL.md embedded in the installed binary.
  • Replace the distributed Pages skill with a small bootstrap that uses the installed CLI or installs the current CLI with go install.
  • Keep the three existing product actions unchanged. skill is CLI metadata and does not read configuration, inspect the filesystem, or access the network.

Distribution model

The repository skill is a stable entry point. It first tries:

pages skill

When the CLI is absent or too old, it installs the current version:

go install github.com/suraciii/pages@latest

It then runs pages skill again and follows the version-matched instructions. The bootstrap does not manage the user's shell, contain operational command syntax, or depend on Agent-specific install paths.

Command contract

  • pages skill writes only the complete skill to stdout and exits 0.
  • pages skill --help and pages skill -h write only Usage: pages skill to stdout and exit 0.
  • Other arguments write an error and usage to stderr and exit 2.
  • The emitted skill is embedded at build time and matches the CLI version.

Verification

  • make ci
  • go test -race ./...
  • Linux, macOS, and Windows builds
  • Standard skill validation for the bootstrap and embedded skills
  • Built-binary output validation: pages skill matches the embedded SKILL.md byte-for-byte

@suraciii
suraciii merged commit b77b235 into main Aug 13, 2026
1 check passed
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