dotskills は何をしますか？
技術スキルとプロジェクト経験を、シンプルでカスタマイズ可能な自動化CLIツールで追跡・可視化します。
概要
dotskills は、YAMLベースの設定ファイルからスキルとプロジェクトデータを読み取り、視覚的なレポート（スキルマトリクス、プロジェクトタイムラインなど）を生成するコマンドラインツールです。
インストール
npm install -g dotskills
または、プロジェクトローカルにインストール:
npm install --save-dev dotskills
クイックスタート
- プロジェクトのルートに
dotskills.yamlを作成します:
skills:
- name: "TypeScript"
level: 5
category: "言語"
- name: "React"
level: 4
category: "フロントエンド"
projects:
- name: "マイプロジェクト"
description: "すごいプロジェクト"
skills: ["TypeScript", "React"]
- スキルマップを生成:
dotskills generate
- 出力を確認:
デフォルトでは./output/skills.mdに生成されます。
設定オプション
dotskills.yamlで以下のフィールドがサポートされています:
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
skills | 配列 | はい | スキル定義のリスト |
projects | 配列 | いいえ | プロジェクト定義のリスト |
output | 文字列 | いいえ | 出力ファイルのパス（デフォルト: ./output/skills.md） |
theme | 文字列 | いいえ | 視覚テーマ（default、dark、minimal） |
スキルオブジェクト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
name | 文字列 | はい | スキル名 |
level | 数値 | はい | 習熟レベル（1〜5） |
category | 文字列 | はい | スキルカテゴリ |
プロジェクトオブジェクト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
name | 文字列 | はい | プロジェクト名 |
description | 文字列 | はい | プロジェクトの説明 |
skills | 配列 | はい | 使用されたスキル名のリスト |
使用例
SVGバッジを生成（HTML出力時）:
dotskills generate --format html
カスタム出力ディレクトリを指定:
dotskills generate --output ./docs/skills.md
統合
- Claude Code:
dotskills generateをワークフローステップとして実行 - Cursor: コミットフックまたはCIパイプラインで利用
- その他: Node.jsベースの環境であれば、npmスクリプトとして統合可能
ライセンス
MIT