luongnv89/claude-howto

## User Input

```text
$ARGUMENTS
```

You **MUST** consider the user input before proceeding. User should provide:
- **Idea/Topic**: The main concept or theme for the blog post
- **Resources**: URLs, files, or references to research (optional but recommended)
- **Target audience**: Who the blog post is for (optional)
- **Tone/Style**: Formal, casual, technical, etc. (optional)

**IMPORTANT**: If the user is requesting updates to an **existing blog post**, skip steps 0-8 and start directly at **Step 9**. Read the existing draft file(s) first, then proceed with the iteration process.

# Brand Voice Skill

## Overview
This skill ensures all communications maintain consistent brand voice, tone, and messaging.

## Brand Identity

### Mission
Help teams automate their development workflows with AI

### Values
- **Simplicity**: Make complex things simple
- **Reliability**: Rock-solid execution
- **Empowerment**: Enable human creativity

## User Input

```text
$ARGUMENTS
```

You **MUST** consider the user input before proceeding (if not empty). User may specify:
- `create` - Create new CLAUDE.md from scratch
- `update` - Improve existing CLAUDE.md
- `audit` - Analyze and report on current CLAUDE.md quality
- A specific path to create/update (e.g., `src/api/CLAUDE.md` for directory-specific instructions)

## Core Principles

# Code Review Skill

This skill provides comprehensive code review capabilities focusing on:

1. **Security Analysis**
   - Authentication/authorization issues
   - Data exposure risks
   - Injection vulnerabilities
   - Cryptographic weaknesses
   - Sensitive data logging

2. **Performance Review**
   - Algorithm efficiency (Big O analysis)
   - Memory optimization

# API Documentation Generator Skill

## Generates

- OpenAPI/Swagger specifications
- API endpoint documentation
- SDK usage examples
- Integration guides
- Error code references
- Authentication guides

## Documentation Structure

### For Each Endpoint

# Code Refactoring Skill

A systematic approach to refactoring code based on Martin Fowler's *Refactoring: Improving the Design of Existing Code* (2nd Edition). This skill emphasizes safe, incremental changes backed by tests.

> "Refactoring is the process of changing a software system in such a way that it does not alter the external behavior of the code yet improves its internal structure." — Martin Fowler

## Core Principles

1. **Behavior Preservation**: External behavior must remain unchanged
2. **Small Steps**: Make tiny, testable changes
3. **Test-Driven**: Tests are the safety net
4. **Continuous**: Refactoring is ongoing, not a one-time event
5. **Collaborative**: User approval required at each phase

<!-- i18n-source: 03-skills/blog-draft/SKILL.md -->
<!-- i18n-source-sha: f396788 -->
<!-- i18n-date: 2026-04-27 -->

---
name: blog-draft
description: アイデアとリソースからブログ記事の下書きを作成する。ブログ記事の執筆、リサーチからのコンテンツ作成、記事の下書き作成時に使用する。リサーチ、ブレインストーミング、アウトライン作成、バージョン管理付きの反復的な下書き作成を案内する。
---

## ユーザー入力

```text
$ARGUMENTS
```

<!-- i18n-source: 03-skills/brand-voice/SKILL.md -->
<!-- i18n-source-sha: a6380d8 -->
<!-- i18n-date: 2026-04-27 -->

---
name: brand-voice
description: すべてのコミュニケーションがブランドボイスとトーンのガイドラインに沿うことを保証する。マーケティングコピー、顧客向け連絡、公開コンテンツの作成時、またはブランドボイス、トーン、文体について言及がある場合に使用する。
user-invocable: false
---

# ブランドボイス・スキル

## 概要
このスキルは、すべてのコミュニケーションにおいて一貫したブランドボイス、トーン、メッセージングを維持する。

<!-- i18n-source: 03-skills/claude-md/SKILL.md -->
<!-- i18n-source-sha: f78c094 -->
<!-- i18n-date: 2026-04-27 -->
---
name: claude-md
description: Create or update CLAUDE.md files following best practices for optimal AI agent onboarding
---

## ユーザー入力

```text
$ARGUMENTS
```

ユーザー入力が空でない場合、進める前に **必ず** 内容を考慮すること。ユーザーは以下を指定する場合がある:

<!-- i18n-source: 03-skills/code-review-specialist/SKILL.md -->
<!-- i18n-source-sha: e978c49 -->
<!-- i18n-date: 2026-04-27 -->

---
name: code-review-specialist
description: セキュリティ、パフォーマンス、品質分析を含む包括的なコードレビュー。コードレビュー、コード品質分析、プルリクエスト評価の依頼があった場合、またはコードレビュー、セキュリティ分析、パフォーマンス最適化について言及がある場合に使用する。
---

# コードレビュー・スキル

このスキルは、以下に焦点を当てた包括的なコードレビュー機能を提供する。

1. **セキュリティ分析**
   - 認証・認可の問題

<!-- i18n-source: 03-skills/doc-generator/SKILL.md -->
<!-- i18n-source-sha: a6380d8 -->
<!-- i18n-date: 2026-04-27 -->

---
name: doc-generator
description: ソースコードから包括的かつ正確な API ドキュメントを生成する。API ドキュメントの作成・更新、OpenAPI 仕様の生成時、または API ドキュメント、エンドポイント、ドキュメントについて言及がある場合に使用する。
---

# API ドキュメント生成スキル

## 生成するもの

- OpenAPI/Swagger 仕様
- API エンドポイントのドキュメント

<!-- i18n-source: 03-skills/refactor/SKILL.md -->
<!-- i18n-source-sha: 245272f -->
<!-- i18n-date: 2026-04-27 -->
---
name: refactor
description: Martin Fowler の方法論に基づく体系的なコードリファクタリング。ユーザーがコードのリファクタリング、コード構造の改善、技術的負債の削減、レガシーコードのクリーンアップ、コードスメルの解消、コード保守性の向上を求めた際に使用する。本スキルは、リサーチ・計画・安全な段階的実装からなる段階的アプローチを案内する。
---

# コードリファクタリングスキル

Martin Fowler 著『Refactoring: Improving the Design of Existing Code』(第 2 版) に基づくコードリファクタリングへの体系的アプローチ。本スキルは、テストに支えられた安全で段階的な変更を重視する。

> "Refactoring is the process of changing a software system in such a way that it does not alter the external behavior of the code yet improves its internal structure." — Martin Fowler

## 中核となる原則

<!-- i18n-source: 03-skills/blog-draft/SKILL.md -->
<!-- i18n-source-sha: b968f42 -->
<!-- i18n-date: 2026-10-31 -->

## 사용자 입력

```text
$ARGUMENTS
```

계속 진행하기 전에 사용자 입력을 **반드시** 고려해야 합니다. 사용자는 다음을 제공해야 합니다:
- **아이디어/주제**: 블로그 게시물의 주요 개념 또는 테마
- **자료**: 연구를 위한 URL, 파일 또는 참고 자료 (선택 사항이지만 권장됨)
- **대상 독자**: 블로그 게시물이 누구를 위한 것인지 (선택 사항)
- **어조/스타일**: 공식적, 비공식적, 기술적 등 (선택 사항)

<!-- i18n-source: 03-skills/brand-voice/SKILL.md -->
<!-- i18n-source-sha: b968f42 -->
<!-- i18n-date: 2026-10-31 -->

# 브랜드 보이스 스킬

## 개요
이 스킬은 모든 커뮤니케이션이 일관된 브랜드 보이스, 톤 및 메시지를 유지하도록 보장합니다.

## 브랜드 아이덴티티

### 미션
AI를 활용하여 팀의 개발 워크플로 자동화를 돕습니다.

### 가치

<!-- i18n-source: 03-skills/claude-md/SKILL.md -->
<!-- i18n-source-sha: b968f42 -->
<!-- i18n-date: 2026-10-31 -->

## 사용자 입력

```text
$ARGUMENTS
```

진행하기 전에 사용자 입력을 **반드시** 고려해야 합니다 (비어 있지 않은 경우). 사용자는 다음을 지정할 수 있습니다:
- `create` - 처음부터 새로운 CLAUDE.md 생성
- `update` - 기존 CLAUDE.md 개선
- `audit` - 현재 CLAUDE.md의 품질 분석 및 보고
- 생성/업데이트할 특정 경로 (예: 디렉터리별 지침을 위한 `src/api/CLAUDE.md`)

<!-- i18n-source: 03-skills/code-review-specialist/SKILL.md -->
<!-- i18n-source-sha: b968f42 -->
<!-- i18n-date: 2026-10-31 -->

# 코드 검토 스킬

이 스킬은 다음 사항에 초점을 맞춘 포괄적인 코드 검토 기능을 제공합니다:

1.  **보안 분석**
    -   인증/권한 부여 문제
    -   데이터 노출 위험
    -   인젝션 취약점
    -   암호화 약점
    -   민감한 데이터 로깅

<!-- i18n-source: 03-skills/doc-generator/SKILL.md -->
<!-- i18n-source-sha: b968f42 -->
<!-- i18n-date: 2026-10-31 -->

# API 문서 생성기 기능

## 생성 항목

- OpenAPI/Swagger 사양
- API 엔드포인트 문서
- SDK 사용 예제
- 통합 가이드
- 오류 코드 참조
- 인증 가이드

<!-- i18n-source: 03-skills/refactor/SKILL.md -->
<!-- i18n-source-sha: b968f42 -->
<!-- i18n-date: 2026-10-31 -->

# 코드 리팩터링 스킬

마틴 파울러의 *Refactoring: Improving the Design of Existing Code* (2nd Edition)에 기반한 코드 리팩터링에 대한 체계적인 접근 방식입니다. 이 스킬은 테스트를 통해 뒷받침되는 안전하고 점진적인 변경을 강조합니다.

> "리팩터링은 코드의 외부 동작을 변경하지 않으면서 내부 구조를 개선하는 소프트웨어 시스템 변경 과정입니다." — 마틴 파울러

## 핵심 원칙

1.  **행동 보존**: 외부 동작은 변경되지 않아야 합니다.
2.  **작은 단계**: 작고 테스트 가능한 변경을 수행합니다.
3.  **테스트 주도**: 테스트는 안전망입니다.

## Введення користувача

```text
$ARGUMENTS
```

Ви **ПОВИННІ** врахувати введення користувача перед продовженням. Користувач має надати:
- **Ідея/Тема**: Основна концепція або тематика блог-посту
- **Ресурси**: URL, файли або посилання на дослідження (необовʼязково, але рекомендовано)
- **Цільова аудиторія**: Для кого блог-пост (необовʼязково)
- **Тон/Стиль**: Формальний, невимушений, технічний тощо (необовʼязково)

**ВАЖЛИВО**: Якщо користувач запитує оновлення **існуючого блог-посту**, пропустіть кроки 0-8 і починайте безпосередньо з **Кроку 9**. Спочатку прочитайте існуючий файл(и) чернетки, потім продовжуйте з процесом ітерації.

# Навичка голосу бренду

## Огляд
Ця навичка забезпечує послідовність голосу бренду, тону та повідомлень у всіх комунікаціях.

## Ідентичність бренду

### Місія
Допомогти командам автоматизувати робочі процеси розробки за допомогою AI

### Цінності
- **Простота**: Робити складне простим
- **Надійність**: Непохитне виконання
- **Розширення можливостей**: Дати простір людській креативності

## Введення користувача

```text
$ARGUMENTS
```

Ви **ПОВИННІ** врахувати введення користувача перед продовженням (якщо не порожнє). Користувач може вказати:
- `create` — створити новий CLAUDE.md з нуля
- `update` — покращити існуючий CLAUDE.md
- `audit` — проаналізувати та звітувати про якість поточного CLAUDE.md
- Конкретний шлях для створення/оновлення (напр., `src/api/CLAUDE.md` для інструкцій, специфічних для каталогу)

## Основні принципи

# Навичка код-рев'ю

Ця навичка забезпечує комплексні можливості код-рев'ю з фокусом на:

1. **Аналіз безпеки**
   - Проблеми автентифікації/авторизації
   - Ризики розкриття даних
   - Вразливості інʼєкцій
   - Криптографічні слабкості
   - Логування чутливих даних

2. **Аналіз продуктивності**
   - Ефективність алгоритмів (аналіз Big O)
   - Оптимізація памʼяті

# Навичка генерації документації API

## Генерує

- Специфікації OpenAPI/Swagger
- Документацію ендпоінтів API
- Приклади використання SDK
- Посібники з інтеграції
- Довідники кодів помилок
- Посібники з автентифікації

## Структура документації

### Для кожного ендпоінту

# Навичка рефакторингу коду

Систематичний підхід до рефакторингу коду на основі книги Мартіна Фаулера *Refactoring: Improving the Design of Existing Code* (2-ге видання). Ця навичка наголошує на безпечних, інкрементальних змінах, підкріплених тестами.

> «Рефакторинг — це процес зміни програмної системи таким чином, що не змінює зовнішню поведінку коду, але покращує його внутрішню структуру.» — Мартін Фаулер

## Основні принципи

1. **Збереження поведінки**: Зовнішня поведінка повинна залишатися незмінною
2. **Малі кроки**: Робити крихітні, тестовані зміни
3. **Тест-орієнтованість**: Тести — це страхувальна сітка
4. **Безперервність**: Рефакторинг — постійний процес, а не одноразова подія
5. **Співпраця**: Затвердження користувача потрібне на кожній фазі

## Đầu Vào Người Dùng

```text
$ARGUMENTS
```

Bạn **BẮT BUỘC** phải xem xét đầu vào của người dùng trước khi tiếp tục. Người dùng nên cung cấp:
- **Ý tưởng/Chủ đề**: Khái niệm hoặc chủ đề chính cho bài đăng blog
- **Tài nguyên**: URLs, files, hoặc tài liệu tham khảo để nghiên cứu (tùy chọn nhưng được khuyến nghị)
- **Đối tượng mục tiêu**: Bài đăng blog dành cho ai (tùy chọn)
- **Giọng điệu/Phong cách**: Trang trọng, thân mật, kỹ thuật, v.v. (tùy chọn)

**QUAN TRỌNG**: Nếu người dùng đang yêu cầu cập nhật cho một **bài đăng blog hiện có**, bỏ qua các bước 0-8 và bắt đầu trực tiếp tại **Bước 9**. Đọc các file draft hiện có trước, sau đó tiếp tục với quy trình lặp lại.

# Brand Voice Skill

## Tổng Quan
Skill này đảm bảo tất cả các truyền thông duy trì giọng điệu, ngữ điệu, và thông điệp thương hiệu nhất quán.

## Danh Tính Thương Hiệu

### Sứ Mệnh
Giúp các đội tự động hóa workflows phát triển của họ với AI

### Giá Trị
- **Sự Đơn Giản**: Làm cho những điều phức tạp trở nên đơn giản
- **Độ Tin Cậy**: Thực thi vững chắc
- **Sự Trao Quyền**: Cho phép sự sáng tạo của con người

## Đầu Vào Người Dùng

```text
$ARGUMENTS
```

Bạn **BẮT BUỘC** phải xem xét đầu vào của người dùng trước khi tiếp tục (nếu không trống). Người dùng có thể chỉ định:
- `create` - Tạo CLAUDE.md mới từ đầu
- `update` - Cải thiện CLAUDE.md hiện có
- `audit` - Phân tích và báo cáo về chất lượng CLAUDE.md hiện tại
- Một đường dẫn cụ thể để tạo/cập nhật (ví dụ: `src/api/CLAUDE.md` cho hướng dẫn cụ thể thư mục)

## Nguyên Tắc Cốt Lõi

# Code Review Skill

Skill này cung cấp các khả năng review code toàn diện tập trung vào:

1. **Phân Tích Bảo Mật**
   - Các vấn đề xác thực/uỷ quyền
   - Rủi ro lộ dữ liệu
   - Lỗ hổng tiêm nhiễm
   - Điểm yếu mật mã
   - Ghi log dữ liệu nhạy cảm

2. **Review Hiệu Suất**
   - Hiệu quả thuật toán (phân tích Big O)
   - Tối ưu hóa bộ nhớ

# Code Refactoring Skill

Một cách tiếp cận có hệ thống để refactor code dựa trên *Refactoring: Improving the Design of Existing Code* (ấn bản 2) của Martin Fowler. Skill này nhấn mạnh các thay đổi tăng dần, an toàn được hỗ trợ bởi tests.

> "Refactoring là quá trình thay đổi một hệ thống phần mềm theo cách mà nó không làm thay đổi hành vi bên ngoài của code nhưng cải thiện cấu trúc nội bộ của nó." — Martin Fowler

## Nguyên Tắc Cốt Lõi

1. **Bảo Tồn Hành Vi**: Hành vi bên ngoài phải không thay đổi
2. **Các Bước Nhỏ**: Thực hiện các thay đổi nhỏ, có thể test
3. **Được Dẫn Bởi Test**: Tests là lưới an toàn
4. **Liên Tục**: Refactoring là liên tục, không phải sự kiện một lần
5. **Hợp Tác**: Cần sự chấp thuận của người dùng tại mỗi giai đoạn

## 用户输入

```text
$ARGUMENTS
```

在继续之前，你**必须**先考虑用户输入。用户应提供：
- **想法/主题**：博客文章的核心概念或主题
- **资源**：用于研究的 URL、文件或参考资料（可选，但推荐）
- **目标读者**：这篇博客是写给谁看的（可选）
- **语气/风格**：正式、轻松、技术向等（可选）

**重要**：如果用户是在请求更新一篇**已有博客文章**，请跳过步骤 0-8，直接从**步骤 9** 开始。先阅读现有草稿文件，再继续迭代流程。

# 品牌语气技能

## 概览
此技能确保所有沟通内容在品牌语气、风格和信息传达上保持一致。

## 品牌定位

### 使命
帮助团队用 AI 自动化开发工作流

### 价值观
- **简洁**：把复杂的事情变简单
- **可靠**：执行稳健，结果稳定
- **赋能**：释放人的创造力

## 用户输入

```text
$ARGUMENTS
```

在继续之前，你**必须**先考虑用户输入（如果不为空）。用户可能会指定：
- `create` - 从零创建新的 CLAUDE.md
- `update` - 改进已有的 CLAUDE.md
- `audit` - 分析并报告当前 CLAUDE.md 的质量
- 一个具体路径，用于创建或更新（例如 `src/api/CLAUDE.md` 代表目录级说明）

## 核心原则

# 代码审查 Skill

这个 skill 提供全面的代码审查能力，重点关注：

1. **安全分析**
   - 身份验证 / 授权问题
   - 数据泄露风险
   - 注入漏洞
   - 密码学弱点
   - 敏感数据日志记录

2. **性能审查**
   - 算法效率（Big O 分析）
   - 内存优化

# API 文档生成 Skill

## 可生成内容

- OpenAPI / Swagger 规范
- API 端点文档
- SDK 使用示例
- 集成指南
- 错误码参考
- 认证指南

## 文档结构

### 每个端点的写法

# 代码重构 Skill

这是一个基于 Martin Fowler《Refactoring: Improving the Design of Existing Code》（第 2 版）的系统化代码重构方法。这个 skill 强调安全、渐进的修改，并由测试提供保障。

> “重构是在不改变软件外部行为的前提下，改进其内部结构的过程。” — Martin Fowler

## 核心原则

1. **保持行为不变**：外部行为必须保持一致
2. **小步前进**：每次只做很小、可测试的改动
3. **测试驱动**：测试是安全网
4. **持续进行**：重构是长期过程，不是一次性任务
5. **协作确认**：每个阶段都需要用户确认