# Stats

> code-forge 사용량 통계. ~/.code-forge/usage.jsonl을 파싱하여 에이전트/스킬 사용 빈도 top 5와 요약을 터미널에 출력.

- **Type:** Skill
- **Install:** `agentstack add skill-ggombee-code-forge-stats`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ggombee](https://agentstack.voostack.com/s/ggombee)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ggombee](https://github.com/ggombee)
- **Source:** https://github.com/ggombee/code-forge/tree/main/skills/stats

## Install

```sh
agentstack add skill-ggombee-code-forge-stats
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# /stats — Bellows 사용량 통계

usage.jsonl 로그를 분석하여 에이전트/스킬 사용 통계를 보여준다.

**[즉시 실행]** 아래 절차를 따라 통계를 출력하세요.

**입력**: $ARGUMENTS

---

## 옵션

| 옵션 | 설명 | 예시 |
|------|------|------|
| (없음) | 전체 통계 | `/stats` |
| `--week` | 최근 7일 | `/stats --week` |
| `--month` | 최근 30일 | `/stats --month` |
| `--project` | 현재 프로젝트만 | `/stats --project` |

---

## 실행 절차

### Step 1: 로그 파일 확인

```bash
LOG_FILE="$HOME/.code-forge/usage.jsonl"
```

파일이 없으면:
```
사용 기록이 없습니다. 에이전트나 스킬을 사용하면 자동으로 기록됩니다.
```

### Step 2: 통계 파싱

Bash로 usage.jsonl을 파싱한다.

**기간 필터링:**
- `--week`: 최근 7일의 타임스탬프만 필터
- `--month`: 최근 30일
- `--project`: `"project":"현재디렉토리명"`만 필터
- (없음): 전체

**파싱 방법:**

jq가 있으면 jq 사용:
```bash
# 에이전트 Top 5
jq -r 'select(.type=="agent") | .name' "$LOG_FILE" | sort | uniq -c | sort -rn | head -5

# 스킬 Top 5
jq -r 'select(.type=="skill") | .name' "$LOG_FILE" | sort | uniq -c | sort -rn | head -5
```

jq 없으면 grep/awk 폴백:
```bash
# 에이전트 Top 5
grep '"type":"agent"' "$LOG_FILE" | grep -o '"name":"[^"]*"' | sed 's/"name":"//;s/"//' | sort | uniq -c | sort -rn | head -5

# 스킬 Top 5
grep '"type":"skill"' "$LOG_FILE" | grep -o '"name":"[^"]*"' | sed 's/"name":"//;s/"//' | sort | uniq -c | sort -rn | head -5
```

### Step 3: 출력 형식

```markdown
## code-forge 사용 통계

**기간:** {시작일} ~ {종료일} ({총 N일})
**총 호출:** {총 횟수}회

### 에이전트 Top 5
| # | 에이전트 | 호출 | 비율 |
|---|---------|------|------|
| 1 | {name} | {count} | {%} |
| 2 | {name} | {count} | {%} |
| 3 | {name} | {count} | {%} |
| 4 | {name} | {count} | {%} |
| 5 | {name} | {count} | {%} |

### 스킬 Top 5
| # | 스킬 | 호출 | 비율 |
|---|------|------|------|
| 1 | {name} | {count} | {%} |
| 2 | {name} | {count} | {%} |
| 3 | {name} | {count} | {%} |
| 4 | {name} | {count} | {%} |
| 5 | {name} | {count} | {%} |

### 프로젝트별
| 프로젝트 | 에이전트 | 스킬 | 합계 |
|---------|---------|------|------|
| {name} | {count} | {count} | {total} |

### 일별 추이 (최근 7일)
{날짜}: {"█" * count} {count}
```

데이터가 적으면 (10건 미만) 간략 형식으로:
```
## code-forge 사용 통계

총 {N}회 사용 ({에이전트 X회, 스킬 Y회})

가장 많이 사용: {name} ({count}회)
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ggombee](https://github.com/ggombee)
- **Source:** [ggombee/code-forge](https://github.com/ggombee/code-forge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ggombee-code-forge-stats
- Seller: https://agentstack.voostack.com/s/ggombee
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.