feat: support Claude Code plugin and gh skill install (#2)

* claude plugin

* feat: enable gh skill install via auto-release workflow

Add a release workflow that reads .claude-plugin/plugin.json#version on
main pushes, creates a matching vX.Y.Z tag if missing, and runs
`gh skill publish --tag` so `gh skill install daleseo/korean-skills`
serves the latest tagged release. Document the gh CLI install paths
and the four install routes (gh tagged, gh pinned, npx main HEAD,
Claude Code plugin) in both READMEs.

* ci: add validate-skills workflow

Run two validation jobs on every PR and main push so spec violations
are caught before they reach the auto-publish path. The first job
runs `skills-ref validate` against each SKILL.md using the official
agentskills/agentskills tool. The second runs `gh skill publish
--dry-run` to gate publishability.

* ci: consolidate validate jobs into ci.yml with consistent naming

Merge the two jobs from validate-skills.yml into ci.yml so all PR
gates live in one workflow. Rename jobs into two clear groups:
validate-spec / validate-publish for static checks, install-local /
install-remote for end-to-end install smoke tests. The split file
made sense for Apollo's larger marketplace but is overkill for a
3-skill single-plugin repo.

* docs: make Korean the default README, refresh AGENTS.md

- Swap README files so the default README.md is Korean and English
  moves to README_EN.md, matching the predominantly Korean audience.
  Cross-language links updated in both files.
- Update AGENTS.md repo structure tree, README split note, and pattern
  update checklist to reflect the new filenames.
- Replace the stale CI/CD section (referenced the old `test` /
  `test-remote` jobs) with the current four-job setup and the
  release.yml summary.
- Add a Releasing / Versioning section explaining which version field
  drives the release tag, how individual SKILL.md versions stay
  independent, and which fields are advisory only.
- Delete grammar-checker.skill, a 10KB zip artifact left over from
  the old single-file distribution format.

Author: DaleSeo

.claude-plugin/marketplace.json

@@ -4,6 +4,10 @@
     "name": "DaleSeo",
     "url": "https://github.com/DaleSeo"
   },
+  "metadata": {
+    "description": "Korean language skills for AI coding agents: humanizer, grammar-checker, style-guide",
+    "version": "1.0.0"
+  },
   "plugins": [
     {
       "name": "korean-skills",

.claude-plugin/plugin.json

@@ -4,5 +4,16 @@
   "version": "1.0.0",
   "author": {
     "name": "DaleSeo"
-  }
+  },
+  "homepage": "https://github.com/DaleSeo/korean-skills",
+  "repository": "https://github.com/DaleSeo/korean-skills",
+  "license": "MIT",
+  "keywords": [
+    "korean",
+    "humanizer",
+    "grammar-checker",
+    "style-guide",
+    "ai-writing",
+    "natural-language"
+  ]
 }

.github/workflows/ci.yml

@@ -7,7 +7,82 @@ on:
     branches: [main]
 
 jobs:
-  test:
+  validate-spec:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Checkout agentskills repository
+        uses: actions/checkout@v6
+        with:
+          repository: agentskills/agentskills
+          path: agentskills
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+          cache: "pip"
+          cache-dependency-path: "agentskills/skills-ref/pyproject.toml"
+
+      - name: Install skills-ref
+        run: |
+          cd agentskills/skills-ref
+          pip install -e .
+
+      - name: Validate all skills
+        run: |
+          echo "🔍 Validating all skills..."
+
+          find skills -name "SKILL.md" | while read -r skill_file; do
+            skill_dir=$(dirname "$skill_file")
+            skill_name=$(basename "$skill_dir")
+
+            echo ""
+            echo "Validating $skill_name..."
+
+            if skills-ref validate "$skill_dir"; then
+              echo "✅ $skill_name is valid"
+            else
+              echo "❌ $skill_name validation failed"
+              exit 1
+            fi
+          done
+
+          echo ""
+          echo "✅ All skills validated successfully"
+
+  validate-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Ensure gh skill is available
+        run: |
+          if ! gh skill --help >/dev/null 2>&1; then
+            echo "Installing latest gh CLI..."
+            sudo mkdir -p -m 755 /etc/apt/keyrings
+            curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg >/dev/null
+            echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list >/dev/null
+            sudo apt-get update -qq
+            sudo apt-get install -y -qq gh
+          fi
+          gh --version | head -1
+
+      - name: Validate with gh skill
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh skill publish --dry-run
+
+  install-local:
     runs-on: ubuntu-latest
 
     steps:
@@ -34,7 +109,6 @@ jobs:
 
           echo "✅ Skills directory exists: $SKILLS_DIR"
 
-          # 설치된 모든 스킬 확인
           SKILL_COUNT=0
           for skill_dir in "$SKILLS_DIR"/*; do
             if [ -d "$skill_dir" ]; then
@@ -55,15 +129,13 @@ jobs:
           echo ""
           echo "✅ Successfully verified $SKILL_COUNT skills"
 
-          # 최소 1개 이상의 스킬이 설치되었는지 확인
           if [ $SKILL_COUNT -eq 0 ]; then
             echo "❌ No skills were installed"
             exit 1
           fi
 
-  test-remote:
+  install-remote:
     runs-on: ubuntu-latest
-    # main 브랜치에 merge된 후에만 실행
     if: github.ref == 'refs/heads/main'
 
     steps:
@@ -85,7 +157,6 @@ jobs:
 
           echo "✅ Skills directory exists: $SKILLS_DIR"
 
-          # 설치된 모든 스킬 확인
           SKILL_COUNT=0
           for skill_dir in "$SKILLS_DIR"/*; do
             if [ -d "$skill_dir" ]; then
@@ -106,7 +177,6 @@ jobs:
           echo ""
           echo "✅ Successfully verified $SKILL_COUNT skills"
 
-          # 최소 1개 이상의 스킬이 설치되었는지 확인
           if [ $SKILL_COUNT -eq 0 ]; then
             echo "❌ No skills were installed"
             exit 1

.github/workflows/release.yml

@@ -0,0 +1,64 @@
+name: Release
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Ensure gh skill is available
+        run: |
+          if ! gh skill --help >/dev/null 2>&1; then
+            echo "Installing latest gh CLI..."
+            sudo mkdir -p -m 755 /etc/apt/keyrings
+            curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg >/dev/null
+            echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list >/dev/null
+            sudo apt-get update -qq
+            sudo apt-get install -y -qq gh
+          fi
+          gh --version | head -1
+
+      - name: Read plugin version
+        id: version
+        run: |
+          v=$(jq -r .version .claude-plugin/plugin.json)
+          if [[ ! "$v" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "❌ plugin.json#version is not semver: '$v'"
+            exit 1
+          fi
+          echo "tag=v${v}" >> "$GITHUB_OUTPUT"
+          echo "Tag will be: v${v}"
+
+      - name: Skip if release already exists
+        id: gate
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          if gh release view "${{ steps.version.outputs.tag }}" >/dev/null 2>&1; then
+            echo "ℹ️ ${{ steps.version.outputs.tag }} already released, skipping."
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "✅ ${{ steps.version.outputs.tag }} is available"
+            echo "skip=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Publish skills
+        if: steps.gate.outputs.skip != 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh skill publish --tag "${{ steps.version.outputs.tag }}"

AGENTS.md

@@ -23,8 +23,8 @@ korean-skills/
 │       ├── SKILL.md        # Main skill documentation (Agent Skills format)
 │       ├── references/     # 6 category reference files (tone, terminology, numbering, list, quotation, datetime)
 │       └── examples/       # Inconsistent/consistent examples
-├── README.md               # English documentation
-└── README_KO.md            # Korean documentation
+├── README.md               # Korean documentation (default)
+└── README_EN.md            # English documentation
 ```
 
 ## Skills Architecture
@@ -117,16 +117,33 @@ Each skill follows the Agent Skills specification:
 
 ## CI/CD
 
-GitHub Actions workflow (`.github/workflows/ci.yml`) has two jobs:
+`.github/workflows/ci.yml` runs on every PR and main push with four jobs:
 
-- **`test`** (all branches): Installs all skills from the local repository (`npx skills add . --yes`) and verifies each skill has `SKILL.md` in `.agents/skills/`
-- **`test-remote`** (main branch only): Installs all skills from GitHub (`npx skills add daleseo/korean-skills --yes`) and verifies installation in `.agents/skills/`
+- **`validate-spec`**: Validates each `SKILL.md` against the Agent Skills spec using `skills-ref validate` (from `agentskills/agentskills`).
+- **`validate-publish`**: Runs `gh skill publish --dry-run` to check publishability before main merges.
+- **`install-local`**: Installs all skills from the local working tree via `npx skills add "$GITHUB_WORKSPACE" --yes` and verifies each skill landed in `.agents/skills/`.
+- **`install-remote`** (main only): Installs from the public GitHub source (`npx skills add daleseo/korean-skills --yes`) as a post-merge smoke test.
 
-Both jobs check that at least one skill was installed successfully.
+`.github/workflows/release.yml` runs on main pushes only. It reads `.claude-plugin/plugin.json#version`, creates a matching `vX.Y.Z` tag if missing, and runs `gh skill publish --tag` so `gh skill install daleseo/korean-skills --pin vX.Y.Z` resolves.
+
+## Releasing / Versioning
+
+Three places carry version numbers, but only one matters operationally.
+
+**`.claude-plugin/plugin.json#version`** — the source of truth. Bump it whenever you touch `skills/`, `.claude-plugin/`, or `.github/workflows/release.yml`. Effects:
+
+- The release workflow tags a matching `vX.Y.Z` on the next main push, which is what `gh skill install daleseo/korean-skills --pin vX.Y.Z` and `claude plugin update` resolve to.
+- New installs always pull the latest content regardless.
+
+Use semver: patch for fixes/wording, minor for new skills or pattern additions, major when removing or renaming a skill.
+
+**Individual `SKILL.md#version`** (e.g. humanizer 1.6.0) — independent of the plugin version. Track skill-internal evolution there. The plugin version doesn't have to follow the highest skill version — they're separate trackers, like Apollo's pattern (apollo-skills plugin at 1.2.x while internal skills are at various 1.x).
+
+**`marketplace.json#metadata.version` and `marketplace.json#plugins[0].version`** — keep aligned with `plugin.json#version` for tidiness, but no automation reads them today. CI does not enforce sync.
 
 ## Documentation Pattern
 
-**README Split**: README.md (English) and README_KO.md (Korean) are separate files with identical structure:
+**README Split**: README.md (Korean, default) and README_EN.md (English) are separate files with identical structure. Korean is the default since most users of this repo are Korean speakers:
 
 - Link to other language at top
 - Quick Start with installation commands
@@ -136,7 +153,7 @@ Both jobs check that at least one skill was installed successfully.
 **Documentation Hierarchy**:
 
 ```
-README.md/README_KO.md → SKILL.md → references/*.md
+README.md/README_EN.md → SKILL.md → references/*.md
 ```
 
 ## Adding New Patterns
@@ -157,7 +174,7 @@ When adding patterns to humanizer:
 
 3. **Update pattern counts**:
    - SKILL.md description and "총 N가지" headings
-   - README.md and README_KO.md detection categories
+   - README.md and README_EN.md detection categories
    - Reference file headers
 
 4. **Update pattern classification section** in SKILL.md if adding new verification level or severity rationale