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/preflight.md
View on GitHub# Preflight Validation
Run these checks before generating directory PRs or social drafts.
## Registry requirements
The registry must be publicly accessible with no authentication:
| Endpoint | Required | Example |
|----------|----------|---------|
| Registry index | `{registryBaseUrl}/registry.json` | `https://ogimagecn.vercel.app/r/registry.json` |
| Component files | `{componentUrlPattern}` with real component name | `https://ogimagecn.vercel.app/r/og-image.json` |
Custom `registry_url` paths are allowed (e.g. registry.directory entries can set `registry_url` explicitly) but the index must resolve without auth.
## Automated validation
```bash
bash scripts/validate-registry.sh <registryBaseUrl> [component-name]
```
The script checks:
1. `registry.json` returns HTTP 200 and valid JSON
2. Registry index contains at least one item (or documents components)
3. Optional sample component JSON returns 200
4. Response is not HTML error page
## Manual checks
### CLI install smoke test
```bash
npx shadcn@latest add <full-url-or-scope/component> --dry-run
```
Or install into a throwaway test project if the user has one.
### Duplicate detection
Search the official directory for the scope name:
```bash
curl -fsSL https://raw.githubusercontent.com/shadcn-ui/ui/main/apps/v4/registry/directory.json \
| python3 -c "import json,sys; d=json.load(sys.stdin); print([x['name'] for x in d if '@yourscope' in x.get('name','').lower()])"
```
Also search community lists if the registry was previously submitted under a different name.
### Description quality
Official directory descriptions should be:
- One sentence, factual
- No "best", "#1", "revolutionary", or heavy marketing language
- Explain what components the registry provides
### Logo (official directory)
If including `logo` in the official entry:
- Inline SVG only (as used in `apps/v4/registry/directory.json`)
- Reasonable size (< 8KB)
- Works in light and dark contexts if possible
### GitHub metadata
For registry.directory, prefer including:
- `github_url` — source or registry repo
- `github_profile` — `https://github.com/{username}.png`
## Blockers (do not proceed)
- `registry.json` missing or returns non-JSON
- All sampled component URLs 404
- Duplicate `@scope` already in official directory
- Site homepage down
- Registry requires auth headers or cookies
## Warnings (proceed with user acknowledgment)
- No `logo` for official entry (still submittable)
- Only one component in registry (fine for niche registries)
- Premium distribution on shadcntemplates (review process, fees for multiple premium listings)
- Official PR may take days for maintainer review
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 |