optimizing-performance skill
✓ 인증됨프론트엔드, 백엔드, 데이터베이스 레이어 전반의 애플리케이션 성능을 분석하고 최적화하여 지연 현상을 진단하고 로딩 속도를 개선합니다.
- GitHub 스타
- 1,423
- 파일
- 1
- 마지막 커밋
- 2026년 10월 6일
- 라이선스
- MIT
- 허용된 도구
- —
optimizing-performance skill은 무엇을 하나요?
optimizing-performance은(는) agent skill입니다. 프론트엔드, 백엔드, 데이터베이스 레이어 전반의 애플리케이션 성능을 분석하고 최적화하여 지연 현상을 진단하고 로딩 속도를 개선합니다.
skill의 SKILL.md에서 생성된 요약입니다.
optimizing-performance skill 정보
이 SKILL은 전체 스택에 걸쳐 애플리케이션의 지연 현상을 진단하고 로딩 속도를 개선할 수 있도록 지원합니다. 개발자는 코드 프로파일링, 번들 크기 감소 또는 데이터베이스 쿼리 최적화가 필요할 때 이 기능을 사용합니다. 기준 성능 측정부터 병목 지점 식별, 타겟 수정 적용까지 이어지는 구조화된 워크플로우를 제공합니다.
에이전트가 정확성 중심의 작업이 아닌 성능 프로파일링이나 지연 시간 문제를 해결해야 하는 작업을 맡았을 때 이 SKILL을 로드해야 합니다. Node.js, Python 및 Lighthouse를 통한 웹 성능 측정을 위한 특정 프로파일링 명령어를 활용합니다. 이 SKILL은 메모이제이션 및 코드 분할과 같은 프론트엔드 개선, 멀티 레이어 캐싱 및 비동기 처리와 같은 백엔드 강화, 그리고 EXPLAIN 또는 JOIN을 사용하여 N+1 쿼리 문제를 해결하는 데이터베이스 최적화를 모두 다룹니다. 사용자가 Web Vitals 및 API 지연 시간 지표와 같은 특정 목표 대비 진행 상황을 추적할 수 있도록 돕습니다.
agent가 수행할 수 있는 작업
- 1Node.js 애플리케이션 성능 프로파일링프로파일링 명령어를 실행하여 로그를 생성하고 Node.js 환경에서 느린 코드를 식별합니다.
- 2프론트엔드 번들 크기 감소JavaScript import를 최적화하고 코드 분할을 구현하여 로딩 속도를 개선합니다.
- 3느린 데이터베이스 쿼리 수정JOIN을 사용한 단일 쿼리 구현 또는 페이지네이션을 통해 N+1 쿼리 문제를 해결합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
optimizing-performance skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.플러그인에 optimizing-performance skill 설치
/plugin marketplace add CloudAI-X/claude-workflow-v2 /plugin install project-starter@claude-workflow
Claude Code에 optimizing-performance skill 설치
~/.claude/skills/optimizing-performance/SKILL.md
$ npx degit CloudAI-X/claude-workflow-v2/skills/optimizing-performance ~/.claude/skills/optimizing-performanceClaude Code (project)에 optimizing-performance skill 설치
.claude/skills/optimizing-performance/SKILL.md
$ npx degit CloudAI-X/claude-workflow-v2/skills/optimizing-performance .claude/skills/optimizing-performanceCodex에 optimizing-performance skill 설치
~/.agents/skills/optimizing-performance/SKILL.md
$ npx degit CloudAI-X/claude-workflow-v2/skills/optimizing-performance ~/.agents/skills/optimizing-performanceGemini CLI에 optimizing-performance skill 설치
~/.gemini/skills/optimizing-performance/SKILL.md
$ npx degit CloudAI-X/claude-workflow-v2/skills/optimizing-performance ~/.gemini/skills/optimizing-performanceClaude.ai에 optimizing-performance skill 설치
npx degit CloudAI-X/claude-workflow-v2/skills/optimizing-performance optimizing-performance && zip -r optimizing-performance.zip optimizing-performance # claude.ai → Customize → Skills → + → Create skill → Upload a skill → optimizing-performance.zip
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식
- 소스 저장소 연결 및 접근 가능cloudai-x/claude-workflow-v2/skills/optimizing-performance is public and reachablegithub.com/cloudai-x/claude-workflow-v2/tree/HEAD/skills/opt ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-10-06github.com/cloudai-x/claude-workflow-v2/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cloudai-x/claude-workflow-v2/blob/HEAD/skills/opt ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/cloudai-x/claude-workflow-v2/blob/HEAD/skills/opt ↗통과
- SKILL.md가 Agent Skills 형식을 따름Valid name and description; says when to use it; 242 linesgithub.com/cloudai-x/claude-workflow-v2/blob/HEAD/skills/opt ↗통과
SKILL.md
GitHub에서 보기Optimizing Performance
When to Load
- Trigger: Diagnosing slowness, profiling, caching strategies, reducing load times, bundle size optimization
- Skip: Correctness-focused work where performance is not a concern
Performance Optimization Workflow
Copy this checklist and track progress:
Performance Optimization Progress:
- [ ] Step 1: Measure baseline performance
- [ ] Step 2: Identify bottlenecks
- [ ] Step 3: Apply targeted optimizations
- [ ] Step 4: Measure again and compare
- [ ] Step 5: Repeat if targets not met
Critical Rule: Never optimize without data. Always profile before and after changes.
Step 1: Measure Baseline
Profiling Commands
# Node.js profiling
node --prof app.js
node --prof-process isolate*.log > profile.txt
# Python profiling
python -m cProfile -o profile.stats app.py
python -m pstats profile.stats
# Web performance
lighthouse https://example.com --output=json
Step 2: Identify Bottlenecks
Common Bottleneck Categories
| Category | Symptoms | Tools |
|---|---|---|
| CPU | High CPU usage, slow computation | Profiler, flame graphs |
| Memory | High RAM, GC pauses, OOM | Heap snapshots, memory profiler |
| I/O | Slow disk/network, waiting | strace, network inspector |
| Database | Slow queries, lock contention | Query analyzer, EXPLAIN |
Step 3: Apply Optimizations
Frontend Optimizations
Bundle Size:
// ❌ Import entire library
import _ from "lodash";
// ✅ Import only needed functions
import debounce from "lodash/debounce";
// ✅ Use dynamic imports for code splitting
const HeavyComponent = lazy(() => import("./HeavyComponent"));
Rendering:
// ❌ Render on every parent update
function Child({ data }) {
return <ExpensiveComponent data={data} />;
}
// ✅ Memoize when props don't change
const Child = memo(function Child({ data }) {
return <ExpensiveComponent data={data} />;
});
// ✅ Use useMemo for expensive computations
const processed = useMemo(() => expensiveCalc(data), [data]);
Images:
<!-- ❌ Unoptimized -->
<img src="large-image.jpg" />
<!-- ✅ Optimized -->
<img
src="image.webp"
srcset="image-300.webp 300w, image-600.webp 600w"
sizes="(max-width: 600px) 300px, 600px"
width="600"
height="400"
alt="Description"
loading="lazy"
decoding="async"
/>
Backend Optimizations
Database Queries:
-- ❌ N+1 Query Problem
SELECT * FROM users;
-- Then for each user:
SELECT * FROM orders WHERE user_id = ?;
-- ✅ Single query with JOIN
SELECT u.id, u.name, o.id AS order_id, o.total
FROM users u
LEFT JOIN orders o ON u.id = o.user_id;
-- ✅ Or use pagination
SELECT id, name FROM users WHERE id > :last_id ORDER BY id LIMIT 100;
Caching Strategy:
// Multi-layer caching
const getUser = async (id) => {
// L1: In-memory cache (fastest)
let user = memoryCache.get(`user:${id}`);
if (user) return user;
// L2: Redis cache (fast)
user = await redis.get(`user:${id}`);
if (user) {
user = JSON.parse(user);
memoryCache.set(`user:${id}`, user, 60);
return user;
}
// L3: Database (slow)
user = await db.users.findById(id);
await redis.setex(`user:${id}`, 3600, JSON.stringify(user));
memoryCache.set(`user:${id}`, user, 60);
return user;
};
Async Processing:
// ❌ Blocking operation
app.post("/upload", async (req, res) => {
await processVideo(req.file); // Takes 5 minutes
res.send("Done");
});
// ✅ Queue for background processing
app.post("/upload", async (req, res) => {
const jobId = await queue.add("processVideo", { file: req.file });
res.status(202).send({ jobId, status: "processing" });
});
Algorithm Optimizations
// ❌ O(n²) - nested loops
function findDuplicates(arr) {
const duplicates = [];
for (let i = 0; i < arr.length; i++) {
for (let j = i + 1; j < arr.length; j++) {
if (arr[i] === arr[j]) duplicates.push(arr[i]);
}
}
return duplicates;
}
// ✅ O(n) - hash map
function findDuplicates(arr) {
const seen = new Set();
const duplicates = new Set();
for (const item of arr) {
if (seen.has(item)) duplicates.add(item);
seen.add(item);
}
return [...duplicates];
}
Step 4: Measure Again
After applying optimizations, re-run profiling and compare:
Comparison Checklist:
- [ ] Run same profiling tools as baseline
- [ ] Compare metrics before vs after
- [ ] Verify no regressions in other areas
- [ ] Document improvement percentages
Performance Targets
Web Vitals
| Metric | Good | Needs Work | Poor |
|---|---|---|---|
| LCP | < 2.5s | 2.5-4s | > 4s |
| INP | < 200ms | 200-500ms | > 500ms |
| CLS | < 0.1 | 0.1-0.25 | > 0.25 |
| TTFB | < 800ms | 800ms-1.8s | > 1.8s |
API Performance
| Metric | Target |
|---|---|
| P50 Latency | < 100ms |
| P95 Latency | < 500ms |
| P99 Latency | < 1s |
| Error Rate | < 0.1% |
Validation
After optimization, validate results:
Performance Validation:
- [ ] Metrics improved from baseline
- [ ] No functionality regressions
- [ ] No new errors introduced
- [ ] Changes are sustainable (not one-time fixes)
- [ ] Performance gains documented
If targets not met, return to Step 2 and identify remaining bottlenecks.
이 스킬의 파일
1optimizing-performance skill 질문
Claude Code에 optimizing-performance skill을 어떻게 설치하나요?
npx degit CloudAI-X/claude-workflow-v2/skills/optimizing-performance ~/.claude/skills/optimizing-performance를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
optimizing-performance skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
Node.js 애플리케이션을 프로파일링하려면 어떻게 해야 하나요?
node --prof app.js 명령어를 사용한 후, 생성된 로그를 node --prof-process isolate*.log > profile.txt로 처리할 수 있습니다.
좋은 Web Vitals를 위한 목표 지표는 무엇인가요?
우수한 성능을 위해서는 LCP 2.5s 미만, INP 200ms 미만, CLS 0.1 미만, TTFB 800ms 미만을 유지해야 합니다.