Skip to content

Repository files navigation

Surf Skills mascot

Surf Skills

A curated directory of open-source AI agent skills — each one shown actually working.

surfskills.surf MIT license

readme-demo.mp4

What this is

Skill marketplaces show you a name and a description; Surf Skills shows you the output. Every skill in the directory has a preview of what it actually makes, so you can judge it before installing. Skills are open source and work with the agent you already use — Claude, ChatGPT, Cursor.

Tech stack

Quick start

npm install
cp .env.example .env             # public config
cp .dev.vars.example .dev.vars   # secret keys — never commit
npm run dev

.env holds public build-time values (Supabase URL, PostHog key) that Vite inlines into the bundle. .dev.vars holds runtime secrets that only exist inside the Worker; in production they are set with wrangler secret put.

Project structure

src/
  pages/          routes; marketing pages prerender, DB-backed pages opt into SSR
  data/           catalog models: Supabase-driven directory + hand-picked homepage showcase
  lib/            auth, edge caching, SEO, server-side analytics
  scripts/        client-side code, including the Discover filtering engine
  middleware.ts   per-request Supabase client and cache defaults
supabase/
  migrations/     database schema

License

MIT

Third-party assets

The logos in public/logos/ and the website screenshots in public/blog/ belong to their respective owners. They are used nominatively/editorially to identify the tools and sites they depict, and are not covered by the MIT license.

About

Agent skills with video previews

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages