Hep.gg Documentation

AI Skills

A public registry of Claude-compatible agent skills at skills.hep.gg. Fetch public skills, expose your private skills to an agent with a capability URL, or save a skill straight from a chat.

View as LLM-ready text

AI Skills is a registry for Claude-compatible skills: a SKILL.md (a name, a when-to-use description, and a body) plus optional supporting files. Skills are served as raw markdown so an LLM or coding agent can WebFetch them directly into its context.

URL scheme

Everything is a GET and returns markdown (or a raw supporting file). No auth is needed for public skills; private skills are reached through a capability URL (see below).

GEThttps://skills.hep.gg/Public
Global public directory: every public skill whose owner holds Hep.gg Prime, newest first.
GEThttps://skills.hep.gg/:usernamePublic
One user's public skill catalog.
GEThttps://skills.hep.gg/:username/:slugPublic
Raw SKILL.md for one public skill (frontmatter + body).
GEThttps://skills.hep.gg/:username/:slug/:filenamePublic
A public skill's supporting file (reference, example, script).

Public responses are cached for 60 seconds. An unknown username or slug returns a 404 with a short not-found markdown body. Only public skills resolve on the /<username> paths; unlisted and private skills 404 there.

# Pull a public skill straight into an agent
curl https://skills.hep.gg/alice/deploy-nextjs

Private access (capability URL)

Your personal access URL exposes your public, unlisted, and private skills in one fetch. The access key in the URL is the credential, so anyone who has the URL can read your private skills until you rotate it. Get (or rotate) it in the dashboard under AI › Skills › Access URL.

GEThttps://skills.hep.gg/me/:accessKeyAuth optional
Your full catalog, including private skills. Paste into an agent's context (e.g. CLAUDE.md).
GEThttps://skills.hep.gg/me/:accessKey/:slugAuth optional
Raw SKILL.md for one of your skills (private-capable).
GEThttps://skills.hep.gg/me/:accessKey/:slug/:filenameAuth optional
A supporting file for one of your skills (private-capable).

Saving a skill from an agent

The import endpoint lets an agent save the skill it just built straight to your account. It is the only write endpoint on skills.hep.gg.

POSThttps://skills.hep.gg/me/:accessKey/importAuth optional
Create or save a skill to the owner of the access key.
Body
name
stringrequired
Human name of the skill.
description
stringrequired
The when-to-use sentence an agent reads to decide whether to invoke the skill.
content
stringrequired
The SKILL.md body, WITHOUT frontmatter (the name and description are assembled into frontmatter for you).
slug
stringoptional
URL slug (lowercase a-z0-9-). Auto-derived from name if omitted. A collision returns 409.
visibility
stringoptionaldefault: private
One of private, unlisted, public. Defaults to private so an import lands quietly; pass public to publish.
files
arrayoptional
Optional supporting files: [{ filename, content }]. Each filename must be a safe relative name; per-skill count and per-file size limits apply.
curl
curl -X POST https://skills.hep.gg/me/YOUR_ACCESS_KEY/import \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Deploy a Next.js app",
    "description": "Use when deploying a Next.js app to Vercel or Cloudflare Pages.",
    "content": "# Deploy a Next.js app\n\n1. ...",
    "visibility": "private"
  }'

On success: { "ok": true, "data": { id, slug, visibility, url, publicUrl, editUrl, files } }. Errors use { "ok": false, "error": "..." }: 401 for an invalid access key, 409 for a slug collision.

Prime and propagation

  • Creating, editing, and sharing skills is open to everyone with AI access. Your skills are reachable by link and via your access URL on any plan.
  • The global public directory is a Hep.gg Prime perk. GET / lists only skills whose owner currently holds Prime, newest first, and a non-Prime owner's /<username> public index is empty (individual skills still resolve by URL).
  • Edits propagate within about 60 seconds (responses are cached for 60s).