designpaca/research/skills/04-sources.md
Yun Chan 8808c672dc designpaca 초기 구현 — 스킬 · 설치 CLI · 배포 파이프라인
웹 디자인 파이프라인 스킬과 이를 5개 에이전트에 설치하는 CLI 를 담은 모노레포.

스킬 (packages/skill)
- SKILL.md 261줄 + 참조 문서 16개 3,349줄. progressive disclosure 로
  본문은 절차와 인덱스만, 지식은 references/ 로 분리
- 0~6단계 파이프라인. 규모에 따라 전체·연장·국소 세 경로로 분기
- 하드 게이트 12개는 grep·카운트로 검증 가능한 것만. 취향 판단은 제외
- 미학 프리셋 5종, AI 슬롭 지문 목록, 한글 조판 규칙,
  SVG 필터·three.js·인터랙티브 모션·HTML-in-Canvas 실전 지침

설치 CLI (packages/cli, packages/core)
- npx designpaca 온보딩 TUI. Claude Code · Codex · Cursor · Windsurf · AGENTS.md
- 매니페스트에 설치 시점 해시를 기록해 사용자가 고친 파일은 update 가 건너뛴다
- 타깃별로 본문의 references/ 경로를 실제 설치 위치로 재작성
- AGENTS.md 는 항상 로드되므로 본문 대신 303자 포인터만 주입
- Windsurf 는 12,000자 상한 초과 시 설치를 차단

배포 (build/ci, .forgejo/workflows)
- 태그 v* → 검사·테스트·빌드 → npmjs 배포 + Forgejo 레지스트리 미러
  → draft 릴리스 → Cloudflare Pages. 재실행 멱등

근거 (research/)
- 약 250개 웹 소스 조사 결과와 도그푸딩 검증 2건. 스킬의 모든 수치는 여기서 나온다

테스트 22개 통과 (core 16 · cli 6)
2026-08-20 10:48:00 +09:00

21 KiB
Raw Blame History

04. 조사 소스 목록

작성일: 2026-08-20

표기 규칙

  • [직접] = WebFetch로 본문을 직접 가져와 읽음. 인용문은 이 소스에서만 가져왔다.
  • [검색] = WebSearch 결과 목록에서 확인. 제목과 요약만 봤고 본문은 읽지 않았다.
  • [로컬] = 파일시스템에서 직접 읽음.
  • [스킬] = Skill 도구로 로드해 본문을 직접 읽음.

A. 공식 스펙 문서 (1~12)

# URL 상태 설명
1 https://agentskills.io/specification [직접] Agent Skills 오픈 표준 완전 스펙. 프론트매터 6필드, name 정규식, description 1024자 상한, progressive disclosure 3계층, 파일 참조 1단계 규칙
2 https://agentskills.io/ [직접] 표준 개요와 지원 클라이언트 40개 이상 목록(Cursor, Codex, Gemini CLI, Copilot, Roo, Goose, Amp 등)
3 https://code.claude.com/docs/en/skills [직접] Claude Code 스킬 문서 전문. 프론트매터 22개 필드 표, 설치 위치·우선순위, 심링크, 컨텍스트 수명(5,000토큰 재부착), 스킬 목록 예산(컨텍스트 1%), 트러블슈팅
4 https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices [직접] Anthropic 스킬 작성 베스트 프랙티스 전문. 3인칭 description 경고, degrees of freedom, progressive disclosure 패턴 3종, 워크플로/피드백 루프, 안티패턴, 최종 체크리스트
5 https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview [검색] 스킬 개념 개요와 아키텍처
6 https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills [검색] Anthropic 엔지니어링 블로그. progressive disclosure를 핵심 설계 원칙으로 소개
7 https://cursor.com/docs/rules [직접] Cursor .mdc 규칙 공식 스펙. 프론트매터 3필드(alwaysApply/description/globs), 4가지 규칙 타입, 500줄 상한, Tab/Inline Edit 미적용
8 https://cursor.com/docs/context/skills [직접] Cursor Agent Skills 지원. .agents/skills·.cursor/skills 4경로, 프론트매터(name/description 필수 + paths/icon/color/metadata)
9 https://agents.md/ [직접] AGENTS.md 오픈 표준. 프론트매터 없음, 중첩 시 가까운 파일 우선, 권장 섹션, 6만+ 프로젝트 채택
10 https://learn.chatgpt.com/docs/build-skills [직접] Codex/ChatGPT 스킬 문서. 스캔 경로 4계층(.agents/skills, $HOME/.agents/skills, /etc/codex/skills, 시스템), 목록 예산 2%/8000자
11 https://code.visualstudio.com/docs/copilot/customization/agent-skills [직접] VS Code/Copilot 스킬 지원. .github/skills·.claude/skills·.agents/skills 경로, custom instructions와의 차이
12 https://docs.devin.ai/desktop/cascade/memories [직접] Windsurf/Cascade 규칙 스펙(docs.windsurf.com에서 307 리다이렉트). 6,000자/12,000자 상한, trigger: 4모드(always_on/model_decision/glob/manual)

B. 리다이렉트 원본·부속 (13~16)

# URL 상태 설명
13 https://docs.windsurf.com/windsurf/cascade/memories [직접] 307 리다이렉트 확인. Windsurf 문서가 Devin 문서로 통합됨
14 https://developers.openai.com/codex/skills [직접] 308 리다이렉트 확인 → learn.chatgpt.com/docs/build-skills
15 https://code.claude.com/docs/en/llms.txt [검색] Claude Code 문서 인덱스
16 https://github.com/agentskills/agentskills [검색] Agent Skills 표준 저장소. skills-ref validate CLI 포함

C. Anthropic 공식 스킬 (17~24)

# URL / 경로 상태 설명
17 ~/.claude/plugins/marketplaces/anthropic-agent-skills/skills/frontend-design/SKILL.md [로컬] 공식 frontend-design 스킬. 약 40줄 산문. "AI 3대 기본값" 명명, "Spend your boldness in one place", 2패스 프로세스, 카피 지침
18 ~/.claude/plugins/marketplaces/anthropic-agent-skills/skills/skill-creator/SKILL.md [로컬] 공식 skill-creator 486줄. description 최적화 루프, eval 워크플로, "explain the why in lieu of musty MUSTs"
19 (빌트인) artifact-design [스킬] Artifact 디자인 가이드. 트리트먼트 보정, 다크모드 3상태, 우선순위 체인, <title> 명명 규칙
20 (빌트인) dataviz + .../bundled-skills/.../dataviz/references/* [스킬]+[로컬] 차트 스킬. 절차 7단계, 색상은 마지막, 검증 스크립트 번들, references 7개 분리 구조
21 https://github.com/anthropics/skills [검색] Anthropic 공식 스킬 저장소
22 https://github.com/anthropics/skills/tree/main/skills/skill-creator [검색] skill-creator 소스
23 https://claude.com/blog/skills-explained [검색] Anthropic 스킬 아키텍처·베스트 프랙티스 가이드 블로그
24 https://anthropic.skilljar.com/introduction-to-agent-skills [검색] Anthropic 공식 Agent Skills 입문 코스

D. Hallmark (anti-slop 디자인 스킬, 가장 참고 가치 높음) (25~30)

# URL 상태 설명
25 https://github.com/Nutlope/hallmark [직접] Together AI의 anti-AI-slop 디자인 스킬. 4개 verb, 21개 테마, 58 게이트. 파일 구조와 설치 경로(Claude Code/Cursor/Codex) 확인
26 https://raw.githubusercontent.com/nikolanaidenko-eng/antislop/main/skills/hallmark/SKILL.md [직접] Hallmark SKILL.md 전문(포크 미러). Six Universal Disciplines, 인덱스-후-선택 로딩 규율, .hallmark/log.json 프로젝트 메모리, CSS 스탬프
27 https://raw.githubusercontent.com/nikolanaidenko-eng/antislop/main/skills/hallmark/references/slop-test.md [직접] 58개 슬롭 테스트 게이트 전문 + 6축 사전 자기 채점(Philosophy/Hierarchy/Execution/Specificity/Restraint/Variety)
28 https://raw.githubusercontent.com/nikolanaidenko-eng/antislop/main/skills/hallmark/references/anti-patterns.md [직접] 명명된 AI 텔 카탈로그. Critical/Major/Microinteraction/Minor 4등급, 각 항목이 "무엇/왜 실패하는가/고치는 법" 3단
29 https://github.com/Nutlope/hallmark/blob/main/SKILL.md [검색] 원본 저장소의 SKILL.md 경로(루트가 아닌 skills/hallmark/에 있음)
30 https://github.com/adeoyewole028/hallmark-design-skills [검색] Hallmark 포크

E. Superdesign (design.md 산출 패턴) (31~35)

# URL 상태 설명
31 https://github.com/superdesigndev/superdesign-skill [직접] Claude Code/Cursor/Codex 공용 디자인 스킬. .claude-plugin/.cursor-plugin/.codex-plugin 3중 배포 구조, .superdesign/design-system.md 필수화
32 https://raw.githubusercontent.com/superdesigndev/superdesign-skill/main/DESIGN.md [직접] "design.md는 디자인계의 AGENTS.md" 선언문. 왜 영속적 디자인 시스템 파일이 필요한지 가장 명료한 설명
33 https://raw.githubusercontent.com/superdesigndev/superdesign-skill/main/skills/superdesign/SKILL.md [직접] Superdesign 스킬 본문. 환경 확인 우선, 리포 자동 분석 6파일 생성, .superdesign/resume.json 웜 리줌
34 https://github.com/superdesigndev/superdesign [검색] Superdesign 본체 (IDE 내 디자인 에이전트)
35 https://github.com/jonthebeef/superdesign-mcp-claude-code [검색] Superdesign의 Claude Code MCP 통합

F. 유출 시스템 프롬프트 (36~44)

# URL 상태 설명
36 https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools [직접] 33개 도구의 시스템 프롬프트 모음. 디렉터리 목록 확인(v0, Lovable, Same.dev, Cursor, Devin, Windsurf, Replit, Bolt, Cline, Codex CLI, Gemini CLI, RooCode 등)
37 .../v0 Prompts and Tools/Prompt.txt (raw) [직접] v0 디자인 규칙 원문. "exactly 3-5 colors total", "maximum 2 font families", "NEVER use purple or violet prominently", "Avoid gradients entirely", "NEVER generate abstract shapes like gradient circles, blurry squares, or decorative blobs", 디자인 토큰 강제
38 .../Lovable/Agent Prompt.txt (raw) [직접] Lovable 디자인 규칙 원문. "The design system is everything", "USE SEMANTIC TOKENS FOR COLORS... DO NOT use direct colors like text-white", "NEVER use overrides. Make sure to not hold back on design"
39 .../Same.dev/Prompt.txt (raw) [직접] Same.dev 규칙 원문. "NEVER stay with default shadcn/ui components", "NEVER use emojis", "Avoid using purple, indigo, or blue colors unless specified", 클로닝 윤리 가드레일
40 .../Open Source prompts/Bolt/Prompt.txt (raw) [직접] Bolt 프롬프트. 디자인 전용 섹션이 없음을 확인. 코드 품질·모듈 분할 중심. 디자인 지시는 사실상 부재
41 https://github.com/elder-plinius/CL4R1T4S [검색] 유출 시스템 프롬프트 대형 아카이브 (ChatGPT, Claude, Gemini, Grok, Cursor, Lovable, Replit)
42 https://github.com/YeeKal/leaked-system-prompts [검색] 유출 프롬프트 모음 (v0, Lovable, Cursor, Manus 포함)
43 https://simonwillison.net/2024/Nov/25/leaked-system-prompts-from-vercel-v0/ [검색] Simon Willison의 v0 유출 분석. Vercel CTO Malte Ubl의 "프롬프트만으론 가치 없다" 코멘트
44 https://quasa.io/media/leaked-system-prompts-of-ai-vibe-coding-tools-a-deep-dive-into-cursor-bolt-lovable-and-manus [검색] Cursor/Bolt/Lovable/Manus 프롬프트 비교 분석

G. 커뮤니티 디자인 스킬 목록·큐레이션 (45~54)

# URL 상태 설명
45 https://github.com/travisvn/awesome-claude-skills [직접] Claude Skills 큐레이션. 디자인 관련: frontend-design, web-artifacts-builder, canvas-design, algorithmic-art, frontend-slides, web-asset-generator, shadcn/ui
46 https://novitckii.com/resources/claude-design-skills/ [직접] 42개 디자인 스킬 전수 목록 + GitHub 저장소 URL. impeccable, animate, design-motion-principles, designer-skills, ai-design-skills 시리즈 등
47 https://github.com/Koomook/claude-frontend-skills [직접] distinctive-frontend 스킬. 4축(타이포/컬러·테마/모션/배경) 접근, 극단적 웨이트 대비(100-200 vs 800-900), 문화적 미학 기반 팔레트
48 https://github.com/jiji262/claude-design-skill [직접] Claude.ai 내부 Design 시스템 프롬프트를 스킬로 이식. 6단계 워크플로, Core Asset Protocol, Design Direction Advisor(3방향 제시), 스케일 하한(슬라이드 24px+, 히트타깃 44px+)
49 https://github.com/ComposioHQ/awesome-claude-skills [검색] 또 다른 Claude Skills 큐레이션
50 https://github.com/wilwaldon/Claude-Code-Frontend-Design-Toolkit [검색] Claude Code 프론트엔드 디자인 개선 도구 모음(스킬·플러그인·MCP·CLAUDE.md 트릭)
51 https://pasqualepillitteri.it/en/news/576/claude-code-skills-design-uiux-guide [검색] UI/UX 디자인용 Claude Code 스킬 20선
52 https://www.firecrawl.dev/blog/best-claude-code-skills [검색] 2026년 추천 Claude Code 스킬
53 https://skills.rest/skill/anti-slop-design [검색] anti-slop-design 스킬 (비제네릭 웹 인터페이스)
54 https://ui.shadcn.com/docs/skills [검색] shadcn/ui 공식 스킬. 컴포넌트 컨텍스트와 디자인 패턴 강제

H. AI 슬롭 분석 (55~61)

# URL 상태 설명
55 https://dev.to/rams901/hallmark-stop-ai-generated-ui-slop-in-one-command-in-2026-3p9n [검색] Hallmark 소개. "Pick a real direction (Swiss/editorial, brutalist, industrial-mono, organic, clean-product) and lock its tokens in a DESIGN.md at the project root"
56 https://www.925studios.co/blog/ai-slop-web-design-guide [검색] AI 슬롭 웹디자인 식별·수정 가이드
57 https://vibecodekit.dev/ai-slop-design [검색] AI UI가 제네릭해지는 원인 분석. "LLMs predict the next token based on probability distributions... 'safe' design patterns that appear frequently in web training data get sampled at high probability"
58 https://saascity.io/blog/stunning-frontend-designs-vibe-coding-avoid-ai-slop [검색] 바이브 코딩에서 슬롭 회피
59 https://www.mindstudio.ai/blog/claude-design-avoid-ai-slop-design-system [검색] Claude Design에서 디자인 시스템 접근으로 슬롭 회피
60 https://ui-ux-pro-max-skill.com/blog/avoiding-ai-slop/ 403 슬롭 회피 프롬프트 기법 7가지. 접근 실패(403). 내용 확인 못함
61 https://www.coddykit.com/pages/blog-detail?id=512918 [검색] Hallmark 소개 기사 (4,600+ 스타 시점)

I. 스킬 작성 방법론 (62~69)

# URL 상태 설명
62 https://raw.githubusercontent.com/obra/superpowers/main/skills/writing-skills/SKILL.md [직접] obra/superpowers 스킬 작성 규칙. "NO SKILL WITHOUT A FAILING TEST FIRST", description은 "Use when..." 시작 + 트리거 조건만, RED-GREEN-REFACTOR, 토큰 효율 목표치
63 https://github.com/obra/superpowers/blob/main/skills/writing-skills/anthropic-best-practices.md [검색] superpowers가 정리한 Anthropic 베스트 프랙티스 요약
64 https://generativeprogrammer.com/p/skill-authoring-patterns-from-anthropics [검색] Anthropic 베스트 프랙티스에서 도출한 작성 패턴 분석
65 https://agentman.ai/blog/build-your-first-agent-skill-skillmd-anatomy [검색] SKILL.md 해부 가이드
66 https://www.newsletter.swirlai.com/p/agent-skills-progressive-disclosure [검색] progressive disclosure를 시스템 설계 패턴으로 분석
67 https://strapi.io/blog/what-are-agent-skills-and-how-to-use-them [검색] Agent Skills 개요. 3계층 로딩 토큰 수치(~30-50 토큰/스킬)
68 https://arxiv.org/html/2602.12430v3 [검색] 논문: Agent Skills for LLMs — 아키텍처, 획득, 보안
69 https://www.deeplearning.ai/courses/agent-skills-with-anthropic [검색] DeepLearning.AI Agent Skills 코스

J. 포맷 스펙 보조 자료 (70~79)

# URL 상태 설명
70 https://github.com/sanjeed5/awesome-cursor-rules-mdc/blob/main/cursor-rules-reference.md [검색] Cursor .mdc 레퍼런스와 예제 모음
71 https://techsy.io/en/blog/cursor-rules-guide [검색] .mdc 프론트매터·globs·alwaysApply 해설
72 https://www.vibecodingacademy.ai/blog/cursor-rules-complete-guide [검색] Cursor Rules 완전 가이드 + 15개 템플릿
73 https://dev.to/vibestackdev/why-your-cursor-rules-are-being-silently-ignored-and-how-to-fix-it-4123 [검색] Cursor 규칙이 조용히 무시되는 원인과 해결
74 https://medium.com/@ror.venkat/mastering-mdc-files-in-cursor-best-practices-f535e670f651 [검색] .mdc 베스트 프랙티스
75 https://www.morphllm.com/agents-md-guide [검색] AGENTS.md vs CLAUDE.md vs .cursorrules 비교
76 https://codex.danielvaughan.com/2026/03/26/agents-md-advanced-patterns/ [검색] AGENTS.md 중첩 계층·오버라이드 파일·폴백 패턴
77 https://ralphable.com/blog/agents-md-scope-precedence-codex-2026-troubleshooting-guide [검색] Codex AGENTS.md 스코프·우선순위 3계층, 32 KiB 상한
78 https://www.tembo.io/blog/agents-md [검색] AGENTS.md 작성법
79 https://www.augmentcode.com/guides/how-to-build-agents-md [검색] AGENTS.md 구축 가이드
80 https://blakecrosley.com/blog/agents-md-patterns [검색] 실제로 에이전트 행동을 바꾸는 AGENTS.md 패턴
81 https://eastondev.com/blog/en/posts/ai/20260626-codex-agents-md-project-rules/ [검색] Codex용 AGENTS.md 규칙·로딩·템플릿
82 https://prpm.dev/blog/agents-md-deep-dive [검색] AGENTS.md 오픈 표준 심층

K. 로컬 파일 (조사 대상 원본) (83~99)

# 경로 상태 설명
83 C:\Users\encep\.agents\skills\design-taste-frontend\SKILL.md [로컬] 88KB/1,206줄. 다이얼 3축, 브리프 추론, AI Tells 4계층, Pre-Flight 60항목, 디자인시스템 매핑 + 부록 3종
84 C:\Users\encep\.agents\skills\design-taste-frontend-v1\SKILL.md [로컬] 226줄 v1 원형. 다이얼 최초 도입, Motion-Engine Bento 5-카드 아키타입
85 C:\Users\encep\.agents\skills\high-end-visual-design\SKILL.md [로컬] Double-Bezel(Doppelrand), Button-in-Button, Variance Engine, 성능 가드레일
86 C:\Users\encep\.agents\skills\minimalist-ui\SKILL.md [로컬] 웜 모노크롬 에디토리얼. hex 단위 팔레트, 절대 금지 9항목
87 C:\Users\encep\.agents\skills\industrial-brutalist-ui\SKILL.md [로컬] 스위스 인쇄 × 군용 터미널. 모드/기판 단일 선택 강제, gap:1px 그리드 기법
88 C:\Users\encep\.agents\skills\gpt-taste\SKILL.md [로컬] Python RNG 시뮬레이션, AIDA 구조, 2줄 헤드라인 철칙, grid-flow-dense, <design_plan> 게이트
89 C:\Users\encep\.agents\skills\imagegen-frontend-web\SKILL.md [로컬] 987줄. HARD OUTPUT RULE 선두 배치, 조합 변형 엔진 13축, 서사 스파인, Second-Read Moment
90 C:\Users\encep\.agents\skills\imagegen-frontend-mobile\SKILL.md [로컬] 1,465줄. 모바일 AI 텔, "not always simple, always clean", 27문항 품질 체크
91 C:\Users\encep\.agents\skills\image-to-code\SKILL.md [로컬] 1,228줄. 이미지 우선 워크플로, 다이얼 9축, 추출 규칙 5종, anti-slop 5분류
92 C:\Users\encep\.agents\skills\redesign-existing-projects\SKILL.md [로컬] "문제→해법" 페어 100+개, "AI가 빼먹는 것" 섹션, 위험 대비 효과 순 수정 우선순위
93 C:\Users\encep\.agents\skills\stitch-design-taste\SKILL.md + DESIGN.md [로컬] 메타 스킬. DESIGN.md 생성기. 출력 템플릿과 Best Practices/Pitfalls
94 C:\Users\encep\.agents\skills\brandkit\SKILL.md [로컬] 798줄. 로고 컨셉 5방법, 시각 모드 8종, 레퍼런스 사용 윤리
95 C:\Users\encep\.agents\skills\full-output-enforcement\SKILL.md [로컬] 60줄. 잘림 방지. 금지 문자열 목록 + [PAUSED — X of Y] 중단 포맷
96 C:\Users\encep\.claude\skills\graphify\SKILL.md [로컬] 1,242줄. trigger: 비표준 필드 사용 사례. Honesty Rules 섹션
97 C:\Users\encep\.claude\skills\codex-image\SKILL.md [로컬] 한국어 description + 리터럴 발화 나열 + 배제 조건 조합의 모범
98 C:\Users\encep\.codex-litellm\skills\refactor-governance\SKILL.md [로컬] description에 "NOT a trigger" 배제 조건을 넣은 사례
99 ...\bundled-skills\2.1.235\...\dataviz\references\anti-patterns.md 외 6개 [로컬] dataviz 참조 파일. ❌ / Why / ✅ 3단 구조, 실제 사례 인용

소스 통계

  • 총 URL/경로: 99개
  • 본문 직접 확인(WebFetch): 22개
  • 로컬 파일 직접 읽음: 17개
  • Skill 도구로 본문 확인: 2개 (artifact-design, dataviz)
  • 검색 결과 목록에서만 확인: 57개
  • 접근 실패: 1개 (#60, HTTP 403)

인용문의 출처 신뢰도

이 리서치의 모든 원문 인용은 위 목록에서 [직접] / [로컬] / [스킬] 표기된 41개 소스에서만 가져왔다. [검색] 표기 소스는 존재 확인과 맥락 파악에만 사용했고, 인용하지 않았다.

조사하려 했으나 실패하거나 확인 못한 것

  1. artifact-design / dataviz / artifact-diagramming / artifact-capabilities의 SKILL.md 원본 파일 — Claude Code 바이너리 임베드. 파일시스템 전수 검색에서 발견 못함. 단 Skill 도구 호출로 본문은 읽었다.
  2. Windsurf 공식 문서 원본docs.windsurf.comdocs.devin.ai로 리다이렉트. 리다이렉트된 문서 기준으로 정리했다. .windsurfrules 단일 파일 레거시 포맷의 상세 스펙은 확인 못함.
  3. #60 ui-ux-pro-max-skill.com "7 prompt techniques" — HTTP 403.
  4. Hallmark의 references/macrostructures.md, component-cookbook.md, themes/*.md 개별 파일 — 존재는 SKILL.md에서 확인했으나 파일 자체는 fetch하지 않았다. 21개 매크로구조와 20개 테마의 실제 이름 목록은 확인 못함(SKILL.md에 일부만 언급: Bento Grid, Long Document, Marquee Hero, Stat-Led, Workbench, Conversational FAQ, Manifesto, Photographic, Quote-Led, Specimen).
  5. skills-ref CLI 실제 검증 항목 — 저장소 URL만 확인, 실행 안 함.
  6. Cursor Skills와 .mdc Rules 동시 존재 시 우선순위 — 공식 문서에 명시 없음.
  7. Bolt.new의 디자인 관련 지시 — 프롬프트를 직접 읽었으나 디자인 전용 섹션이 없음을 확인. 추가 파일이 있을 수 있으나 Prompt.txt 하나만 확인했다.