🐙 技術調査 - gh skill

brew install gh

(type -p wget >/dev/null || (sudo apt update && sudo apt install wget -y)) \
  && sudo mkdir -p -m 755 /etc/apt/keyrings \
  && out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
  && cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
  && sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
  && sudo mkdir -p -m 755 /etc/apt/sources.list.d \
  && 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 update \
  && sudo apt install gh -y

sudo dnf install dnf5-plugins
sudo dnf config-manager addrepo --from-repofile=https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install gh --repo gh-cli

apk add github-cli

winget install --id GitHub.cli
# または
scoop install gh

{
  "features": {
    "ghcr.io/devcontainers/features/github-cli:1": {}
  }
}

brew upgrade gh                       # macOS
sudo apt update && sudo apt install gh # Linux (apt)
sudo dnf upgrade gh                    # Linux (DNF)

gh --version
# gh version 2.90.0 (2026-04-16)

gh auth login
# 既存認証に repo スコープを追加する場合
gh auth refresh -s repo

my-skills-repo/
├── skills/
│   ├── git-commit/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   ├── references/
│   │   └── assets/
│   └── code-review/
│       └── SKILL.md
└── README.md

---
name: pdf-processing
description: PDF からテキスト・表を抽出し、フォームへの記入や複数 PDF のマージを行います。PDF ドキュメントの操作が必要な場合に使用します。
license: Apache-2.0
compatibility: Python 3.14+ および uv が必要です。
metadata:
  author: example-org
  version: "1.0"
allowed-tools: Bash(python:*) Read Write
---

## 概要

ここにスキルの指示（Markdown）を記述します。

## 手順

1. ステップ 1
2. ステップ 2

gh skill search <query> [flags]

gh skill search terraform
gh skill search terraform --owner hashicorp
gh skill search code-review --json skillName,description,stars
gh skill search git --limit 5 --page 2
gh skill search documentation --json skillName,stars --jq 'sort_by(-.stars) | .[0:3]'

gh skill preview <repository> [<skill[@version]>] [flags]

gh skill preview github/awesome-copilot documentation-writer
gh skill preview github/awesome-copilot documentation-writer@v1.2.0
gh skill preview github/awesome-copilot documentation-writer@abc123def456
gh skill preview github/awesome-copilot

gh skill install <repository> [<skill[@version]>] [flags]

gh skill install
gh skill install github/awesome-copilot git-commit
gh skill install github/awesome-copilot git-commit@v1.2.0
gh skill install github/awesome-copilot git-commit --pin v1.2.0
gh skill install github/awesome-copilot git-commit \
  --agent claude-code --scope user
gh skill install ./my-skills-repo --from-local
gh skill install github/awesome-copilot git-commit --dir ./.claude/skills

gh skill update [<skill>...] [flags]

gh skill update
gh skill update mcp-cli git-commit
gh skill update --all
gh skill update --dry-run
gh skill update --force --all
gh skill update --unpin --all

gh skill publish [<directory>] [flags]

gh skill publish
gh skill publish ./skills/my-skill
gh skill publish --tag v1.0.0
gh skill publish --dry-run
gh skill publish --fix
gh skill publish --tag v1.1.0 --fix

ls .claude/skills/                # Claude Code + プロジェクト
ls ~/.claude/skills/              # Claude Code + ユーザー
ls .agents/skills/                # Copilot / Cursor / Codex / Gemini + プロジェクト
ls ~/.copilot/skills/             # Copilot + ユーザー

# 全エージェント・全スコープを横断
find . ~/.copilot ~/.claude ~/.cursor ~/.codex ~/.gemini \
  -name "SKILL.md" 2>/dev/null

grep -r "github-repo\|github-ref\|github-tree-sha" \
  .claude/skills/ ~/.claude/skills/ \
  --include="SKILL.md" -l

gh skill update --dry-run         # 更新可否の確認
gh skill update --all             # 一括更新
gh skill update --all --unpin     # ピン留め含めて全更新
gh skill update my-skill another  # 特定スキルのみ

#!/bin/bash
# scripts/update-skills.sh
echo "=== スキル更新確認 ==="
gh skill update --dry-run

echo "上記の更新を適用しますか？ (y/N)"
read -r answer
if [[ "$answer" == "y" ]]; then
  gh skill update --all
  echo "更新完了"
fi

rm -rf .claude/skills/my-skill/
rm -rf ~/.claude/skills/my-skill/

# 再インストール（上書き）
gh skill install github/awesome-copilot my-skill --force
gh skill install github/awesome-copilot my-skill@v2.0.0 --force

jobs:
  update-skills:
    runs-on: ubuntu-latest
    concurrency:
      group: skill-update-${{ github.ref }}
      cancel-in-progress: false
    steps:
      - uses: actions/checkout@v4
      - run: gh skill update --all
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

echo "=== スキル監査レポート ==="
for skill_md in \
  .claude/skills/*/SKILL.md \
  ~/.claude/skills/*/SKILL.md \
  .agents/skills/*/SKILL.md \
  ~/.copilot/skills/*/SKILL.md; do
  [ -f "$skill_md" ] || continue
  skill_name=$(basename "$(dirname "$skill_md")")
  echo "--- $skill_name ---"
  grep "github-repo\|github-ref\|github-tree-sha" "$skill_md" || echo "  (no provenance)"
done

for skill_md in .claude/skills/*/SKILL.md; do
  [ -f "$skill_md" ] || continue
  skill_name=$(basename "$(dirname "$skill_md")")
  repo=$(grep "github-repo:" "$skill_md" | awk '{print $2}')
  ref=$(grep "github-ref:" "$skill_md" | awk '{print $2}')
  sha=$(grep "github-tree-sha:" "$skill_md" | awk '{print $2}')
  echo "{\"skill\":\"$skill_name\",\"repo\":\"$repo\",\"ref\":\"$ref\",\"sha\":\"$sha\"}"
done | jq -s .

gh skill publish --dry-run       # 検証のみ
gh skill publish --fix --dry-run # 自動修正を試行
gh skill publish --tag v1.2.0    # 非対話公開
gh skill publish                 # 対話公開（タグ選択 + Immutable 設定）

name: Publish Agent Skill
on:
  push:
    tags:
      - 'v*'
jobs:
  publish:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
      - name: Validate skill
        run: gh skill publish --dry-run
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      - name: Publish skill
        run: gh skill publish --tag ${{ github.ref_name }}
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

my-skills-repo/
├── skills/
│   ├── {namespace}/
│   │   ├── code-review/
│   │   │   ├── SKILL.md
│   │   │   ├── scripts/
│   │   │   └── references/
│   │   └── test-generator/
│   │       └── SKILL.md
│   └── devops/
│       └── deploy-checker/
│           └── SKILL.md
├── LICENSE
└── README.md

git tag -a v1.2.0 -m "Add PDF extraction support"
git push origin v1.2.0
gh skill publish --tag v1.2.0

gh skill install github/awesome-copilot my-skill --pin v1.2.0
gh skill install github/awesome-copilot my-skill --pin abc123def456

# ピン留めされたスキルは update でスキップされる
gh skill update --dry-run

# 意図的にアップグレードする場合
gh skill update my-skill --unpin

# Claude Code 専用
gh skill install github/awesome-copilot my-skill \
  --agent claude-code --scope project
# → .claude/skills/

# Copilot 専用（既定スコープでは Cursor / Codex / Gemini と共有）
gh skill install github/awesome-copilot my-skill \
  --agent github-copilot --scope project
# → .agents/skills/

# Copilot 用に専用ディレクトリで分離
gh skill install github/awesome-copilot my-skill \
  --agent github-copilot --dir .copilot/skills

name: Validate Agent Skills
on:
  pull_request:
    paths:
      - 'skills/**'
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Validate skills (dry-run)
        run: gh skill publish --dry-run
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

name: Check Skill Updates
on:
  schedule:
    - cron: '0 9 * * 1'
  workflow_dispatch:
jobs:
  check-updates:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Check for skill updates
        id: check
        run: |
          OUTPUT=$(gh skill update --dry-run 2>&1)
          echo "$OUTPUT"
          if echo "$OUTPUT" | grep -q "update available"; then
            echo "updates_found=true" >> "$GITHUB_OUTPUT"
          fi
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      - name: Create PR if updates found
        if: steps.check.outputs.updates_found == 'true'
        run: |
          BRANCH="skill-updates-$(date +%Y%m%d)"
          git checkout -b "$BRANCH"
          gh skill update --all
          git add -A
          git commit -m "chore: update agent skills"
          git push origin "$BRANCH"
          gh pr create \
            --title "chore: update agent skills" \
            --body "Automated skill update" \
            --base main
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

# インストール前に必ず内容を確認
gh skill preview github/awesome-copilot my-skill

# 信頼できる owner のみを検索・インストール
gh skill search terraform --owner hashicorp
gh skill install hashicorp/terraform-skills my-tool

# 組織内で取得元を限定するスクリプト例
ALLOWED_OWNERS=("github" "anthropics" "openai" "your-org")
install_skill() {
  local repo="$1"
  local skill="$2"
  local owner="${repo%%/*}"
  if [[ " ${ALLOWED_OWNERS[*]} " =~ " ${owner} " ]]; then
    gh skill install "$repo" "$skill"
  else
    echo "Error: '$owner' は許可されていない owner です"
    exit 1
  fi
}

---
name: code-review
description: >
  コードレビューのベストプラクティスを適用してコードを分析します。
  PR、コミット、コードスニペットのレビュー依頼時に使用します。
---

## 概要
...（500行以下、詳細は references/ に分離）

## 詳細な手順
詳細は [リファレンスガイド](references/REFERENCE.md) を参照してください。

gh --version

brew upgrade gh                       # macOS
sudo apt update && sudo apt install gh # Linux (apt)

gh --version
# gh version 2.90.0 (2026-04-16)

gh auth status
gh auth login
gh auth refresh -s repo

gh api rate_limit

# リセット時刻を人間可読形式で表示
gh api rate_limit --jq '.resources.core | "remaining: \(.remaining)/\(.limit), reset: \(.reset | todate)"'

gh auth status

# 直接リポジトリを指定（検索をバイパス）
gh skill install owner/repo skill-name

# ローカルディレクトリから直接インストール
gh skill install ./path/to/skill-directory --from-local

# リポジトリに agent-skills トピックを追加（配布側）
gh repo edit owner/repo --add-topic agent-skills

gh skill publish --dry-run
gh skill publish --fix --dry-run

# NG/OK 例
# NG: name: My-Skill      → OK: name: my-skill
# NG: name: my--skill     → OK: name: my-skill
# NG: name: -my-skill     → OK: name: my-skill
# NG: allowed-tools: [Bash, Read]  → OK: allowed-tools: "Bash Read"

ls .claude/skills/
ls ~/.claude/skills/
ls .agents/skills/

gh skill install github/awesome-copilot my-skill \
  --agent claude-code --scope project

gh skill install github/awesome-copilot my-skill \
  --dir /path/to/custom/skills/

gh skill update my-skill --force
gh skill update --all --force

# 他のプロセスが動いていないか確認
ps aux | grep "gh skill"

# 残留ロックの削除（実装上のパス: ~/.agents/.skill-lock.json）
rm -f ~/.agents/.skill-lock.json

# 再実行
gh skill update --all

concurrency:
  group: gh-skill-${{ github.repository }}
  cancel-in-progress: false