Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
017e617
fix: add robot-security routing guidance to skill routers
aldegad Mar 30, 2026
022aa68
chore: add repository content validation
aldegad Mar 30, 2026
d2021e3
Merge pull request #2 from aldegad/aldegad/add-validation-checks
nowzero1702 Mar 30, 2026
58ffad4
feat: v3.0 - Add Space Security guideline, unify plugin to single kes…
nowzero1702 Apr 2, 2026
bda7e19
fix: rename skills-ko folders to start-ko/check-ko/fix-ko/guide-ko to…
nowzero1702 Apr 2, 2026
4ec5be6
fix: add space security to EN skill descriptions and body sections
nowzero1702 Apr 2, 2026
cf2b3ea
refactor: rename skill commands from /kesekit:start to /kesekit-start…
nowzero1702 Apr 2, 2026
995ac3c
fix: use namespace:skill format for commands (/kesekit:start instead …
nowzero1702 Apr 2, 2026
084aa97
fix: correct marketplace.json skill paths (use hyphens, not colons)
nowzero1702 Apr 2, 2026
0b01649
refactor: separate references into references/templates/scripts
nowzero1702 Apr 2, 2026
03c812f
feat: enrich CII scripts from source guide + add robot security scripts
nowzero1702 Apr 2, 2026
c82ae6d
chore: v3.1.0 — update CONTRIBUTING, validate script, changelog, vers…
nowzero1702 Apr 2, 2026
325df2b
docs: restructure README — Korean first, installation/usage first
nowzero1702 Apr 2, 2026
0636a91
fix: correct plugin install commands in README
nowzero1702 Apr 2, 2026
de7f127
fix: rename skill folders to remove kesekit- prefix to avoid double n…
nowzero1702 Apr 2, 2026
c7b536a
fix: use kesekit-start folder/skill names for autocomplete support
nowzero1702 Apr 2, 2026
a345fb5
feat: v3.2 - Add Secure Coding Guide (JS/Python/Pseudo Code, 46 items…
nowzero1702 Apr 2, 2026
4ecc3f2
fix: add secure coding PDF files to 문서/ and fix README links
nowzero1702 Apr 2, 2026
34f9696
docs: add Markdown conversions for all 10 reference documents
nowzero1702 Apr 2, 2026
f8a98e6
feat: v4.0 - Add Zero Trust Security Assessment (8 elements, 421 item…
nowzero1702 Apr 2, 2026
0b91f9e
docs: add Zero Trust PDF/MD documents and update README with guidelin…
nowzero1702 Apr 2, 2026
ebb8369
docs: update all 18 multilingual READMEs to v4.0 with Zero Trust + ca…
nowzero1702 Apr 3, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
36 changes: 13 additions & 23 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,37 +5,27 @@
"url": "https://github.com/cdppcorp"
},
"metadata": {
"description": "KISA-based security vulnerability assessment skills. Supports CII (Critical Information Infrastructure) with 560+ items and AI Security Guide. Technical, Administrative, Physical security evaluation based on Korean KISA guidelines.",
"version": "2.1.0",
"description": "KISA-based security vulnerability assessment skills. Supports CII (560+ items), AI Security Guide, Robot Security (103 items), Space Security (satellite/GSaaS/supply chain, 53 items), and Secure Coding Guide (JS/Python/Pseudo Code, 46 items, 49 CWE). Available in English and Korean.",
"version": "3.2.0",
"license": "MIT"
},
"plugins": [
{
"name": "kesekit-en",
"description": "Security vulnerability assessment skills (English). start(full CII + AI security audit), check(compliance pre-deployment checklist), fix(auto-fix with hardening scripts), guide(secure coding prompts for AI tools). Supports CII infrastructure (560+ items) and AI Security Guide.",
"name": "kesekit",
"description": "Security vulnerability assessment (EN/KO). CII infrastructure (560+), AI Security, Robot Security (IEC 62443), Space Security (satellite/GSaaS/supply chain, CMMC/NIS2), Secure Coding (JS/Python/Pseudo Code, 46 CWE). Use /kesekit-start, /kesekit-start-ko, /kesekit-check, /kesekit-fix, /kesekit-guide etc.",
"source": "./",
"strict": false,
"keywords": ["security", "KISA", "CII", "vulnerability", "assessment", "infrastructure", "hardening", "AI security", "robot security", "IEC 62443"],
"keywords": ["security", "KISA", "CII", "vulnerability", "assessment", "infrastructure", "hardening", "AI security", "robot security", "IEC 62443", "space security", "satellite", "GSaaS", "CMMC", "NIS2", "secure coding", "CWE", "OWASP", "JavaScript", "Python", "보안", "취약점", "분석평가", "우주보안", "로봇보안", "시큐어코딩"],
"category": "security",
"skills": [
"./skills/start",
"./skills/check",
"./skills/fix",
"./skills/guide"
]
},
{
"name": "kesekit-ko",
"description": "보안 취약점 분석평가 스킬 (한국어). start(CII + AI 보안 전체 감사), check(컴플라이언스 배포 전 체크리스트), fix(취약점 자동 수정 + 하드닝 스크립트), guide(AI 도구용 시큐어코딩 프롬프트 생성). 주요정보통신기반시설(560+항목)과 AI 보안 안내서를 지원합니다.",
"source": "./",
"strict": false,
"keywords": ["보안", "KISA", "주요정보통신기반시설", "취약점", "분석평가", "기반시설", "보안설정", "AI보안", "로봇보안", "IEC 62443"],
"category": "security",
"skills": [
"./skills-ko/start",
"./skills-ko/check",
"./skills-ko/fix",
"./skills-ko/guide"
"./skills/kesekit-start",
"./skills/kesekit-check",
"./skills/kesekit-fix",
"./skills/kesekit-guide",
"./skills-ko/kesekit-start-ko",
"./skills-ko/kesekit-check-ko",
"./skills-ko/kesekit-fix-ko",
"./skills-ko/kesekit-guide-ko"
]
}
]
Expand Down
23 changes: 23 additions & 0 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
name: Validate Content

on:
pull_request:
push:
branches:
- main

jobs:
validate:
runs-on: ubuntu-latest

steps:
- name: Checkout
uses: actions/checkout@v4

- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: "22"

- name: Validate repository content
run: node scripts/validate-content.mjs
25 changes: 25 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Python virtual environments
.venv*/
__pycache__/
*.pyc

# IDE
.idea/
.vscode/
*.swp
*.swo

# OS
Thumbs.db
.DS_Store

# Claude Code local
.claude/

# Authorkit working files (converted outputs are large)
authorkit/converted/ref-*/images/
authorkit/converted/ref-*/full.md
authorkit/.venv-ocr/

# Temp
*.tmp
159 changes: 128 additions & 31 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## 새 가이드라인 추가 방법

KESE-KIT은 **스킬 4개 고정 + references 확장** 구조입니다. 새 보안 가이드라인을 추가할 때 스킬 파일을 수정할 필요 없이 reference 파일만 추가하면 됩니다.
KESE-KIT은 **스킬 4개 고정 + 3-디렉터리 확장** 구조입니다. 새 보안 가이드라인을 추가할 때 스킬 파일을 수정할 필요 없이 `references/`, `templates/`, `scripts/` 디렉터리에 파일을 추가하면 됩니다.

### Step 1: 원본 문서 준비

Expand All @@ -16,29 +16,57 @@ authorkit/new pdf/ ← PDF 파일 배치
python authorkit/convert_pdf.py "authorkit/new pdf/가이드라인.pdf" authorkit/converted/ref-XXX ref-XXX
```

### Step 3: Reference 파일 작성
### Step 3: References / Templates / Scripts 파일 작성

`skills-ko/start/references/` 아래에 새 가이드라인 디렉터리를 생성합니다:
`skills-ko/kesekit-start-ko/` 아래 3개 디렉터리에 새 가이드라인 파일을 생성합니다:

```
skills-ko/start/references/
├── cii/ ← 기존
├── ai-security/ ← 기존
└── new-guideline/ ← 신규
├── overview.md
├── category-1.md
└── category-2.md
skills-ko/kesekit-start-ko/
├── SKILL.md
├── references/new-guideline/ ← 순수 설명/기준 문서
│ ├── overview.md
│ ├── category-1.md
│ └── category-2.md
├── templates/new-guideline/ ← 별지 서식, 체크리스트 테이블
│ ├── assessment-table.md
│ └── checklist.md
└── scripts/new-guideline/ ← 실행 가능한 점검/수정 스크립트
├── check-linux.sh
├── check-windows.ps1
└── fix-linux.sh
```

각 reference 파일은 다음을 포함해야 합니다:
- 항목 코드, 이름, 중요도
- 점검 내용 및 판단 기준 (양호/취약)
- 점검 명령어 또는 확인 방법
- 조치 방법
#### 디렉터리별 콘텐츠 배치 기준

| 디렉터리 | 들어가는 내용 | 예시 |
|-----------|--------------|------|
| `references/` | 순수 설명, 위협 기술, 가이드라인 본문, 판단 기준 (양호/취약) | 위협 시나리오 설명, 보안 요구사항 해설 |
| `templates/` | `코드\|항목\|중요도` 평가 항목 테이블, `□` 체크리스트, 채점 기준표 | 별지 서식, 컴플라이언스 체크리스트 |
| `scripts/` | 실행 가능한 bash/powershell/sql 점검·수정 명령어 | `check-linux.sh`, `fix-windows.ps1` |

> **참고**: 모든 가이드라인이 3개 디렉터리를 모두 사용하지는 않습니다.
> - `ai-security`, `space-security` 등은 `references/`를 사용합니다.
> - CII 등 체크리스트 중심 가이드라인은 `templates/`와 `scripts/`를 주로 사용합니다.
> - 새 가이드라인의 성격에 맞게 필요한 디렉터리만 생성하면 됩니다.

#### references/ 파일 작성 시 포함 사항
- 위협 설명 및 보안 요구사항
- 판단 기준 (양호/취약)
- 관련 표준·규격 출처

#### templates/ 파일 작성 시 포함 사항
- 항목 코드, 이름, 중요도 (`코드|항목|중요도` 테이블)
- 체크리스트 (`□` 형식)
- 채점·평가 기준표

#### scripts/ 파일 작성 시 포함 사항
- 점검 명령어 (bash/powershell/sql)
- 조치(수정) 명령어
- OS/환경별 분리 (linux/windows 등)

### Step 4: SKILL.md 라우터 업데이트

`skills-ko/start/SKILL.md`의 가이드라인 선택 테이블에 새 가이드라인을 추가합니다:
`skills-ko/kesekit-start-ko/SKILL.md`의 가이드라인 선택 테이블에 새 가이드라인을 추가합니다:

```markdown
| 3 | **새 가이드라인** | 설명 | 항목 수 |
Expand All @@ -49,26 +77,45 @@ skills-ko/start/references/
```markdown
## 새 가이드라인 분기 시

`references/new-guideline/` 디렉터리에서 해당 reference를 읽어 평가합니다.
`references/new-guideline/`, `templates/new-guideline/`, `scripts/new-guideline/` 디렉터리에서 해당 파일을 읽어 평가합니다.
```

**4개 스킬 (start, check, fix, guide) 모두 동일하게 업데이트합니다.**
**4개 스킬 (kesekit-start, kesekit-check, kesekit-fix, kesekit-guide) 모두 동일하게 업데이트합니다.**

### Step 5: References 복사
### Step 5: References / Templates / Scripts 복사

모든 스킬 디렉터리에 references를 복사합니다:
모든 스킬 디렉터리에 3개 디렉터리를 복사합니다:

```bash
# 한국어 스킬
cp -r skills-ko/start/references/new-guideline skills-ko/check/references/
cp -r skills-ko/start/references/new-guideline skills-ko/fix/references/
cp -r skills-ko/start/references/new-guideline skills-ko/guide/references/
cp -r skills-ko/kesekit-start-ko/references/new-guideline skills-ko/kesekit-check-ko/references/
cp -r skills-ko/kesekit-start-ko/templates/new-guideline skills-ko/kesekit-check-ko/templates/
cp -r skills-ko/kesekit-start-ko/scripts/new-guideline skills-ko/kesekit-check-ko/scripts/

cp -r skills-ko/kesekit-start-ko/references/new-guideline skills-ko/kesekit-fix-ko/references/
cp -r skills-ko/kesekit-start-ko/templates/new-guideline skills-ko/kesekit-fix-ko/templates/
cp -r skills-ko/kesekit-start-ko/scripts/new-guideline skills-ko/kesekit-fix-ko/scripts/

cp -r skills-ko/kesekit-start-ko/references/new-guideline skills-ko/kesekit-guide-ko/references/
cp -r skills-ko/kesekit-start-ko/templates/new-guideline skills-ko/kesekit-guide-ko/templates/
cp -r skills-ko/kesekit-start-ko/scripts/new-guideline skills-ko/kesekit-guide-ko/scripts/

# 영문 스킬
cp -r skills-ko/start/references/new-guideline skills/start/references/
cp -r skills-ko/start/references/new-guideline skills/check/references/
cp -r skills-ko/start/references/new-guideline skills/fix/references/
cp -r skills-ko/start/references/new-guideline skills/guide/references/
cp -r skills-ko/kesekit-start-ko/references/new-guideline skills/kesekit-start/references/
cp -r skills-ko/kesekit-start-ko/templates/new-guideline skills/kesekit-start/templates/
cp -r skills-ko/kesekit-start-ko/scripts/new-guideline skills/kesekit-start/scripts/

cp -r skills-ko/kesekit-start-ko/references/new-guideline skills/kesekit-check/references/
cp -r skills-ko/kesekit-start-ko/templates/new-guideline skills/kesekit-check/templates/
cp -r skills-ko/kesekit-start-ko/scripts/new-guideline skills/kesekit-check/scripts/

cp -r skills-ko/kesekit-start-ko/references/new-guideline skills/kesekit-fix/references/
cp -r skills-ko/kesekit-start-ko/templates/new-guideline skills/kesekit-fix/templates/
cp -r skills-ko/kesekit-start-ko/scripts/new-guideline skills/kesekit-fix/scripts/

cp -r skills-ko/kesekit-start-ko/references/new-guideline skills/kesekit-guide/references/
cp -r skills-ko/kesekit-start-ko/templates/new-guideline skills/kesekit-guide/templates/
cp -r skills-ko/kesekit-start-ko/scripts/new-guideline skills/kesekit-guide/scripts/
```

### Step 6: marketplace.json 업데이트
Expand All @@ -79,24 +126,74 @@ cp -r skills-ko/start/references/new-guideline skills/guide/references/

`README.md`와 `docs/` 아래 각 언어별 README에 새 가이드라인 정보를 추가합니다.

### Step 8: 검증 스크립트 실행

PR을 올리기 전에 아래 검증 스크립트를 실행하세요:

```bash
node scripts/validate-content.mjs
```

이 스크립트는 다음을 검사합니다:
- README / SKILL / reference 간 항목 수 정합성
- `start/check/fix/guide` 간 references/templates/scripts 파일 목록 및 내용 드리프트
- Robot Security 라우터 분기 누락 여부

GitHub Actions에서도 동일한 검증이 자동 실행됩니다.

---

## Reference 파일 작성 가이드
## 콘텐츠 파일 작성 가이드

### 구조
### 스킬 디렉터리 구조

```
skill-name/
├── SKILL.md
├── references/ ← 순수 설명/기준 문서
├── templates/ ← 별지 서식, 체크리스트 테이블
└── scripts/ ← 실행 가능한 점검/수정 스크립트
```

### references/ 파일 구조 예시

```markdown
# [시스템명] 취약점 분석·평가 항목
# [시스템명] 보안 가이드라인

> 출처 정보

## 1. 카테고리명

위협 설명, 보안 요구사항, 판단 기준 등 순수 설명 콘텐츠
```

### templates/ 파일 구조 예시

```markdown
# [시스템명] 취약점 분석·평가 항목

## 1. 카테고리명 (N항목)

| 코드 | 항목 | 중요도 |
|------|------|:------:|
| XX-01 | 항목명 | 상 |

### 주요 점검 명령어
### 체크리스트
- □ 항목 1 확인
- □ 항목 2 확인
```

### scripts/ 파일 구조 예시

```bash
#!/bin/bash
# XX-01: 항목명 점검
result=$(command_here)
if [ "$result" == "expected" ]; then
echo "[양호] XX-01"
else
echo "[취약] XX-01"
fi
```

### 원칙
Expand Down
Loading
Loading