Communitygithub.com

SamuelChien/mega-skills-collection

사용자가 AGENTS.md 생성, 업데이트, 유지보수를 요청하거나 에이전트 지침을 간결하게 유지해야 할 때 사용합니다. 연구 기반의 모범 사례를 적용하여 최소한의 고효율 에이전트 문서를 작성합니다.

mega-skills-collection란 무엇인가요?

이 스킬은 에이전트 지향 문서인 AGENTS.md를 최소화된 형태로 유지하고 관리하는 방법을 정의합니다. 핵심 원칙은 문장 대신 헤더와 불릿, 코드 블록을 사용하고, 기존 설정 파일이나 문서를 참조하여 중복을 피하며, 파일 단위 명령어를 우선시하여 프로젝트 전체 빌드보다 효율성을 높입니다. 스킬은 pnpm, yarn, npm, uv, poetry 등 다양한 패키지 매니저와 ESLint, Biome, Ruff 같은 린터 설정을 탐지하고, 필수 섹션으로 패키지 매니저, 파일 단위 명령어 표, 커밋 귀속 정보를 포함할 것을 요구합니다. 또한 에이전트가 스스로 맥락을 파악할 수 있다는 점을 신뢰하여 '이 문서는...', '당신은...' 같은 군더더기 문구와 린터 규칙 중복, 전체 빌드 명령어를 금지하는 안티패턴을 명시합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AGENTS.md 또는 CLAUDE.md를 지원하는 모든 플랫폼에서 사용할 수 있으며, AGENTS.md를 생성한 후 심볼릭 링크로 CLAUDE.md를 연결하는 설정을 포함합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agents-md

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

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

문서

AGENTS.md 유지 관리

AGENTS.md는 에이전트 전용 문서입니다. 간결하게 유지하세요 — 에이전트는 능숙하며 과잉 안내가 필요하지 않습니다. 60줄 미만을 목표로 하고, 100줄을 넘지 마세요. 문서가 길어질수록 지침 수행 품질이 저하됩니다.

사용 시점

  • 사용자가 AGENTS.md 또는 CLAUDE.md의 생성, 업데이트, 감사를 요청할 때
  • 프로젝트에 실제 도구 체인과 저장소 구조에서 도출된 간결하고 고효율의 에이전트 지침이 필요할 때
  • 기존 에이전트 문서가 너무 길거나, 중복되거나, 실제 프로젝트 관행에서 벗어날 때

파일 설정

  1. 프로젝트 루트에 AGENTS.md 생성
  2. 심볼릭 링크 생성: ln -s AGENTS.md CLAUDE.md

작성 전 분석

프로젝트를 분석하여 파일에 포함할 내용을 파악하세요:

  1. 패키지 매니저 — 잠금 파일 확인 (pnpm-lock.yaml, yarn.lock, package-lock.json, uv.lock, poetry.lock)
  2. 린터/포매터 설정 — .eslintrc, biome.json, ruff.toml, .prettierrc 등 확인 (이것들을 AGENTS.md에 중복하지 마세요)
  3. CI/빌드 명령어 — Makefile, package.json 스크립트, CI 설정에서 표준 명령어 확인
  4. 모노레포 표시 — pnpm-workspace.yaml, nx.json, Cargo 워크스페이스, 하위 디렉토리 package.json 파일 확인
  5. 기존 관행 — 기존 CONTRIBUTING.md, docs/, README 패턴 확인

작성 규칙

  • 헤더 + 불릿 — 문단 없음
  • 코드 블록 — 명령어와 템플릿용
  • 참조, 포함 금지 — 기존 문서를 가리키세요: "설정은 CONTRIBUTING.md 참조" 또는 "src/api/routes/의 패턴 따를 것"
  • 불필요한 내용 금지 — 서문, 결론, 인사말 없음
  • 능력 신뢰 — 명백한 맥락은 생략
  • 파일 단위 명령어 선호 — 프로젝트 전체 빌드보다 파일별 테스트/린트/타입체크 명령어
  • 린터 중복 금지 — 코드 스타일은 린터 설정에, AGENTS.md에 넣지 마세요

필수 섹션

패키지 매니저

어떤 도구와 주요 명령어만:

## 패키지 매니저
**pnpm** 사용: `pnpm install`, `pnpm dev`, `pnpm test`

파일 단위 명령어

파일 단위 명령어는 전체 프로젝트 빌드보다 빠르고 저렴합니다. 가능하면 항상 포함하세요:

## 파일 단위 명령어
| 작업 | 명령어 |
|------|--------|
| 타입체크 | `pnpm tsc --noEmit path/to/file.ts` |
| 린트 | `pnpm eslint path/to/file.ts` |
| 테스트 | `pnpm jest path/to/file.test.ts` |

커밋 귀속

항상 이 섹션을 포함하세요. 에이전트는 자신의 정체성을 사용해야 합니다:

## 커밋 귀속
AI 커밋에는 반드시 포함:

Co-Authored-By: (에이전트 모델 이름과 귀속 표시줄)

예시: `Co-Authored-By: Claude Sonnet 4 <[email protected]>`

주요 관행

에이전트가 따라야 할 프로젝트별 패턴. 간단히 유지.

선택적 섹션

정말 필요한 경우에만 추가:

  • API 라우트 패턴 (설명 없이 템플릿만 표시)
  • CLI 명령어 (표 형식)
  • 파일 명명 규칙
  • 프로젝트 구조 힌트 (중요 파일 가리키기, 피해야 할 레거시 코드 표시)
  • 모노레포 재정의 (하위 디렉토리 AGENTS.md 파일이 루트를 재정의)

안티패턴

다음은 생략:

  • "...에 오신 것을 환영합니다" 또는 "이 문서는 ...을 설명합니다"
  • "당신은 ...해야 합니다" 또는 "...하는 것을 기억하세요"
  • 설정 파일(.eslintrc, biome.json, ruff.toml)에 이미 있는 린터/포매터 규칙
  • 설치된 스킬이나 플러그인 나열 (에이전트가 자동으로 발견)
  • 파일 단위 대안이 있을 때 전체 프로젝트 빌드 명령어
  • 명백한 지침 ("테스트 실행", "깔끔한 코드 작성")
  • 이유 설명 (그냥 무엇을 할지만 말하세요)
  • 긴 산문 문단

예시 구조

# 에이전트 지침

## 패키지 매니저
**pnpm** 사용: `pnpm install`, `pnpm dev`

## 커밋 귀속
AI 커밋에는 반드시 포함:

Co-Authored-By: (에이전트 모델 이름과 귀속 표시줄)


## 파일 단위 명령어
| 작업 | 명령어 |
|------|--------|
| 타입체크 | `pnpm tsc --noEmit path/to/file.ts` |
| 린트 | `pnpm eslint path/to/file.ts` |
| 테스트 | `pnpm jest path/to/file.test.ts` |

## API 라우트
[템플릿 코드 블록]

## CLI
| 명령어 | 설명 |
|--------|------|
| `pnpm cli sync` | 데이터 동기화 |

제한 사항

  • 이 스킬은 위에서 설명한 범위와 명확히 일치하는 작업에만 사용하세요.
  • 출력물을 환경별 검증, 테스트, 전문가 검토의 대체물로 취급하지 마세요.
  • 필수 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 멈추고 명확히 요청하세요.

Individual skills in this repo

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

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

관련 스킬