본문으로 건너뛰기
cccskills
무료GitHub에 공개

add-preview-route

Add a new component showcase, block, or template preview page and register it everywhere it must appear (navigation, command palette, route lists, SEO, source view). Use when adding anything under /components, /blocks, or /templates.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mattycraig/nuxt-theme-builder
설치 방법 보기

포함된 파일(1)

  • SKILL.md2.8 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Add a preview route: $ARGUMENTS

Preview pages render inside the editor's iframe (?preview, preview layout) and must respond to the theme being edited. Use Nuxt UI components and semantic tokens (bg-(--ui-bg-elevated), text-(--ui-text-muted), color="primary"), never raw palette classes like bg-blue-500.

1. Create the content

Component showcase (/components/<slug>, data-driven via app/pages/components/[slug].vue):

  • Create app/components/showcase/components/<PascalSlug>.vue. It's resolved by import.meta.glob from the kebab-case slug. Reuse ShowcaseSpecimen / ShowcaseSpecimenGrid like the existing showcases.
  • Register it in COMPONENT_CATEGORIES in app/utils/navigation/components.ts (label, icon, description, to: "/components/<slug>").

Block (/blocks/<slug>, data-driven via app/pages/blocks/[slug].vue):

  • Variants live in app/components/blocks/components/<Name>.vue. Each block page is app/components/blocks/content/<PascalSlug>.vue, fed by app/data/blocks/<slug>.ts, which imports every variant and its ?raw source (shown in the block's code view) plus an AI prompt.
  • Register it in BLOCK_CATEGORIES in app/utils/navigation/blocks.ts.

Template (/templates/<slug>):

  • Create app/pages/templates/<slug>.vue as a full, self-contained page (users copy this file from the source view, so keep it clean and idiomatic). Don't use definePageMeta({ layout }); app.vue picks layouts.
  • Register it in TEMPLATE_CATEGORIES in app/utils/navigation/templates.ts.
  • Source view picks it up automatically via modules/source-code-embed.ts. Restart pnpm dev to refresh the embedded map.

2. Register the route

  • shared/constants/routes.ts: add the path to COMPONENT_ROUTES / BLOCK_ROUTES / TEMPLATE_ROUTES. These drive the sitemap, prerendering, and noindex. tests/unit/shared/routes.test.ts fails if nav and route lists disagree.
  • app/utils/seoDescriptions.ts: add a PAGE_DESCRIPTIONS entry (and PAGE_TITLES if the generic "<Label> Component/Block/Template" title isn't right).
  • The command palette and breadcrumbs read the navigation modules, so no extra work is needed there.

3. Verify

  • pnpm vitest run tests/unit/shared/routes.test.ts tests/unit/utils/navigation.test.ts tests/unit/utils/seoDescriptions.test.ts
  • /run-app: open the route in the editor, change the primary color and radius and confirm the preview reacts, toggle dark mode, use the command palette to find it, and for templates check the source view.
  • /dev-workflow.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

add-ai-model

무료

Add, update, or retire an AI provider model option for the BYOK theme generator (OpenAI, Anthropic, Google) and verify the provider requests native structured output for it. Use when model lists go stale or a new provider/model is requested.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mattycraig/nuxt-theme-builder92026년 10월 19일 업데이트

add-design-tool

무료

Add a new interactive design tool under /tools (like the color converter or contrast checker) — component, page, navigation, route lists, SEO, and tests. Use when building a new utility tool.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mattycraig/nuxt-theme-builder92026년 10월 19일 업데이트

add-learn-article

무료

Write and register a new Learning Hub article (Nuxt Content markdown under content/learn) with valid frontmatter, navigation entry, route list entry, and accurate product details. Use when adding or substantially rewriting a learn guide, reference, or tip.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mattycraig/nuxt-theme-builder92026년 10월 19일 업데이트

add-theme-property

무료

Checklist for adding or changing a field on ThemeConfig (a new design token, per-mode setting, or export option) end to end — schema, defaults, store + history, CSS apply, export, editor UI, AI, and tests. Use whenever ThemeConfig's shape changes.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mattycraig/nuxt-theme-builder92026년 10월 19일 업데이트

dev-workflow

무료

Run the project's validation pipeline (lint → format → typecheck → unit tests) with auto-fixes, then optionally stage and write a Conventional Commit. Use before committing, when asked to "check", "validate", "run the workflow", or "get this commit-ready".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mattycraig/nuxt-theme-builder92026년 10월 19일 업데이트

docs-sync

무료

Audit the project's documentation (CLAUDE.md, .claude/rules, skills, README, CONTRIBUTING, SECURITY, .env.example, app/data/*.md, learn articles) against the actual code and config, and fix drift. Use after refactors, dependency or workflow changes, or on a schedule.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

mattycraig/nuxt-theme-builder92026년 10월 19일 업데이트

mattycraig의 스킬 모두 보기

이 스킬의 문제 신고