Skip to content

feat: show what skilld does differently on home and vs page - #516

Merged
harlan-zw merged 9 commits into
mainfrom
feat/why-skilld
Oct 7, 2026
Merged

harlan-zw merged 9 commits into
mainfrom
feat/why-skilld

Conversation

@harlan-zw

@harlan-zw harlan-zw commented Oct 7, 2026 •

Copy link
Copy Markdown
Collaborator

🔗 Linked issue

None. Harlan asked for a visual answer to "why skilld over skills.sh".

❓ Type of change

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

📚 Description

Visitors ask why they should pick skilld over skills.sh. The answer was a six-row Markdown table at /vs/skills-sh, and the homepage only linked to it.

The homepage gets a "What skilld does differently" band after Trending. It has three minimal columns, each a title, one line, and a small picture of the real interface:

  • Human first: a maintainer with the exact SKILL.md, then the devs who posted about the top trending Skill, in their words.
  • Preview the output: two landing page demos side by side, to compare output before spending tokens.
  • Independent and open source: both public repositories, MIT, and the pull requests merged into them most recently. A new /api/feed/recent-pull-requests route reads them from GitHub and caches the answer for a day.

The columns share one subgrid, so every column ends at the same height. The band closes on Harlan's avatar and a button to the comparison.

/vs/skills-sh is now a Vue page built from the same pictures. It covers eight reasons, the homepage three first. Open trending weights is one of them: the weights from shared/trending-skill-score.ts, with a link to that file. Each skills.sh line carries its source link, and the page dates the facts to 7 Oct 2026. It lists where skills.sh is ahead and ends on a full table. app/utils/why-skilld.ts holds every string. The page stays noindex under the page admissions record.

Some claims changed after checking skills.sh:

  • Its CLI is MIT too, so "open source" pairs with "no telemetry".
  • It added skills use in May 2026, so the run reason contrasts a temporary directory with writing nothing.
  • skilld already shows the same partner audit verdicts, so audits are no longer listed as a skills.sh lead.

COPY.md drops its ban on calling the site open source, since skilld-dev/skilld.dev is public under MIT.

The band answers one question: why skilld and not skills.sh. Its one action is "Compare with skills.sh". It adds a band and removes none from the homepage. The Markdown comparison page is deleted.

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

Visitors kept asking why skilld over skills.sh, and the answer lived in a
short Markdown table. The homepage now shows four reasons as small pictures
of the real interface, and /vs/skills-sh expands all seven with a sourced
skills.sh line each, where skills.sh is ahead, and a full table.
@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 7, 2026
@harlan-zw

Copy link
Copy Markdown
Collaborator Author

Agent note. Checked by hand, since CI cannot cover it:

  • Rendered the homepage band and /vs/skills-sh in headless Chrome at 1440 and 390 wide, in light and dark.
  • At 390 wide, both pages measure a scroll width of 390, so no picture pushes the page sideways.
  • The ranking picture and the demo picture drew live rows from the production /api/feed/trending and /api/skill-demos feeds.
  • The skills.sh lines were checked on 2026-10-07 against skills.sh pages and vercel-labs/skills source. Each line links its source on the page.

@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 7, 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. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. and removed harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review Pull request triage requires an adversarial Review. Adding this label manually always forces one. labels Oct 7, 2026
@harlan-github-agent

harlan-github-agent Bot commented Oct 7, 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-07 03:28 UTC.

GitHub merged this pull request.

No material findings were recorded.

The pull request closed.

@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 7, 2026
The four-tile grid ran about 1,150px on an already long homepage, and its
reasons read as features. Two also repeated bands above it: demos show the
output, and every card names its author. The band is now a tab list beside
one picture, and the reasons say what a dev gets: no skill bloat, what a
Skill runs, what it costs, and rankings anyone can check.
@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 7, 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 7, 2026
Numbers carried no meaning, since the reasons have no order to follow. An icon per reason makes the rows scannable, on the homepage tabs and the comparison page alike.
@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 7, 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. harlan-agent-running An Agent holds a Task on this issue or pull request right now. labels Oct 7, 2026
Hover picked a new row while keyboard focus stayed on the old one, so the ring and the highlight sat on different rows. Focus now follows a hover pick, and the ring sits inside the row, since the site-wide ring forces its offset with !important. The trust line drops its rule, which doubled the list's last one, and says the registry works without a terminal.
@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 7, 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. harlan-agent-running An Agent holds a Task on this issue or pull request right now. labels Oct 7, 2026
@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 7, 2026
Harlan chose the three reasons that set skilld apart on the homepage: the
people behind Skills, demo output to compare before spending tokens, and
open trending weights with no paid placement. They sit in three minimal
columns on one subgrid, so every column ends at the same height.

skilld already shows the partner audit verdicts skills.sh shows, so the
comparison no longer lists them as a skills.sh lead. Copy got a pass for
generated-sounding phrasing.
@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 7, 2026
Both skilld repositories are public under MIT, so the Independent column
now says so and shows the pull requests merged into them most recently.
A new feed reads them from GitHub and caches the answer for a day, so it
spends about two calls a day. The trending weights move to their own
reason on the comparison page. Decorative underlines in the band's
pictures and trust line are gone.
Harlan cut the intro line and the trust line's claims. The columns carry every claim, so the band closes on who builds skilld and the route to the comparison.
@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 7, 2026
@harlan-zw
harlan-zw merged commit 2b007ad into main Oct 7, 2026
7 checks passed
@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 7, 2026
@harlan-zw harlan-zw mentioned this pull request Oct 7, 2026
1 of 6 tasks
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