Extract Glossary

指定されたリポジトリ、複数リポジトリ、または GitHub organization から、ドメイン固有の専門用語、業界用語、社内・プロダクト用語、リポジトリ実装マップ、技術構成、オンボーディング向け Mermaid 構成図を抽出・生成するときに使う。ユーザーが「用語集を作る」「ドメイン辞書を作る」「オンボーディング資料にする」「repo/org を見て専門用語をまとめる」「AI が再確認しなくてよい知識ベースを作る」と依頼したら起動する。

423 stars 6 forksGit & Code Review

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add mizchi/skills --skill extract-glossary
Manual install
git clone --depth 1 https://github.com/mizchi/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/extract-glossary ~/.claude/skills/extract-glossary

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# extract-glossary

指定されたコードベースから、人間のオンボーディング資料兼 AI の再確認防止用ナレッジを作るためのスキル。
成果物は「用語辞書」「リポジトリ実装マップ」「技術構成」「小さな Mermaid 図」に分ける。

## 目的

- 新規参加者が、業界用語・組織内用語・実装固有名を短時間で読めるようにする。
- AI エージェントが同じ用語や構成を毎回聞き返さず、既存資料を参照して作業できるようにする。
- コードベースの説明を、推測ではなく README/docs/schema/IaC/code 上の根拠に結びつける。

## 入力として受け取るもの

以下のどれでもよい。

- ローカル checkout のパス: `../repo`, `~/ghq/github.com/org/repo`
- GitHub URL: `https://github.com/org/repo`
- 複数リポジトリのリスト
- GitHub organization 名と絞り込み条件
- 出力先: 既存 repo の docs、`.claude/skills/<domain>-glossary/`、任意の Markdown ファイル群

入力が曖昧な場合は、まず候補 repo と出力先を確認する。ただしローカルや GitHub から合理的に特定できる場合は探索を始める。

## 成果物の標準構成

スキルとして作る場合は以下を基本にする。

```text
<domain>-glossary/
├── SKILL.md
├── references/
│   ├── glossary.md
│   ├── repository-map.md
│   └── architecture.md
└── assets/
    └── architecture-diagrams.md
```

通常の docs として作る場合も、同じ分割を保つ。

| ファイル | 役割 |
| --- | --- |
| `glossary.md` | 用語辞書。業界用語、ドメイン用語、組織内略称、実装固有名を分ける。 |
| `repository-map.md` | repo ごとの責務、主要ディレクトリ、見るべき入口、外部依存をまとめる。 |
| `architecture.md` | 技術スタック、データフロー、インフラ、デプロイ、運用上の注意をまとめる。 |
| `architecture-diagrams.md` | Mermaid 図。巨大な一枚図ではなく、用途別の小さな図に分ける。 |
| `SKILL.md` | AI がどの reference をいつ読むべきかだけを書く。詳細を詰め込みすぎない。 |

## 調査手順

### 1. スコープを確定する

1. 対象 repo/org と対象 branch/commit を確認する。
2. local checkout がある場合は `git remote -v` と `git rev-parse HEAD` を確認する。
3. GitHub 上の repo を見る場合は default branch と URL を確認する。
4. 成果物には、機械固有のローカルパスではなく GitHub URL を載せる。

ローカルパスを使って調査してもよいが、最終成果物では以下のように変換する。
Read the full skill on GitHub

Details

Skill name
extract-glossary
Repository
mizchi/skills
Path
extract-glossary/SKILL.md
Repo updated
18 November 2026

FAQ

What does the Extract Glossary skill do?

指定されたリポジトリ、複数リポジトリ、または GitHub organization から、ドメイン固有の専門用語、業界用語、社内・プロダクト用語、リポジトリ実装マップ、技術構成、オンボーディング向け Mermaid 構成図を抽出・生成するときに使う。ユーザーが「用語集を作る」「ドメイン辞書を作る」「オンボーディング資料にする」「repo/org を見て専門用語をまとめる」「AI が再確認しなくてよい知識ベースを作る」と依頼したら起動する。

How do I install the Extract Glossary skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add mizchi/skills --skill extract-glossary. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Extract Glossary popular?

It lives in mizchi/skills, which has 423 GitHub stars and 6 forks.

Related skills

Actions CI Tuning

423

mizchi/skills

Use when auditing or improving GitHub Actions workflows for a project. Covers cache setup (npm/pnpm/yarn), job parallelism, shard-based test splitting, artifact handling pitfalls, and Playwright-specific patterns. Trigger on: slow CI, cache miss, flaky shard jobs, merge-reports failures, or an explicit 'tune CI' request.

Testing & QA

AI Index

423

mizchi/skills

Method and tooling for measuring how AI-generated a piece of prose reads, in Japanese or English. Two layers — a deterministic lint for removable surface tells (scripts/slopscore.py, no API) and a judgment layer of typed probabilistic questions (Jev noul/score) for the tells that survive editing. Includes measured human/AI baselines, a gap-first calibration procedure, and labeled fixtures. Use when building or calibrating an AI-likeness score, or when a draft needs a defensible number rather than a vibe. For writing guidance use natural-writing-ja / natural-writing-en instead.

AI, LLMs & Agents

Apm Usage

423

mizchi/skills

Reference for APM manifests, installation, targeted updates, deployment paths and lockfiles. Invoke when the user explicitly asks about APM or apm.yml, or an unfamiliar APM command/error needs exact CLI details. Do not automatically invoke for every project that happens to have installed skills.

DevOps & Cloud

Gh Fix CI

423

mizchi/skills

Use when GitHub Actions PR checks are failing on a pull request and need to be diagnosed or fixed. Inspects checks / logs via `gh`, drafts a fix plan, and implements only after explicit approval. Trigger on red checks, failing workflow runs, `pr is failing CI` reports — even if the user does not name a specific check. Out of scope: external CI (e.g. Buildkite) — report only the details URL.

Git & Code Review

Conventional Changelog

423

mizchi/skills

Reference for Conventional Commits and automatic CHANGELOG generation. Compares release-please / changesets / git-cliff / towncrier and covers commit format, Keep a Changelog, and semver tag practices. Use when setting up or unifying a release flow.

Git & Code Review

Maintainer Persona

423

mizchi/skills

Write an issue or PR for a repository you do not own so its maintainers can triage it. Measures the target's own history (reviewers, gates, body length, headings, language, how first-time PRs fare) into an editable persona file, branches by context (OSS first-time / OSS returning / another team inside your org), drafts in Japanese and translates only after approval when the target writes English, checks with a fresh reader and a slop lint baselined on the maintainers' own PRs, and gates the send. Use when filing upstream issues, sending a fix or failing-test PR to another project or team, or r

Git & Code Review

Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.