[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B01Y9CN1F0QDAHDERT8ACM":3,"skill-same:01M7B01Y9CN1F0QDAHDERT8ACM":73},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":40,"commitSha":41,"skillDirectory":42,"forksCount":14,"repositoryHtmlUrl":43,"repositoryHomepageUrl":6,"ownerHtmlUrl":44,"ownerBlogUrl":6,"ownerDescription":45,"updatedAt":46,"install":47,"resources":60},"01M7B01Y9CN1F0QDAHDERT8ACM","premium-webapp-build",null,"Build premium interactive web apps with Next.js + shadcn.","dbillion\u002Fhermes-skills-public","dbillion","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F49393855?v=4","01M7AVH8QPGCM8WKWS22TRT0T6","Oludayo Adeoye","01M7AVH8RD1JJWA0YS9CFEWAV9",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Ffrontend\u002Fpremium-webapp-build\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: premium-webapp-build\ndescription: Build premium interactive web apps with Next.js + shadcn.\nversion: 1\nauthor: hermes-agent\nlicense: MIT\nmetadata:\n  hermes:\n    tags: [frontend, nextjs, shadcn, tailwind, 21st-dev, open-design, netlify, premium-ui]\n    related_skills: [static-site-premium-ui, design-taste-frontend]\n---\n\n# Premium Webapp Build (Next.js + shadcn + 21st.dev \u002F OpenDesign)\n\n## When to Use (and when NOT)\nUse this skill as the DEFAULT for premium UI work when ANY of these is true:\n- The user says \"something better than plain text\", wants animated cards, media-rich pages, or a real product UI.\n- The user names **Next.js \u002F React \u002F shadcn \u002F Tailwind components \u002F a real app**.\n- The page needs interactivity beyond CSS (client state, modals with dynamic data, visualizers, quizzes, routed pages).\n- The user already has 21st.dev `magic` or OpenDesign wired and wants to USE them.\n\nUse `static-site-premium-ui` ONLY as a fallback when: the deploy must be zero-build static files, OR the user explicitly says \"no framework \u002F just HTML\". Do not reach for static by default for a premium brief — it forfeits shadcn components and real routing, and the user (dbillion) has explicitly rejected static-first for premium work.\n\nLoad order:\n1. `design-taste-frontend` — dials, locks, AI-tells, pre-flight matrix (mandatory; applies unchanged to React).\n2. `static-site-premium-ui` — for the CSS token system and em-dash ban if hand-rolling any CSS.\n3. This skill — framework scaffolding, shadcn, 21st.dev\u002FOpenDesign wiring, Netlify Next deploy.\n\n## Design Read (declare before coding)\n\"Reading this as: a learning hub \u002F product page for the audience, with a premium dark-tech language, leaning toward Next.js App Router + Tailwind v4 + shadcn\u002Fui, a single locked emerald accent, and motivated motion via motion\u002Freact.\"\n\nEnforce the taste-skill locks: ONE accent (we use emerald `#34d399` \u002F `#0f9d6b`), dark+light theme lock via CSS tokens, shape consistency, ZERO em-dashes in all source, reduced-motion support.\n\n## Scaffold a Next.js app (verified path)\n```bash\nexport PATH=\"\u002Fhome\u002Fdeeone\u002F.bun\u002Fbin:$PATH\"\nrm -rf myapp\nnpx --yes create-next-app@latest myapp --ts --tailwind --eslint --app --src-dir --import-alias \"@\u002F*\" --use-npm --no-turbopack\n```\nTailwind v4 + App Router + `src\u002F`. Then install the shadcn primitive stack:\n```bash\nnpm install clsx tailwind-merge class-variance-authority lucide-react \\\n  @radix-ui\u002Freact-slot @radix-ui\u002Freact-dialog @radix-ui\u002Freact-tabs mermaid\n```\n\n### npm install scripts gate (CRITICAL, non-obvious)\nOn this box npm blocks postinstall scripts with `EALLOWSCRIPTS` (\"--allow-scripts is not allowed in project-scoped installs\"). Fix per-project: add to the project's `package.json`:\n```json\n\"allowScripts\": { \"esbuild\": true, \"sharp\": true, \"@tailwindcss\u002Foxide\": true, \"core-js\": true }\n```\n(The `--allow-scripts` CLI flag is REJECTED by the project policy; only the package.json field works.) Then `npm install` succeeds. (unrs-resolver's postinstall stays unapproved with a harmless warning — ignore it.)\n\n## shadcn components (hand-build, standard)\n`@latest shadcn` generator can hang; hand-write the small standard components instead — see `templates\u002Fshadcn-basics.tsx` for `cn`, `Button`, `Card`, `Badge`, `Dialog`, `Tabs`. They are thin wrappers over Radix + cva. Copy into `src\u002Fcomponents\u002Fui\u002F`.\n\n## 21st.dev magic + OpenDesign (the user's stated utilities)\nThe user wants these USED, not replaced. Wiring + calling them:\n- **Wire `magic-21st` into `~\u002F.hermes\u002Fconfig.yaml`** as a SEPARATE mcp_servers entry (never overwrite existing servers). Command `npx -y @21st-dev\u002Fmagic@latest`, env `API_KEY`. CRITICAL: put the key in a SHELL ENV VAR and reference it as `${TWENTY_FIRST_DEV_KEY}` in config — never paste the literal key into config.yaml (consent gate + secret hygiene). See reference `references\u002Fmagic-mcp-cli.md`.\n- **Call it via scoped `mcp-cli`** (never bare): `mcp-cli -c \u002Ftmp\u002Fmagic-scope.json call magic-21st\u002Fsearch '{\"query\":\"...\"}'`. `search` and `get_component` are the free\u002Fquota steps; `generate` (returns a build URL, not inline code) is PAYWALLED on the free tier (`generation_limit_reached`). Spend retrieval quota on real component code (e.g. Hero Animated id 1788) and port the design DNA into the app.\n- **OpenDesign** (`od` MCP, daemon on :7456) has 162 skills (card-xiaohongshu, frontend-slides, etc.) when a full page generation is wanted.\n\n## Media: prefer MP4 over GIF for large archives\nFor 80+ walkthrough assets, GIFs are ~2x the size of the 1080p MP4 source (189MB GIF vs 88MB MP4 in our run). Use `\u003Cvideo autoPlay loop muted playsInline>` with the MP4s in `public\u002Fvideos\u002F`. Copy the source MP4s, not the GIFs.\n\n## Netlify deploy (Next.js runtime) — VERIFIED\n```bash\n# netlify at ~\u002F.bun\u002Fbin\u002Fnetlify, team dbillion, authed as Oludayo\u002Fdayozoe\ncat > netlify.toml \u003C\u003C'TOML'\n[build]\n  command = \"npm run build\"\n  publish = \".next\"\n[dev]\n  command = \"npm run dev\"\n  port = 3000\n[[plugins]]\n  package = \"@netlify\u002Fplugin-nextjs\"\nTOML\nnpm install -D @netlify\u002Fplugin-nextjs\nnetlify deploy --build --prod --create-site --team dbillion\n```\n`--auth` requires a token VALUE (not a flag alone) — omit it when the CLI is already authed. The build uses Turbopack; a transient \"Error while running build\" on first try cleared on re-run. After deploy, VERIFY with `curl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\" \u003Curl>\u002F` and grep for hero copy; also check a `\u002Fvideos\u002F*.mp4` returns 200 video\u002Fmp4.\n\n## Verify before claiming done\n- `npm run build` passes (TS + static generation of all routes).\n- `git push` (88MB videos is fine; 189MB GIFs timed out at 180s — another reason to use MP4).\n- Live HTTP 200 on `\u002F`, a routed page, and a media asset.\n\n## User preference (dbillion \u002F Oludayo Adeoye)\nExpects PREMIUM, MEDIA-RICH, INTERACTIVE UIs, never plain text, for edtech\u002FDSA brand work. Wants real frameworks (Next.js + shadcn) over static HTML. New MCP utilities (21st-dev magic, notebooklm-v2, OpenDesign) are SEPARATE servers, never replacements. Secrets go in env vars, never pasted into config files.\n","# Premium Webapp Build (Next.js + shadcn + 21st.dev \u002F OpenDesign)\n\n## When to Use (and when NOT)\nUse this skill as the DEFAULT for premium UI work when ANY of these is true:\n- The user says \"something better than plain text\", wants animated cards, media-rich pages, or a real product UI.\n- The user names **Next.js \u002F React \u002F shadcn \u002F Tailwind components \u002F a real app**.\n- The page needs interactivity beyond CSS (client state, modals with dynamic data, visualizers, quizzes, routed pages).\n- The user already has 21st.dev `magic` or OpenDesign wired and wants to USE them.\n\nUse `static-site-premium-ui` ONLY as a fallback when: the deploy must be zero-build static files, OR the user explicitly says \"no framework \u002F just HTML\". Do not reach for static by default for a premium brief — it forfeits shadcn components and real routing, and the user (dbillion) has explicitly rejected static-first for premium work.\n\nLoad order:\n1. `design-taste-frontend` — dials, locks, AI-tells, pre-flight matrix (mandatory; applies unchanged to React).\n2. `static-site-premium-ui` — for the CSS token system and em-dash ban if hand-rolling any CSS.\n3. This skill — framework scaffolding, shadcn, 21st.dev\u002FOpenDesign wiring, Netlify Next deploy.\n\n## Design Read (declare before coding)\n\"Reading this as: a learning hub \u002F product page for the audience, with a premium dark-tech language, leaning toward Next.js App Router + Tailwind v4 + shadcn\u002Fui, a single locked emerald accent, and motivated motion via motion\u002Freact.\"\n\nEnforce the taste-skill locks: ONE accent (we use emerald `#34d399` \u002F `#0f9d6b`), dark+light theme lock via CSS tokens, shape consistency, ZERO em-dashes in all source, reduced-motion support.\n\n## Scaffold a Next.js app (verified path)\n```bash\nexport PATH=\"\u002Fhome\u002Fdeeone\u002F.bun\u002Fbin:$PATH\"\nrm -rf myapp\nnpx --yes create-next-app@latest myapp --ts --tailwind --eslint --app --src-dir --import-alias \"@\u002F*\" --use-npm --no-turbopack\n```\nTailwind v4 + App Router + `src\u002F`. Then install the shadcn primitive stack:\n```bash\nnpm install clsx tailwind-merge class-variance-authority lucide-react \\\n  @radix-ui\u002Freact-slot @radix-ui\u002Freact-dialog @radix-ui\u002Freact-tabs mermaid\n```\n\n### npm install scripts gate (CRITICAL, non-obvious)\nOn this box npm blocks postinstall scripts with `EALLOWSCRIPTS` (\"--allow-scripts is not allowed in project-scoped installs\"). Fix per-project: add to the project's `package.json`:\n```json\n\"allowScripts\": { \"esbuild\": true, \"sharp\": true, \"@tailwindcss\u002Foxide\": true, \"core-js\": true }\n```\n(The `--allow-scripts` CLI flag is REJECTED by the project policy; only the package.json field works.) Then `npm install` succeeds. (unrs-resolver's postinstall stays unapproved with a harmless warning — ignore it.)\n\n## shadcn components (hand-build, standard)\n`@latest shadcn` generator can hang; hand-write the small standard components instead — see `templates\u002Fshadcn-basics.tsx` for `cn`, `Button`, `Card`, `Badge`, `Dialog`, `Tabs`. They are thin wrappers over Radix + cva. Copy into `src\u002Fcomponents\u002Fui\u002F`.\n\n## 21st.dev magic + OpenDesign (the user's stated utilities)\nThe user wants these USED, not replaced. Wiring + calling them:\n- **Wire `magic-21st` into `~\u002F.hermes\u002Fconfig.yaml`** as a SEPARATE mcp_servers entry (never overwrite existing servers). Command `npx -y @21st-dev\u002Fmagic@latest`, env `API_KEY`. CRITICAL: put the key in a SHELL ENV VAR and reference it as `${TWENTY_FIRST_DEV_KEY}` in config — never paste the literal key into config.yaml (consent gate + secret hygiene). See reference `references\u002Fmagic-mcp-cli.md`.\n- **Call it via scoped `mcp-cli`** (never bare): `mcp-cli -c \u002Ftmp\u002Fmagic-scope.json call magic-21st\u002Fsearch '{\"query\":\"...\"}'`. `search` and `get_component` are the free\u002Fquota steps; `generate` (returns a build URL, not inline code) is PAYWALLED on the free tier (`generation_limit_reached`). Spend retrieval quota on real component code (e.g. Hero Animated id 1788) and port the design DNA into the app.\n- **OpenDesign** (`od` MCP, daemon on :7456) has 162 skills (card-xiaohongshu, frontend-slides, etc.) when a full page generation is wanted.\n\n## Media: prefer MP4 over GIF for large archives\nFor 80+ walkthrough assets, GIFs are ~2x the size of the 1080p MP4 source (189MB GIF vs 88MB MP4 in our run). Use `\u003Cvideo autoPlay loop muted playsInline>` with the MP4s in `public\u002Fvideos\u002F`. Copy the source MP4s, not the GIFs.\n\n## Netlify deploy (Next.js runtime) — VERIFIED\n```bash\n# netlify at ~\u002F.bun\u002Fbin\u002Fnetlify, team dbillion, authed as Oludayo\u002Fdayozoe\ncat > netlify.toml \u003C\u003C'TOML'\n[build]\n  command = \"npm run build\"\n  publish = \".next\"\n[dev]\n  command = \"npm run dev\"\n  port = 3000\n[[plugins]]\n  package = \"@netlify\u002Fplugin-nextjs\"\nTOML\nnpm install -D @netlify\u002Fplugin-nextjs\nnetlify deploy --build --prod --create-site --team dbillion\n```\n`--auth` requires a token VALUE (not a flag alone) — omit it when the CLI is already authed. The build uses Turbopack; a transient \"Error while running build\" on first try cleared on re-run. After deploy, VERIFY with `curl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\" \u003Curl>\u002F` and grep for hero copy; also check a `\u002Fvideos\u002F*.mp4` returns 200 video\u002Fmp4.\n\n## Verify before claiming done\n- `npm run build` passes (TS + static generation of all routes).\n- `git push` (88MB videos is fine; 189MB GIFs timed out at 180s — another reason to use MP4).\n- Live HTTP 200 on `\u002F`, a routed page, and a media asset.\n\n## User preference (dbillion \u002F Oludayo Adeoye)\nExpects PREMIUM, MEDIA-RICH, INTERACTIVE UIs, never plain text, for edtech\u002FDSA brand work. Wants real frameworks (Next.js + shadcn) over static HTML. New MCP utilities (21st-dev magic, notebooklm-v2, OpenDesign) are SEPARATE servers, never replacements. Secrets go in env vars, never pasted into config files.\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"description":7},"hermes-agent",1,{"hermes":27},{"tags":28,"related_skills":37},[29,30,31,32,33,34,35,36],"frontend","nextjs","shadcn","tailwind","21st-dev","open-design","netlify","premium-ui",[38,39],"static-site-premium-ui","design-taste-frontend","master","f341c46fed021656175d5c9ccc67a72126e50bfb","skills\u002Ffrontend\u002Fpremium-webapp-build","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public","https:\u002F\u002Fgithub.com\u002Fdbillion","I enjoy writing codes,teaching programming, solving problems, tasted automation in Python and never looked back😋😋😋💞","2026-10-14 03:31:55",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add dbillion\u002Fhermes-skills-public --skill premium-webapp-build",{"tool":53,"command":54},"bunx","bunx skills add dbillion\u002Fhermes-skills-public --skill premium-webapp-build",{"tool":56,"command":57},"pnpm","pnpm dlx skills add dbillion\u002Fhermes-skills-public --skill premium-webapp-build","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Ffrontend\u002Fpremium-webapp-build\u002FSKILL.md",true,[61,67],{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fmagic-mcp-cli.md","REFERENCE","参考文档",2549,"https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Ffrontend\u002Fpremium-webapp-build\u002Freferences\u002Fmagic-mcp-cli.md",{"path":68,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":71,"sourceHtmlUrl":72},"templates\u002Fshadcn-basics.tsx","OTHER","其他",5995,"https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Ffrontend\u002Fpremium-webapp-build\u002Ftemplates\u002Fshadcn-basics.tsx",[74,81,88,97,104,111],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7B25T0V7RBKES86Y3RTXQRN","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7B25DSBBMZRHVD28MAX7N5X","gemini-vision-fallback","Vision fallback: Gemini REST API if vision_analyze blocked.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fvision\u002Fgemini-vision-fallback\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":92,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7B22XW9QXT2ZWWXVZDFWYZP","twitter-cli","Use twitter-cli for ALL Twitter\u002FX operations — reading tweets, posting, replying, quoting, liking, retweeting, following, searching, user lookups. Invoke whenever user requests any Twitter interaction.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Ftwitter-cli\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Ftwitter-cli\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M7B22QMWY1B4F7BC114RG4S6","prism-scan","Structural analysis through dynamically generated cognitive lenses. Generates the optimal analytical lens for the specific code\u002Fartifact, then executes it. Finds conservation laws, structural invariants, and concrete bugs that vanilla analysis misses. Use on any code file, system design, or text artifact.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fts-superhermes-prism-scan\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":19},"01M7B22JA5XCAP1ACT6V50WYR1","prism-reflect","Constraint transparency: analyzes an artifact structurally, then analyzes what its own analysis concealed. Produces a conservation law AND a constraint report showing what was maximized, what was sacrificed, and what to investigate next. The only AI skill that knows what it can't see.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fts-superhermes-prism-reflect\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":19},"01M7B22EB15M75M4X3C52YGDCC","prism-full","Full Prism: multi-pass structural analysis with mandatory adversarial self-correction. Designs custom analytical passes, executes them with chaining, then attacks its own findings before synthesizing. Use for maximum depth on important code or artifacts.","https:\u002F\u002Fgithub.com\u002Fdbillion\u002Fhermes-skills-public\u002Fblob\u002Fmaster\u002Fskills\u002Fts-superhermes-prism-full\u002FSKILL.md",[],[]]