Skip to content

feat(home): show every agent skilld works with, and a setup prompt - #463

Merged
harlan-zw merged 2 commits into
mainfrom
feat/home-connect-agent
Oct 6, 2026
Merged

harlan-zw merged 2 commits into
mainfrom
feat/home-connect-agent

Conversation

@harlan-zw

Copy link
Copy Markdown
Collaborator

🔗 Linked issue

None. This follows a comparison with skillry.dev, which shows its Agents and a paste-in setup prompt on its homepage.

❓ Type of change

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

📚 Description

Skills already reach 19 CLI Agents, plus ChatGPT and Claude through MCP and ZIP upload. The homepage named none of them, and "Teach your agent skilld" offered only a terminal command. A visitor without a terminal had no way in, and the page read as CLI only.

  • Hero. A quiet row of seven Agent logos and +12 sits under the claims line and links the new section. The promo popover adds a prompt to paste into any agent.
  • Works with your agent. A new section after trending. Tiles link each CLI Agent's /agents/<id> page; Claude and ChatGPT link their MCP setup steps. Beside them are three ways in: the prompt, npx skilld install skilld --global, and the MCP server URL.
  • /agent.md. The prompt sends the Agent here. It holds setup steps for a shell, an MCP app, or plain URL fetch, built from shared/skill-commands.ts so the grammar gate checks every command. It answers noindex. It is a middleware because nuxt-ai-ready answers every explicit .md path from its own middleware.

REGISTRY_MCP_URL moves from the marketing layer to shared/agent-setup.ts, so the homepage prints it without importing that layer. COPY.md records the new strings.

Prompt copies are not recorded yet. The install event only knows run and install, so the prompt needs its own event.

Architecture: the hero and the new HomeAgents section read the prompt and MCP URL from shared/agent-setup, which the new /agent.md middleware also serves to the user's Agent

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

Skills already reach 19 CLI Agents plus ChatGPT and Claude, but the
homepage named none of them, and "Teach your agent skilld" offered only
a terminal command. A visitor without a terminal had no way in.

The hero gets a quiet logo row. A new "Works with your agent" section
lists the Agents and three ways in: a prompt to paste into any agent,
the terminal install, and the MCP server. The prompt points at
/agent.md, setup steps an Agent follows, built from the shared command
builders so the grammar gate checks them. The promo popover offers the
same prompt.
@harlan-zw

Copy link
Copy Markdown
Collaborator Author

Agent check (Harlan Agent Kit), on a local dev build with production feeds:

  • GET /agent.md answered 200, text/markdown, X-Robots-Tag: noindex. Before the middleware it fell through to nuxt-ai-ready's "Page not found" markdown.
  • The URLs /agent.md hands out answer in production: /api/v1/skills?q=tailwind returns results, /api/skills-raw/vercel-labs/agent-skills/web-design-guidelines returns text/markdown, and /api/mcp answers initialize.
  • pnpm cli:grammar came back clean against skilld 3.6.1.
  • Every tile link resolved: seven /agents/<id> pages, two /developers?setup=mcp&app=…, and /cli#install.
Hero Promo popover
Hero with the Agent logo row Promo popover with the setup prompt
Section, dark Section, light 390px
Works with your agent, dark Works with your agent, light Works with your agent, mobile

@harlan-zw harlan-zw added the harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. label Oct 6, 2026
@harlan-github-agent harlan-github-agent Bot added harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. and removed harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. labels Oct 6, 2026
The component coverage check failed CI: every component needs an axe test or a documented skip.
@harlan-zw harlan-zw added the harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. label Oct 6, 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-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. labels Oct 6, 2026
@harlan-github-agent

harlan-github-agent Bot commented Oct 6, 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-06 13:46 UTC.

GitHub merged this pull request.

  • Logged (20/100): The /agent.md middleware only answers the exact bare path; any query string falls through to the Page-not-found markdown. View code
    • Ask an agent to verify and fix this finding
  • Logged (15/100): The new middleware answers before the canonical-host redirect, so non-canonical hosts serve /agent.md directly with edge-cacheable headers. View code
    • Ask an agent to verify and fix this finding
  • Logged (35/100): The PR's visual evidence is inaccessible to this reviewer, so the rendered homepage changes are unverified by pixels. 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 merged commit e18fc83 into main Oct 6, 2026
7 checks passed
@harlan-github-agent harlan-github-agent Bot removed the harlan-agent-running An Agent holds a Task on this issue or pull request right now. label Oct 6, 2026
@harlan-github-agent harlan-github-agent Bot removed the harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. label Oct 6, 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