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/registry-directory.md

View on GitHub
# registry.directory

**Repo:** https://github.com/rbadillap/registry.directory  
**File:** `apps/web/public/directory.json`  
**Site:** https://registry.directory

## Entry format

Append to the `registries` array inside the root object:

```json
{
  "name": "Display Name",
  "description": "One or two sentences about the registry.",
  "url": "https://example.com/",
  "registry_url": "https://example.com/r/registry.json",
  "github_url": "https://github.com/org/repo",
  "github_profile": "https://github.com/username.png"
}
```

### Field rules

| Field | Required | Notes |
|-------|----------|-------|
| `name` | Yes | Human-readable; can differ from `@scope` |
| `description` | Yes | Clear, factual |
| `url` | Yes | Homepage (trailing slash optional) |
| `registry_url` | Yes* | Full path to `registry.json`; required if not default `/r/registry.json` |
| `github_url` | Recommended | Repo link for card avatar |
| `github_profile` | Recommended | `https://github.com/{username}.png` |

\*Always include `registry_url` explicitly to avoid ambiguity.

## PR details

**Branch:** `feat/add-<slug>-registry`  
**Title:** `feat: add <name> registry`  
**Commit:** `feat: add <name> registry`

**Body template:**

```markdown
## Summary

Adds <name> to the registry directory.

- Homepage: <homepage>
- Registry: <registry_url>
- GitHub: <githubUrl>

## Checklist

- [ ] `registry.json` is publicly accessible
- [ ] Component JSON files resolve at documented paths
- [ ] Registry works with shadcn CLI
```

## Mapping from registry profile

```
name           ← profile.name
description    ← profile.description or profile.descriptionLong (trim to ~200 chars)
url            ← profile.homepage
registry_url   ← profile.registryBaseUrl + "/registry.json" (adjust if custom path)
github_url     ← profile.githubUrl
github_profile ← https://github.com/{profile.githubUsername}.png
```
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