Skip to content

feat(cli): add the /cli landing page and a CLI header link - #435

Merged
harlan-zw merged 1 commit into
mainfrom
feat/cli-page
Oct 5, 2026
Merged

harlan-zw merged 1 commit into
mainfrom
feat/cli-page

Conversation

@harlan-zw

Copy link
Copy Markdown
Collaborator

🔗 Linked issue

No linked issue. Harlan asked for a dedicated CLI page in the header nav.

❓ Type of change

  • 📖 Documentation
  • 🐞 Bug fix
  • 👌 Enhancement
  • ✨ New feature
  • 🧹 Chore
  • ⚠️ Breaking change

📚 Description

The CLI had only /docs/cli, a generated help-text reference, so no page sold what the CLI gets you: Skills in your Agent, kept current. /cli leads with that outcome, shows the CLI as the way there, and links the reference for every flag. The header nav and the mobile menu gain a CLI item after Find Skills.

Architecture: the /cli page renders the brand chips and prints every command from skill-commands.ts, whose new subcommands the deploy grammar gate checks against skilld on npm latest

  • The page runs: opening (H1, the CLI's own --help line, SkilldInstallChip and the new CliInstallChip, braille names texture), three ways in from smallest (Skill URL, RunChip, CLI plus the skilld Skill), one row per verb, the README's run versus install table, Agent facts, the Claude Code plugin, and links to /developers and /docs/cli.
  • Verb rows carry the anchors #search, #run, #install, #update, and #remove.
  • Every printed command comes from shared/skill-commands.ts. The new search, outdated, update, and remove builders join pnpm cli:grammar, so the deploy fails if npm latest loses one.
  • The file is pages/cli/index.vue. A pages/cli.vue would become the parent route of /cli/authorize, the CLI sign-in page.
  • Target query: "skilld cli", then "agent skills cli". The page mirrors /developers: it joins FREEZE_AUDIT_PATHS with no admission, so it renders noindex,follow and the sitemap skips it. Cull path: merge into /docs/cli at the 2026-11-11 gate if it earns no traffic.
  • "19 Agent targets" counts the --agent values of skilld install --help in skilld 3.6.0, which match crates/skilld-core/src/target.rs. The site's AGENT_TARGETS lists 12 and is stale. This pull request leaves it alone, because the 7 missing entries need a confirm step nobody has written.
  • COPY.md records the new canonical strings: the nav label, the H1, the CLI line, the intro, the claims line, and the Install the CLI label.

Known gap: the opening band shows three rose dots (the texture and two chips), as the homepage hero does. DESIGN.md asks for one rose element per band.

🤖 AI disclosure: Harlan Agent Kit modified this description. My AI open-source policy.

The CLI had only a generated help-text reference, so nothing sold what it
gets you: Skills in your Agent, kept current. The page leads with that
outcome and treats the CLI as the way there, then links /docs/cli for
every flag.

Every command it prints comes from shared/skill-commands.ts. The new
search, outdated, update, and remove builders join the deploy grammar
gate. The page mirrors /developers: noindex and out of the sitemap until
a measured query admits it.
@harlan-zw

Copy link
Copy Markdown
Collaborator Author

Agent comment (Harlan Agent Kit). Checked by hand in a local nuxi dev build, headless Chromium, since CI cannot cover it:

  • The header stays one row at 1024px and 1440px (64px tall on /cli and /), with CLI after Find Skills. The mobile menu lists it too.
  • No horizontal page scroll at 390px in light or dark. The run versus install table wraps instead of scrolling.
  • /cli renders noindex,follow and the meta description from the page. /cli/authorize still renders on its own, without the /cli page around it.
  • /cli#update lands 80px from the top, clear of the sticky header.

The round badge and the timing pill near the bottom of each frame are Nuxt dev tools, not the page.

1440 light 1440 dark
1440 light, full page 1440 dark, first screen
390 light 390 dark 390 menu
390 light, first screen 390 dark, first screen 390 dark, mobile menu open

Header at 1024px on /cli

@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Oct 5, 2026
@harlan-github-agent

harlan-github-agent Bot commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

🤖 MERGED

Harlan Agent Kit posted this automated review. It is not Harlan's personal review or approval. AI open source policy. Last updated: 2026-10-05 16:55 UTC.

GitHub merged this pull request.

  • Logged (25/100): The pull request's visual evidence is unverifiable in this review. View code
    • Ask an agent to verify and fix this finding
  • Logged (15/100): The page shows 19 Agent targets beside a verification panel covering 8 of them, unexplained. View code
    • Ask an agent to verify and fix this finding

Review completed. No finding above 80/100.

Selected findings run after merge and open separate pull requests.

@harlan-zw harlan-zw added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Oct 5, 2026
@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. and removed harlan-agent-running An Agent holds a Task on this issue or pull request right now. labels Oct 5, 2026
@harlan-zw
harlan-zw merged commit 29ce855 into main Oct 5, 2026
7 checks passed
@harlan-github-agent harlan-github-agent Bot removed harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Oct 5, 2026
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