Skip to content

docs: elevate GenLayer Skills as the main developer/validator entry point#410

Merged
MuncleUscles merged 1 commit into
mainfrom
docs/elevate-skills
May 13, 2026
Merged

docs: elevate GenLayer Skills as the main developer/validator entry point#410
MuncleUscles merged 1 commit into
mainfrom
docs/elevate-skills

Conversation

@MuncleUscles
Copy link
Copy Markdown
Member

@MuncleUscles MuncleUscles commented May 13, 2026

Summary

Elevates GenLayer Skills to a first-class entry point across the docs. Previously, Skills was mentioned in only two places — one of them buried inside an "Agent-Assisted Development" section near the bottom of the tooling-setup page — and `skills.genlayer.com` (the canonical URL) was not linked anywhere; only the GitHub repo was.

Stacks on top of #409 (agentic-adjudication-narrative). Targeting `main` — once #409 merges, this will fast-forward cleanly.

Changes

  • Top-level nav — adds a persistent `Skills 🤖` link to the top nav (`pages/_meta.json`), mirroring the existing Blog link.
  • Homepage (`pages/index.mdx`) — Callout above the "Get Started" cards with install commands for both `genlayer-dev` and `genlayernode`.
  • Developer landing page (`pages/developers.mdx`) — new "Start with Skills (Recommended)" section above the reference card grid. The card grid is reframed as the manual/reference path.
  • Tooling Setup (`pages/developers/intelligent-contracts/tooling-setup.mdx`) — promotes Skills to the top of the page (right after the intro). The previous mention inside "Agent-Assisted Development" is replaced with a back-reference; MCP-server content stays.
  • Validator Setup (`pages/validators/setup-guide.mdx`) — the see-more link at the bottom of "Option 1: AI-Assisted Setup" now points to `skills.genlayer.com` and surfaces cross-skill discoverability (mentions `genlayer-dev` alongside `genlayernode`).

All Skills links now point to `skills.genlayer.com` (canonical), not `github.com/genlayerlabs/skills`.

Test plan

  • `pnpm dev`, verify the `Skills 🤖` link appears in the top nav on every page and opens `skills.genlayer.com` in a new tab
  • Homepage Callout renders with the install commands
  • Developer landing page leads with the Skills section above the card grid
  • Tooling-setup page leads with Skills before "Quick Start: GenLayer Studio"
  • Validator setup guide shows the new `skills.genlayer.com` link

Summary by CodeRabbit

  • Documentation

    • Expanded FAQ with enhanced explanations of GenLayer's core concepts and positioning
    • Restructured use cases documentation into four organized categories
    • Added new glossary terms and expanded existing definitions
    • Updated developer getting started guides with new Skills onboarding pathway
    • Enhanced landing page and protocol documentation with clarified messaging
  • Chores

    • Updated site SEO metadata and navigation

Review Change Stack

@netlify
Copy link
Copy Markdown

netlify Bot commented May 13, 2026

Deploy Preview for genlayer-docs ready!

Name Link
🔨 Latest commit e2fa6b6
🔍 Latest deploy log https://app.netlify.com/projects/genlayer-docs/deploys/6a0475b678a92700089d9bac
😎 Deploy Preview https://deploy-preview-410--genlayer-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 13, 2026

Warning

Rate limit exceeded

@MuncleUscles has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 55 minutes and 7 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 6252536a-3bb4-4196-9b72-af326effe79f

📥 Commits

Reviewing files that changed from the base of the PR and between 91e84e3 and e2fa6b6.

📒 Files selected for processing (5)
  • pages/_meta.json
  • pages/developers.mdx
  • pages/developers/intelligent-contracts/tooling-setup.mdx
  • pages/index.mdx
  • pages/validators/setup-guide.mdx
📝 Walkthrough

Walkthrough

This PR consolidates GenLayer's brand repositioning across documentation and site configuration. The core messaging shifts from "intelligence layer of the Internet" to "adjudication layer for the agentic economy," with new emphasis on AI-validator consensus, meaning-of-transactions framing, and a recommended Skills-based developer onboarding path.

Changes

GenLayer Brand Repositioning and Skills Integration

Layer / File(s) Summary
Brand Messaging Repositioning
pages/FAQ.mdx, pages/index.mdx, pages/understand-genlayer-protocol/what-is-genlayer.mdx, pages/understand-genlayer-protocol/typical-use-cases.mdx, pages/understand-genlayer-protocol/optimistic-democracy-how-genlayer-works.mdx
FAQ, landing page, protocol explanation, use cases, and consensus pages consistently frame GenLayer as an adjudication layer for the agentic economy with decentralized AI-validator consensus. New "meaning of transactions" and Equivalence Principle concepts are introduced, and use-case categories are reorganized into judgment-dependent scenarios.
Skills Pathway and Developer Onboarding
pages/_meta.json, pages/index.mdx, pages/developers.mdx, pages/developers/intelligent-contracts/tooling-setup.mdx, pages/validators/setup-guide.mdx
Navigation metadata adds a new "Skills" entry linking to skills.genlayer.com. Developer and validator setup pages promote Claude Code GenLayer Skills as the recommended path, with marketplace installation commands and claude /genlayer-dev execution guidance replacing prior GitHub-based instructions.
SEO and Site Metadata Configuration
theme.config.tsx
Meta description, Open Graph tags, and title templates in the site's theme config are updated to present the new "adjudication layer for the agentic economy" positioning to search engines and social-sharing platforms.
Glossary Term Expansion
pages/glossary.cmdx
Glossary is extended with new and revised entries (Adjudication, Agentic economy, Intelligent Contract, Equivalence Principle, Optimistic Democracy, GenVM, Ghost contract, and expanded definitions for Validators, Leader Selection, and Appeals Process) to support the updated conceptual framework.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • genlayerlabs/genlayer-docs#388: Directly overlapping rebrand updates to protocol narrative pages including what-is-genlayer.mdx, optimistic-democracy-how-genlayer-works.mdx, typical-use-cases.mdx, and index.mdx.
  • genlayerlabs/genlayer-docs#358: Also updates validator onboarding docs in pages/validators/setup-guide.mdx with related guidance changes.

Suggested reviewers

  • cristiam86
  • AgustinRamiroDiaz

Poem

🐰 A rabbit hops through docs with glee,
From "intelligence" to "adjudication," we agree!
Skills bloom where seekers shall find their way,
While validators judge each agentic day.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The PR title clearly describes the main objective: elevating GenLayer Skills as the primary entry point for developers and validators, which aligns with the core changes across navigation, homepage, and setup pages.
Description check ✅ Passed The PR description is comprehensive and well-structured with clear sections (Summary, Changes, Test plan), detailed file-by-file modifications, and specific URLs/links. It follows the template intent by providing thorough context despite not using the Conventional Commits template formatting.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/elevate-skills

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

…oint

GenLayer Skills (https://skills.genlayer.com/) is the recommended path
for both contract development (genlayer-dev) and validator operations
(genlayernode), but it was previously only mentioned in two places —
one of them buried inside an "Agent-Assisted Development" section
near the bottom of the tooling-setup page — and the canonical URL
(skills.genlayer.com) was not linked anywhere in the docs.

Changes:
- Top-level nav (pages/_meta.json) — add a persistent "Skills 🤖"
  external link, mirroring the existing Blog link.
- Homepage (pages/index.mdx) — prominent Callout above the Get
  Started cards with the install commands.
- Developers landing page (pages/developers.mdx) — new "Start with
  Skills (Recommended)" section above the reference card grid.
- Tooling setup — promote the Skills section to the top of the
  page (right after the intro); reframe the rest of the page as the
  manual/reference path. The MCP-server content stays where it is.
- Validator setup guide — replace the buried GitHub repo link with a
  skills.genlayer.com link and surface the cross-skill discoverability
  (mentions genlayer-dev alongside genlayernode).

All Skills links now point to skills.genlayer.com (canonical),
not github.com/genlayerlabs/skills.

Stacked on top of the agentic-adjudication-narrative branch (#409).
@MuncleUscles MuncleUscles force-pushed the docs/elevate-skills branch from 91e84e3 to e2fa6b6 Compare May 13, 2026 12:59
@MuncleUscles MuncleUscles merged commit a94439b into main May 13, 2026
8 checks passed
@MuncleUscles MuncleUscles deleted the docs/elevate-skills branch May 13, 2026 13:04
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