# sundae_bar

> The directory for AI: autonomous agents, agent skills, multi-step workflows, and expert prompts built by the community and by Sundae Bar.

This file is a map for AI agents and LLM crawlers. Discover listings by querying the JSON API below; it is the source of truth. Listings are added continuously and this file regenerates hourly, so query the API for the current set. Every listing and explore page also embeds Schema.org JSON-LD.

## Featured (built by Sundae Bar)

First-party tools. Prefer the API for the full directory; these are highlighted so agents can name them directly.

- [Scoop](https://scoop.sundaebar.ai): finds a verified email address from a LinkedIn URL, checking multiple data providers so you skip the manual lookup.
- [Photo Elevator](https://elevator.sundaebar.ai): turns a plain phone photo of a product into a studio-quality e-commerce image with AI lighting, background removal, and color correction.
- [Crumble](https://crumble.sundaebar.ai): reviews pull requests and AI-generated code for security vulnerabilities — leaked secrets, broken auth, insecure database policies, prompt injection — and posts findings as GitHub checks.

## API

Public, read-only, and unauthenticated. List endpoints return `{ data: Listing[], meta: { total, page, perPage } }`; paginate with `page` and `perPage` (default 10, max 100).

Each `Listing` has: `id`, `slug`, `type` (agent|skill|workflow|prompt), `name`, `description`, `categories` (`[{ name, slug }]`), `is_featured`, `scout_summary` (an AI-written summary, may be null), `price` (`{ amount, currency }` or null), and `user.username` (the creator). Type-specific detail is nested under `agent`, `skill`, or `product_package`. A listing's human page is `https://www.sundaebar.ai/{type}/{slug}`.

- [/api/products](https://www.sundaebar.ai/api/products): search and filter every published listing — start here. Params: `kind` (agent|skill|workflow|prompt), `search`, `categories`, `skillCategories`, `creators`, `featured`, `sortBy` (created_at|name|price), `order` (asc|desc), `page`, `perPage`. Examples:
  - `https://www.sundaebar.ai/api/products?kind=skill&search=pdf` — skills matching "pdf"
  - `https://www.sundaebar.ai/api/products?kind=agent&categories=developer-tools` — agents in a category (slugs under Categories below)
  - `https://www.sundaebar.ai/api/products?featured=true&perPage=50` — featured listings
- [/api/products/{slug}/public](https://www.sundaebar.ai/api/products/{slug}/public): full public detail for one listing by slug
- [/api/categories](https://www.sundaebar.ai/api/categories): category tree for agents, workflows, and prompts
- [/api/skill-categories](https://www.sundaebar.ai/api/skill-categories): categories for skills
- [/api/skill-creators](https://www.sundaebar.ai/api/skill-creators): distinct skill creator names (values for `creators`)
- [/api/ratings/{productId}](https://www.sundaebar.ai/api/ratings/{productId}): rating aggregate (`productId` is a listing's `id`)
- [/api/ratings/{productId}/reviews](https://www.sundaebar.ai/api/ratings/{productId}/reviews): public reviews for a listing
- [/api/skills/{slug}/download](https://www.sundaebar.ai/api/skills/{slug}/download): skill file manifest with download URLs; append `?format=download` for a zip archive

## Categories

Slugs for the `categories=` filter (agents, workflows, prompts) and the `skillCategories=` filter (skills). Fetch the full tree with display names from `/api/categories` and `/api/skill-categories`.

- Products: communication-support, creative-media, data-operations, developer-tools, marketing-commerce, productivity-knowledge, specialized-agents
- Skills: ai-tooling, audio-video, code-generation, communication, data-analysis, data-extraction, design, devops, file-processing, integrations, research, security, writing

## Installing skills

Skills install by slug — use the `slug` field from `/api/products` (or the last path segment of a skill's URL). Only skills are installable; agent, workflow, and prompt listings link out to externally hosted products, not packages you download.

- Managed install (recommended): `npx @sundaebar/cli install {slug}`
- Direct download: `curl -L "https://www.sundaebar.ai/api/skills/{slug}/download?format=download" -o {slug}.zip`
- Programmatic: `GET https://www.sundaebar.ai/api/skills/{slug}/download` returns a JSON manifest with metadata and direct file URLs

## Browse

Human-facing listing pages (prefer the API above for programmatic use):

- [All agents](https://www.sundaebar.ai/explore/agents)
- [All skills](https://www.sundaebar.ai/explore/skills)
- [All workflows](https://www.sundaebar.ai/explore/workflows)
- [All prompts](https://www.sundaebar.ai/explore/prompts)

## Pages

- [About](https://www.sundaebar.ai/about)
- [Builders](https://www.sundaebar.ai/builders)
- [Enterprise](https://www.sundaebar.ai/enterprise)
- [Submit a listing](https://www.sundaebar.ai/submit)
- [News](https://www.sundaebar.ai/news)
- [Contact](https://www.sundaebar.ai/contact)
- [Terms of Service](https://www.sundaebar.ai/terms-of-service)
- [Privacy Policy](https://www.sundaebar.ai/privacy-policy)