Skip to content

shadcn-labs/termcn / .agents/skills/launch-shadcn-registry

launch-shadcn-registry

Verified

Launch and promote a custom shadcn/ui registry end-to-end: validate registry.json, prepare the official shadcn-ui/ui directory PR, community directory PRs (registry.directory, shadcntemplates, birobirobiro/awesome-shadcn-ui, bytefer/awesome-shadcn-ui), and draft social posts for Reddit r/shadcn, X, Dev.to, and Hacker News. Use whenever the user says "launch my registry", "list on shadcn directory", "submit to awesome-shadcn-ui", "announce my shadcn registry", "registry.directory PR", or wants to promote a new @scope registry — even if they do not say "launch-shadcn-registry" explicitly.

references/shadcn-ui-official.md

View on GitHub
# Official shadcn-ui/ui Directory

**Repo:** https://github.com/shadcn-ui/ui  
**File:** `apps/v4/registry/directory.json`  
**Example PR:** https://github.com/shadcn-ui/ui/pull/10896

## Entry format

Append a new object at the **end** of the JSON array:

```json
{
  "name": "@scope",
  "homepage": "https://example.com",
  "url": "https://example.com/r/{name}.json",
  "description": "One sentence describing what the registry provides.",
  "logo": "<svg>...</svg>"
}
```

### Field rules

| Field | Required | Notes |
|-------|----------|-------|
| `name` | Yes | Scoped name with `@` prefix, e.g. `@ogimagecn` |
| `homepage` | Yes | Public docs or marketing site |
| `url` | Yes | Component JSON pattern; must use `{name}` placeholder |
| `description` | Yes | Single sentence, ≤ ~160 characters |
| `logo` | Recommended | Inline SVG string; see existing entries for style |

Do not reorder or edit existing entries. Append only.

## PR details

**Branch:** `feat/<scope-without-at>-directory`  
**Title:** `feat(registry): add @scope`  
**Commit:** `feat(registry): add @scope`

**Body template:**

```markdown
## Summary

Adds `@scope` to the community registry directory.

- **Registry URL**: `https://example.com/r/{name}.json`
- **Homepage**: https://example.com
- **Description**: <description>

## Test plan

- [ ] `curl https://example.com/r/registry.json` returns valid JSON
- [ ] `npx shadcn@latest add @scope/<sample-component>` installs successfully
```

## Review expectations

- Maintainer approval required (typically @shadcn)
- PR is small — one JSON object
- Vercel deploy preview may require team authorization on first contribution
- Response time varies; follow up politely after 3–5 business days

## Mapping from registry profile

```
name        ← profile.scope
homepage    ← profile.homepage
url         ← profile.componentUrlPattern
description ← profile.description
logo        ← profile.logo (if present)
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall