Skip to content

Add community skills search, pagination, and an "Add your skill" section#34

Open
kaankacar wants to merge 4 commits into
mainfrom
33-community-skills-search-pagination-and-an-add-your-skill-section
Open

Add community skills search, pagination, and an "Add your skill" section#34
kaankacar wants to merge 4 commits into
mainfrom
33-community-skills-search-pagination-and-an-add-your-skill-section

Conversation

@kaankacar

Copy link
Copy Markdown
Collaborator

Closes #33.

  • New CommunitySearch client island for the community section: search matches the card title and any part of the description (searching "DEX" surfaces the Soroswap skill), with pagination at 8 cards per page. Cards are still server-rendered and passed in as children, same slot pattern as SkillsFilter, so every entry stays in the static HTML and nothing changes for agents and crawlers.
  • "Add your skill" block at the bottom of the community section: open a PR adding an entry to ECOSYSTEM_CARDS in site/src/data/skills.ts. The entry format is inlined and the link goes to GitHub's edit view, which starts the fork + PR flow for non-collaborators.
  • The llms.txt community blurb now ends with the same instruction, so agents reading /llms.txt know how to submit too. Every community skill keeps appearing there regardless of what the UI shows.

With only 4 community cards today nothing visibly changes except the search box and the new section; pagination kicks in past 8 cards. pnpm lint, pnpm lint:ts, and pnpm build pass, and out/index.html was checked to confirm all card data remains in the server HTML.

- CommunitySearch client island filters the server-rendered community
  cards by title or any part of the description, and paginates them at
  8 per page. Cards stay in the static HTML for agents and crawlers.
- "Add your skill" block explains how to get listed via a PR against
  ECOSYSTEM_CARDS in site/src/data/skills.ts, entry format inlined.
- The llms.txt community blurb now tells agents how to submit a skill.
@kaankacar kaankacar self-assigned this Jun 12, 2026
Copilot AI review requested due to automatic review settings June 12, 2026 14:34
@kaankacar kaankacar linked an issue Jun 12, 2026 that may be closed by this pull request
3 tasks
@github-actions

github-actions Bot commented Jun 12, 2026

Copy link
Copy Markdown
PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://stellar.github.io/stellar-dev-skill/pr/pr-34/

Built to branch gh-pages at 2026-06-12 16:02 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR enhances the landing page’s Community skills section to better scale with more entries by adding a client-side search + pagination island while keeping community card content server-rendered in the static HTML, and it documents a clear contribution path via an “Add your skill” section and updated llms.txt blurb.

Changes:

  • Added CommunitySearch client island to provide case-insensitive title/description search and pagination (8 cards/page) over pre-rendered community cards.
  • Added an “Add your skill” contribution block linking to GitHub’s edit flow and showing the required ECOSYSTEM_CARDS entry format.
  • Updated /llms.txt generation and site docs to instruct contributors how to submit new community skills.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
site/src/app/styles.scss Adds styling for community search input, per-card wrappers, pagination, and the “Add your skill” block.
site/src/app/page.tsx Wraps community cards in CommunitySearch and adds the “Add your skill” section/snippet and contribution links.
site/src/app/_components/CommunitySearch.tsx New client component implementing search + pagination by toggling wrapper visibility around server-rendered children.
site/scripts/generate-llms-txt.mjs Extends the Community Built blurb to include contribution instructions while still listing all community skills.
site/CLAUDE.md Documents the new CommunitySearch island and notes ecosystem entries require no extra wiring.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +69 to +78
<div className="SkillsLanding__ecosystemGrid">
{Children.map(children, (child, index) => (
<div
className="SkillsLanding__communityItem"
data-hidden={!visible.has(index)}
>
{child}
</div>
))}
</div>
Nothing reads it: the community grid renders outside SkillsFilter, the
search haystack is title + description only, and llms.txt lists the
community section flat. Requiring contributors to copy a field that
does nothing (and silently accepts any FilterType value) just invites
confusion, so remove it from the type, the four entries, the on-site
snippet, and the docs. The standards skill's "Ecosystem" category in
SKILL_CARD_SOURCES stays; that one drives the main grid's filter tab.
- Search input now spans exactly one grid column so it lines up with
  the card below it (full width on narrow screens)
- "Showing x of y skills" line renders under the community grid, above
  the Add your skill block, and doubles as the aria-live status for
  search results (replaces the screen-reader-only span)
@jeesunikim

jeesunikim commented Jun 12, 2026

Copy link
Copy Markdown
Screenshot 2026-06-12 at 2 12 13 PM
  • "Showing .. of 4 skills" styling seems off

@jeesunikim

Copy link
Copy Markdown

I noticed that defindex-sdk and soroswap's skills aren't following the right format (SKILL.md). I created an issue on their page paltalabs/defindex-sdk#10. Tyler's already created a similar issue on soroswap side soroswap/sdk#9

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.

Community skills: search, pagination, and an "Add your skill" section

3 participants