Communitygithub.com

ComeOnOliver/skillshub

DTO와 Taint 검사를 활용한 안전하고 재사용 가능한 데이터 접근 패턴입니다. Next.js에서 데이터 접근 계층(DAL)을 DTO와 서버 측 Taint 검사와 함께 구축할 때 사용하세요.

skillshub란 무엇인가요?

이 스킬은 Next.js 애플리케이션에서 데이터 접근 계층(DAL)을 구축하기 위한 포괄적인 가이드라인을 제공합니다. 보안, 권한 부여, 캐싱 및 오류 처리를 중앙 집중화하여 일관된 데이터 접근 패턴을 보장합니다. 주요 기능으로는 `import 'server-only'`를 사용한 서버 전용 로직 보호, 민감한 필드 누출을 방지하기 위한 DTO 변환, 실수로 민감한 데이터가 클라이언트 컴포넌트에 도달하는 것을 차단하기 위한 `experimental_taint` API 활용, 모든 DAL 함수 내에서의 권한 부여 검사 공동 배치, React의 `cache()`를 사용한 요청 중복 제거, 그리고 `NotFoundError`, `UnauthorizedError`와 같은 표준화된 오류 처리가 포함됩니다. 이 스킬은 `**/lib/data.ts`, `**/services/*.ts`, `**/dal/**` 파일 패턴과 'DAL', 'Data Access Layer', 'server-only', 'DTO' 등의 키워드로 트리거됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/HoangNguyen0403/agent-skills-standard/nextjs-data-access-layer

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

데이터 접근 계층 (DAL)

우선순위: P1 (높음)

일관된 보안, 권한 부여, 캐싱을 보장하기 위해 모든 데이터 접근(데이터베이스 및 외부 API)을 중앙 집중화합니다.

구현 가이드라인

  • 아키텍처: services/ 또는 lib/data.ts 파일에 **데이터 접근 계층(DAL)**을 생성합니다. **import 'server-only'**를 사용하여 백엔드 로직이 클라이언트 번들로 누출되는 것을 방지합니다.
  • DTO: 원시 DB/API 데이터를 컴포넌트에 반환하기 전에 항상 **데이터 전송 객체 (DTO)**로 변환합니다. 이는 passwordHash와 같은 민감한 필드의 누출을 방지합니다.
  • 보안: experimental_taint API의 taintObjectReference 또는 **taintUniqueValue**를 사용하여 민감한 데이터가 실수로 클라이언트 컴포넌트에 도달하지 않도록 합니다.
  • 권한 부여: 모든 DAL 함수 내에 권한 부여 검사를 공동 배치합니다. UI 계층이 안전을 강제하도록 의존하지 마십시오. **await auth()**를 사용하여 사용자를 확인합니다.
  • 캐싱: React의 **cache()**로 DAL 함수를 감싸서 단일 렌더링 주기 내에서 요청을 중복 제거하고, 중복된 DB/API 호출을 방지합니다.
  • 오류 처리: Next.js error.tsx 또는 **notFound()**에서 포착할 수 있도록 표준화된 오류(예: NotFoundError, UnauthorizedError)를 발생시킵니다.

제한 사항

  • 클라이언트 컴포넌트: DAL 파일을 가져올 수 없습니다. 서버 액션 또는 라우트 핸들러를 브리지로 사용해야 합니다.

안티 패턴

  • DAL 외부에서의 권한 부여 검사 없음: 권한 부여 검증은 DAL 함수 내에 있어야 합니다.
  • 원시 ORM 인스턴스를 반환하지 않음: 반환하기 전에 일반 DTO 객체로 변환합니다.
  • 서버 컴포넌트에서 fetch('localhost/api') 사용 금지: DAL 함수를 직접 호출합니다.
  • 클라이언트 컴포넌트에서 DAL 가져오기 금지: 서버 액션이나 라우트 핸들러를 브리지로 사용합니다.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬