Community연구 & 데이터 분석github.com

iamk3nnyt/claude-skills

기능 아이디어를 문제, 대상, MVP 범위, 비목표, 번호가 매겨진 Given/When/Then 수용 기준, 관련 경로, 데이터 및 이메일, 미해결 질문을 포함한 한 페이지 분량의 스펙으로 변환합니다. 사용자가 'brief', 'spec this', 'scope this' 또는 'what would it take'라고 말하거나, 범위가 불분명한 기능을 시작하기 전에 사용하세요.

claude-skills란 무엇인가요?

이 스킬은 기능 아이디어를 구조화된 한 페이지 분량의 스펙으로 신속하게 변환하는 전문 도구입니다. 주로 Claude Code와 같은 AI 에이전트 환경에서 사용되며, 문제 정의, 대상 사용자, MVP 범위, 명시적 비목표, 테스트 가능한 Given/When/Then 형식의 수용 기준, 관련된 경로·테이블·이메일·환경 변수 목록, 리스크 식별, 그리고 기본값이 포함된 미해결 질문 등을 생성합니다. 사용자는 기존 코드베이스와 메모리를 자동으로 분석하며, 범위를 변경할 결정이 있을 때만 대화형 질문을 최대 3개까지 제한적으로 수행합니다. 'brief', 'spec this' 등의 명령어로 활성화되며, 결과를 채팅으로 출력하거나 요청 시 `docs/briefs/<slug>.md` 파일로 저장할 수 있습니다. 이 스킬은 MVP가 기존 필드와 컴포넌트만 사용하고, 요청되지 않은 기능을 비목표로 분류하며, 각 수용 기준이 실제 테스트나 플로우 체크에 매핑되도록 보장함으로써 기능의 초기 협의와 개발 준비를 획기적으로 간소화합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamk3nnyt/claude-skills/tree/HEAD/skills/brief

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

문서

brief

기능: $ARGUMENTS

먼저 조용히 맥락 파악하기

  • 저장소의 CLAUDE.md와 해당 프로젝트의 메모리 항목을 읽습니다. 기능이 건드리는 경로, 스키마, 이메일 템플릿을 훑어봅니다. 스펙은 실제 파일 경로와 기존 필드를 인용합니다.
  • 오직 결정이 범위를 변경할 경우에만 인터뷰합니다. AskUserQuestion을 사용하여 권장 옵션과 함께 한 번에 하나의 질문을 하고, 최대 3개로 제한합니다. 그 외의 모든 것은 미해결 질문의 가정이 됩니다.

범위 설정 규칙

  • MVP는 기존 필드와 컴포넌트로 구축된 일반적인 최소 기능입니다. "여느 이커머스처럼"은 플랫폼이 아닌 표준 흐름을 의미합니다.
  • 요청되지 않은 컴포넌트, 설정, 관리자 화면, 분석을 절대 추가하지 마세요. 대신 비목표 아래에 나열하세요.
  • 파트너 또는 API 기능: "API 키"는 일반적으로 개발자 포털이 아닌 env의 테넌트 ID를 의미합니다.
  • CLAUDE.md/메모리의 프로젝트 제약 조건(예: "스키마 변경 금지")을 존중합니다. 이를 위반할 사항이 있으면 표시합니다.

템플릿

# <기능>: brief
**문제:** 한두 문장으로, 사용자의 고통, 해결책이 아닌 것.
**대상:** 누구를 위한 것인지, 가능하면 숫자까지 (쿼리나 출처를 인용).
**MVP:** 3–6개의 항목, 각각 출시 가능하고 관찰 가능해야 함.
**비목표:** 현재 명시적으로 하지 않을 것.
**수용 기준**
1. Given <상태>, When <행동>, Then <관찰 가능한 결과>.
2. … (각각 플로우 체크, 스모크 테스트 또는 단위 테스트로 테스트 가능)
**관련 항목:** 경로 · 테이블/필드(기존 우선) · 이메일 · env/비밀 · 서드파티
**리스크:** 비용, 법률/GDPR, 전달 가능성, SEO (noindex/canonical), i18n
**미해결 질문:** 번호 매기기; 각각 답변이 없을 경우 제 기본값 포함

출력

  • 기본적으로 채팅에 출력합니다. 요청이 있을 때만 docs/briefs/<slug>.md 파일을 작성합니다.
  • 한 문장으로 시작 ("아래 brief: N개 기준, M개 미해결 질문"), 그다음 brief. 이후는 없음.

종료 조건

  • 모든 수용 기준이 관찰 가능하며 검사(플로우 체크 단계, 스모크 기대값 또는 테스트)에 매핑됩니다.
  • MVP에 요청되지 않았거나 요청된 사항에 엄격히 필요하지 않은 것이 없습니다.
  • 각 미해결 질문에 기본값이 있어 기다리지 않고 개발을 시작할 수 있습니다.

Individual skills in this repo

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

iamk3nnyt/claude-skills

Checks UI copy across locales by comparing key parity between next-intl message catalogs and in-code sv/en COPY objects, finding placeholder and array mismatches and words from the other language leaking in (the "och" in English bug), then manually reviewing claims against terms and pricing and the project's banned phrases. Use after editing copy or translations, before shipping a page with new text, or when asked to proofread or check translations.

iamk3nnyt/claude-skills

Applies an agreed visual direction to a page or component by reusing existing components first, then verifies every width and dark mode with the headless-Chrome audit plus a before/after pixel diff, and reviews against Refactoring UI, Nielsen and WCAG 2.2. Use when asked to redesign, restyle, polish or "make it look like the reference", after design-ref or when the direction is already clear.

iamk3nnyt/claude-skills

Extracts the visual system from a reference site or pasted HTML (colour roles, type scale, spacing scale, radii, shadows, button/card/eyebrow anatomy, tone) and maps it onto the current project's existing tokens as a short token table. Use when the user shares a reference ("make it look like <site>", "in this style", a URL or HTML paste) before a redesign.

iamk3nnyt/claude-skills

QAs a project's transactional and digest emails by rendering every template without DB or network, screenshotting at 600 and 375 px in light, dark and images-off, and checking for placeholder leaks (undefined, NaN, {{…}}), preheader, unsubscribe, alt text, absolute links, Outlook-safe buttons, viewport meta and Gmail's 102 KB clip. Use when email templates change, before sending a campaign, or when asked to check how emails look.

관련 스킬