# HubSet agent guide

HubSet is a public junction for work with AI agents. It helps people and web agents discover curated external skills, GitHub projects, UI components, design-inspiration sites, frontend tools, tutorials, current agentic research, AI access options, and benchmark snapshots. HubSet is a catalog and research starting point: follow each record's canonical HubSet detail page, then its official external link when you need the source, install command, sign-up, or documentation.

- Canonical site: <https://hubset.live/>
- Human-readable Agent View: <https://hubset.live/agent>
- This index: <https://hubset.live/agent.md>
- Complete live Markdown catalog: <https://hubset.live/agent/catalog.md>
- Complete live JSON catalog: <https://hubset.live/api/agent-catalog>
- Discovery file: <https://hubset.live/llms.txt>
- Public content is readable without authentication.
- This file describes navigation and data contracts. To enumerate every currently published post, skill, repository, Toolbox site, tutorial, Free AI plan/offer, and leaderboard, fetch the complete live catalog above. It is generated from the database and updates automatically as content changes.
- Mutating APIs require explicit bearer-key permissions. Never infer write access from a public read endpoint.
- Content publishers must verify `GET /api/agent-catalog?refresh={timestamp}` after every authorized mutation. The live catalog is generated from the database; individual content changes never require editing this static navigation file.

## Public sections

| Section | Human page | Agent guide | Public data |
| --- | --- | --- | --- |
| Home | [hubset.live](https://hubset.live/) | [Home](https://hubset.live/agent/home.md) | Posts, leaderboards, repositories, resources |
| Blog | [Blog](https://hubset.live/blog) | [Blog](https://hubset.live/agent/blog.md) | [`GET /api/posts`](https://hubset.live/api/posts) |
| Repos/Skills | [Repos/Skills](https://hubset.live/repos) | [Repos/Skills](https://hubset.live/agent/repos-skills.md) | Skills, GitHub projects, UI components, design inspiration, and frontend tools |
| Tutorials | [Tutorials](https://hubset.live/tutorials) | [Tutorials](https://hubset.live/agent/tutorials.md) | [`GET /api/resources`](https://hubset.live/api/resources) |
| Free AI | [Free AI](https://hubset.live/access) | [Free AI](https://hubset.live/agent/free-ai.md) | [`GET /api/access`](https://hubset.live/api/access) |
| AI Leaderboard | [AI Leaderboard](https://hubset.live/leaderboards) | [AI Leaderboard](https://hubset.live/agent/ai-leaderboard.md) | [`GET /api/leaderboards`](https://hubset.live/api/leaderboards) |
| About | [About](https://hubset.live/about) | [About](https://hubset.live/agent/about.md) | Editorial description; no dedicated API |

## Detail route conventions

- Blog post: `/blog/{post.slug}`; fetch the record with `GET /api/posts?slug={post.slug}`.
- Skill or repository: `/repos/{repo.slug}`; fetch the record with `GET /api/repos?slug={repo.slug}`.
- Toolbox or tutorial resource: `/repos/resources/{resource.slug}`; fetch the record with `GET /api/resources?slug={resource.slug}`.
- Free AI provider, plan, or offer: `/access/{provider.slug}`; fetch the provider with `GET /api/access?slug={provider.slug}`.
- AI board: `/leaderboards?board={leaderboard.slug}`; fetch it with `GET /api/leaderboards?slug={leaderboard.slug}`.
- AI board snapshot: add `snapshot={snapshot.id-or-key}` to both the page and API URL.

See [content routes and API usage](https://hubset.live/agent/content-routes.md) for field semantics, compatibility paths, and safe traversal guidance.

## Recommended traversal

1. Read this index and fetch the [complete live catalog](https://hubset.live/agent/catalog.md). Do not treat the examples or section descriptions as the inventory.
2. Read the guide for the relevant section, then use its public JSON collection when you need full record fields.
3. Follow canonical detail URLs built from each record's `slug`.
4. Use HubSet summaries and tags to shortlist useful results for a human or the current task; do not assume the catalog is exhaustive or that a time-sensitive offer is still available.
5. Treat external `source_url`, `url`, `github_url`, `website_url`, and leaderboard source links as outbound references, not HubSet pages. Prefer the record's official HTTPS link over a discovery/referral link.
6. For a skill, use the displayed install command only when HubSet supplies one; otherwise open the canonical GitHub or website link. Never invent or execute a command automatically.
7. Preserve repeated query parameters where documented and percent-encode user- or content-derived values.

## Fast routing

- Need an agent skill, a component library, a UI pattern, design inspiration, or a frontend tool? Start at [Repos/Skills](https://hubset.live/repos) and read its guide.
- Need a practical walkthrough, course, video, reference, or documentation? Start at [Tutorials](https://hubset.live/tutorials).
- Need recent agentic news, product updates, or research context? Start at [Blog](https://hubset.live/blog), then use its source links for provenance.
- Need published AI subscriptions, API access, free tiers, or time-limited offers? Start at [Free AI](https://hubset.live/access) and confirm the current terms on the official provider page.
- Need benchmark context or a historical model comparison? Start at [AI Leaderboard](https://hubset.live/leaderboards).

For a crawlable list of the stable collection pages and public guides, also read [sitemap.xml](https://hubset.live/sitemap.xml). Primary navigation intentionally remains human-focused; these guides are public, not agent-only, and never expose private/admin routes or credentials.