Claude Code를 위한 전문 AI 에이전트 및 스킬 | 개발, DevOps, 클라우드 및 그 이상을 포함

중요

🌟 이 프로젝트는 더 큰 생태계의 일부가 될 것입니다! 계속 지켜봐 주세요

🥇 여러분의 기여는 이름과 GitHub 프로필과 함께 인정받고 소개될 것입니다.

🙌 모두를 위해 AI 코딩을 더 나은 방향으로 만들어가는 개발자 커뮤니티에 참여하세요!

FastAgent는 Claude Code를 위한 전문 플러그인(plugins)을 엄선하여 모은 컬렉션으로, 특화된 에이전트(agents), 스킬(skills), 명령(commands)을 통해 AI 코딩 어시스턴트의 기능을 확장합니다. 우리의 접근 방식은 간단합니다: 필요한 것만 선택하고, 토큰 낭비(token bloat)를 방지하며, 더 나은 결과를 얻는 것입니다.

🎯 집중 및 효율성: 각 플러그인은 특정 기술이나 역할에 정밀하게 집중되어 있습니다.
💰 토큰 효율성: 필요한 것만 로드하여 토큰을 절약하고 비용을 아낍니다.
🔧 모듈형 설계: 워크플로(workflow)에 따라 플러그인을 조합할 수 있습니다.
📦 간편한 설치: 명령어 하나로 기능을 추가할 수 있습니다.
🚀 프로덕션 준비 완료: 검증된 패턴과 베스트 프랙티스(best practices)를 제공합니다.

필요한 것을 쉽게 선택할 수 있도록 플러그인을 세 가지 계층으로 구성했습니다:

Core (코어): 대부분의 개발자에게 도움이 되는 광범위한 플러그인입니다. 코드 리뷰(code review), 디버깅(debugging), 리팩터링(refactoring)과 같은 기본적인 워크플로를 다룹니다.

사용 대상: 모든 사용자

Specialized (특화): 특정 직무를 위해 여러 기술과 워크플로를 결합한 역할 기반(role-based) 플러그인입니다.

사용 대상: 전문화된 역할을 수행하는 개발자

Deep-Dive (딥다이브): 특정 도구 및 프레임워크에 대한 깊은 전문 지식을 제공하는 기술 특정적(technology-specific) 플러그인입니다. 자신의 스택(stack)에 맞는 것을 선택하세요.

사용 대상: 특정 기술을 사용하는 개발자

Claude Code가 설치되어 있는지 확인하세요.

# Claude Code에서 다음을 실행하세요:
/plugin marketplace add armanzeroeight/agents-skills

# 플러그인 브라우저 열기
/plugin
# 또는 직접 설치
...

설치가 완료되면, 에이전트와 스킬은 작업 컨텍스트(context)에 따라 자동으로 활성화됩니다. 명령은 슬래시 명령어(slash commands)를 통해 사용할 수 있습니다.

ansible-toolkit | Playbook 설계, Role 생성 및 인벤토리 관리를 위한 Ansible 자동화 툴킷 (Automation Toolkit) | Playbook Architect | Role Builder, Inventory Manager | /lint-playbook |
azure-toolkit | 비용 최적화, ARM 템플릿 및 인프라 설계를 위한 Azure 클라우드 툴킷 (Cloud Toolkit) | Azure Architect | Azure Cost Optimizer, ARM Template Helper | /estimate-azure-cost |
gcp-toolkit | 비용 최적화, Cloud Build 구성 및 인프라 설계를 위한 Google Cloud Platform 툴킷 (Cloud Toolkit) | GCP Architect | GCP Cost Optimizer, Cloud Build Helper | /estimate-gcp-cost |
dbt-toolkit | 모델 구축, 테스트 및 문서화를 위한 dbt 데이터 변환 툴킷 (Data Transformation Toolkit) | DBT Architect | Model Builder, Test Generator | /validate-dbt |
github-actions-toolkit | 워크플로 설계, 커스텀 액션 생성 및 매트릭스 최적화를 위한 GitHub Actions CI/CD 툴킷 (CI/CD Toolkit) | Workflow Architect | Action Builder, Matrix Optimizer | /optimize-workflow |
react-native-toolkit | 네이티브 모듈 통합 및 성능 최적화를 위한 React Native 모바일 개발 툴킷 (Mobile Development Toolkit) | RN Architect | Native Module Helper, Performance Optimizer | /create-native-module |
nextjs-toolkit | 렌더링 전략 (SSR/SSG/ISR) 및 App Router 패턴을 위한 Next.js 프레임워크 툴킷 (Framework Toolkit) | Next.js Expert | SSR/SSG Advisor, App Router Helper | /create-page |
go-toolkit | 동시성 패턴 (Concurrency Patterns), 에러 처리 및 관용적인 Go 관행 (Idiomatic Go Practices)을 위한 Go 프로그래밍 언어 툴킷 (Programming Language Toolkit) | Go Expert | Goroutine Patterns, Error Handling | /check-go |

에이전트 (Agents)는 고수준의 아키텍처 결정을 내리고 적절한 접근 방식을 선택합니다. 이들은 "무엇을(what)"과 "왜(why)"에 집중합니다.

예시: 코드 리뷰어 (Code Reviewer) 에이전트는 리뷰 범위를 결정하고, 이슈의 우선순위를 정하며, 심각도 수준을 판단합니다.

스킬 (Skills)은 집중된 단계별 지침을 통해 특정 작업을 처리합니다. 이들은 "어떻게(how)"에 집중합니다.

예시: 코드 리뷰 관행 (Code Review Practices) 스킬은 효과적인 리뷰를 수행하기 위한 상세한 가이드를 제공합니다.

명령어 (Commands)는 자주 사용되는 프롬프트(prompts)를 위해 사용자가 호출하는 단축키입니다.

예시: /quick-review는 특정 파일에 대한 빠른 코드 리뷰를 트리거합니다.

에이전트는 필요할 때 스킬에 자동으로 작업을 위임합니다. 사용자는 수동 개입 없이도 최상위 수준의 전략적 사고와 필요할 때의 전술적 실행을 모두 얻을 수 있습니다.

팀 전체에 플러그인을 자동으로 설치하려면 프로젝트의 .claude/settings.json에 다음을 추가하세요:

{
"extraKnownMarketplaces": {
"fastagent-marketplace": {
...

팀원들이 해당 저장소(repository)를 신뢰하면 플러그인이 자동으로 설치됩니다.

에이전트는 컨텍스트 (context)에 따라 자동으로 활성화됩니다:

# 코드 리뷰 (Code review)
> 최근 변경 사항을 검토해줘
# 디버깅 (Debugging)
...

또는 명시적으로 호출할 수 있습니다:

> code-reviewer 에이전트를 사용하여 내 PR을 확인해줘
> iac-architect 에이전트에게 모듈 설계에 대해 물어봐줘

스킬 (Skills)은 관련이 있을 때 에이전트나 Claude에 의해 자동으로 호출됩니다:

# terraform-module-scaffolder 스킬 트리거
> S3 버킷을 위한 새로운 Terraform 모듈을 생성해줘
# code-review-practices 스킬 트리거
...

명령어 (Commands)는 슬래시 (slash) 구문을 통해 사용자가 호출합니다:

# 빠른 코드 리뷰
/quick-review
# 디버그 트레이스 (Debug trace)
...

/plugin

# 삭제하지 않고 비활성화
/plugin disable <plugin-name>@fastagent-marketplace
# 다시 활성화
...

/plugin uninstall <plugin-name>@fastagent-marketplace

/plugin marketplace update fastagent-marketplace

FastAgent의 핵심 원칙 중 하나는 토큰 효율성 (token efficiency)입니다. 비용을 절감하는 방법은 다음과 같습니다:

모든 것이 포함된 하나의 거대한 플러그인 대신, 특정 플러그인을 선택하세요:

# ❌ 모든 것을 로드하지 마세요
# 모든 기술이 포함된 하나의 거대한 플러그인
# ✅ 사용하는 것만 로드하세요
...

스킬은 점진적 공개 (progressive disclosure) 방식을 사용합니다. 상세 문서는 필요할 때만 로드됩니다:

skill/
├── SKILL.md # 항상 로드됨 (간결함)
└── references/ # 필요할 때만 로드됨 (상세함)

각 스킬은 한 가지 일을 잘 수행하여 컨텍스트 (context)를 가볍게 유지합니다:

• ✅
  terraform-state-manager

• 상태 작업만 수행 - ✅
  terraform-cost-estimator

• 비용 분석만 수행 - ❌
  terraform-everything

• 범위가 너무 넓어 토큰을 낭비함

기여를 환영합니다! 방법은 다음과 같습니다:

• 저장소 (repository)를 포크 (Fork) 합니다.

• 플러그인 디렉토리를 생성합니다:
  plugins/your-plugin-name/

• 에이전트 (agents), 스킬 (skills), 명령어 (commands)를 추가합니다.

• .claude-plugin/marketplace.json을 업데이트합니다.

• 풀 리퀘스트 (pull request)를 제출합니다.

plugins/your-plugin/
├── agents/
│ └── your-agent.md
...

에이전트 (Agents): 전략 및 상위 수준의 결정에 집중하세요
스킬 (Skills): 전술적이고 단계적인 가이드를 제공하세요
명령어 (Commands): 단순함을 유지하고 하나의 동작에 집중하세요
문서화 (Documentation): 트리거 단어 (trigger words)와 함께 명확한 설명을 작성하세요
테스트 (Testing): 제출하기 전에 Claude Code로 테스트하세요

자세한 가이드라인은 Plugin Design Manifesto를 참조하세요.

• Plugin Design Manifesto - 디자인 원칙 및 모범 사례 (Best practices)
• Claude Plugins - 플러그인 시스템 (Plugin system) 개요
• Claude Marketplaces - 마켓플레이스 (Marketplace) 관리
• Claude Commands - 슬래시 명령어 (Slash commands) 가이드
• Claude Skills - 에이전트 스킬 (Agent Skills) 문서
• Claude Subagents - 서브에이전트 (Subagents) 가이드

Issues: GitHub Issues
Discussions: GitHub Discussions
Website: gofastagent.com

MIT License - 자세한 내용은 LICENSE를 참조하세요.

커뮤니티가 커뮤니티를 위해 💜를 담아 만들었습니다.