shadcn-labs/termcn / .agents/skills/launch-shadcn-registry
launch-shadcn-registry
VerifiedLaunch 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.5 KB |
| evals/evals.json | config | 1.7 KB |
| references/awesome-birobirobiro.md | markdown | 1.6 KB |
| references/awesome-bytefer.md | markdown | 1.3 KB |
| references/preflight.md | markdown | 2.6 KB |
| references/registry-directory.md | markdown | 1.9 KB |
| references/shadcn-ui-official.md | markdown | 1.9 KB |
| references/shadcntemplates.md | markdown | 2.0 KB |
| references/social/devto.md | markdown | 1.7 KB |
| references/social/hackernews.md | markdown | 1.6 KB |
| references/social/reddit.md | markdown | 1.1 KB |
| references/social/x.md | markdown | 1.1 KB |
| scripts/validate-registry.shexecutable | script | 3.3 KB |
| templates/registry-profile.example.json | config | 1.1 KB |
| templates/registry-profile.schema.json | config | 2.4 KB |
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)
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |