winds.from.oz 技術メモ

PicoClawのスキル一覧を確認する方法と現状入っているスキル

Posted:

PicoClawのスキル一覧を確認する方法と現状入っているスキル

PicoClaw のスキルは、特定用途の手順や知識、補助スクリプトをまとめた小さなパッケージとして扱われる。

ここでは次の 2 つをまとめる。

  • スキル一覧を確認する方法
  • 現在 ~/.picoclaw/workspace/skills に入っているスキルの説明

スキル一覧を確認する方法

CLI から確認するなら、まずはこれでよい。

picoclaw skills list

現行実装では skills list は「インストール済みスキル」を列挙するコマンドになっている。

picoclaw skills list

必要なら個別スキルの詳細確認もできる。

picoclaw skills show weather
picoclaw skills show github

コマンド実装はこのあたりにある。

ファイルで直接確認する方法

workspace 側にあるスキルの実体は、次のように確認できる。

find ~/.picoclaw/workspace/skills -maxdepth 3 -type f | sort

基本的には各スキルディレクトリの SKILL.md が中心で、必要に応じて references/ や scripts/ が付く。

典型的な構成はこうなる。

~/.picoclaw/workspace/skills/
  weather/
    SKILL.md
  tmux/
    SKILL.md
    scripts/
      find-sessions.sh
      wait-for-text.sh
  hardware/
    SKILL.md
    references/
      board-pinout.md
      common-devices.md

現在入っているスキル

現在の ~/.picoclaw/workspace/skills には 6 個のスキルが入っている。

  • weather
  • skill-creator
  • summarize
  • hardware
  • github
  • tmux

以下、それぞれの用途と対応ファイルを整理する。

weather

天気確認用のスキル。wttr.in や Open-Meteo を使って、現在の天気や予報を確認するための内容が入っている。

向いている用途は次のようなものだ。

  • 今日の天気を知りたい
  • 指定都市の気温や湿度を確認したい
  • API キーなしで手早く天気を引きたい

対応ファイル:

  • ~/.picoclaw/workspace/skills/weather/SKILL.md

skill-creator

新しいスキルを作るときのためのガイドスキル。どういう構成で SKILL.md を書くか、scripts/ や references/ をどう分けるか、といった設計方針が入っている。

向いている用途は次のようなものだ。

  • PicoClaw 用のカスタムスキルを作りたい
  • 既存スキルの書き方をそろえたい
  • skill の粒度や構造を検討したい

対応ファイル:

  • ~/.picoclaw/workspace/skills/skill-creator/SKILL.md

summarize

URL、ローカルファイル、YouTube などの要約や抽出に使うスキル。summarize CLI を前提にしている。

向いている用途は次のようなものだ。

  • URL の内容を素早く要約したい
  • PDF やローカル文書を要約したい
  • YouTube 動画の概要や transcript を取りたい

対応ファイル:

  • ~/.picoclaw/workspace/skills/summarize/SKILL.md

hardware

I2C / SPI を使うハードウェア操作向けのスキル。Sipeed 系ボードを前提に、どの bus をどう扱うか、ピン設定やよく使うデバイスの情報がまとまっている。

向いている用途は次のようなものだ。

  • センサーを I2C で読む
  • SPI デバイスの読み書きをする
  • Sipeed ボードで pinmux 設定を確認する
  • AHT20 や SSD1306 などの代表的デバイス情報を見る

対応ファイル:

  • ~/.picoclaw/workspace/skills/hardware/SKILL.md
  • ~/.picoclaw/workspace/skills/hardware/references/board-pinout.md
  • ~/.picoclaw/workspace/skills/hardware/references/common-devices.md

github

GitHub を gh CLI で扱うためのスキル。Issue、PR、CI、gh api を使った取得方法などがまとまっている。

向いている用途は次のようなものだ。

  • PR の CI 状態を確認したい
  • workflow run の失敗ログを見たい
  • Issue や PR 情報を gh で取りたい
  • gh api を使って追加情報を取りたい

対応ファイル:

  • ~/.picoclaw/workspace/skills/github/SKILL.md

tmux

tmux セッションを操作するためのスキル。長時間タスク、対話型 CLI、複数エージェント並列起動などに向いている。

向いている用途は次のようなものだ。

  • 対話型 CLI をバックグラウンドで動かしたい
  • pane 出力を取得したい
  • 複数セッションを並列で管理したい
  • tmux セッションを外から監視したい

対応ファイル:

  • ~/.picoclaw/workspace/skills/tmux/SKILL.md
  • ~/.picoclaw/workspace/skills/tmux/scripts/find-sessions.sh
  • ~/.picoclaw/workspace/skills/tmux/scripts/wait-for-text.sh

実際に何が見えているかの注意点

PicoClaw はスキルを 1 か所だけでなく、複数のルートから読み込める設計になっている。

代表的には次の 3 系統がある。

  • workspace 側のスキル
  • global 側のスキル
  • builtin 側のスキル

ただし、運用上まず確認すべきなのは ~/.picoclaw/workspace/skills だと思う。自分で追加・修正したスキルを一番追いやすいからだ。

まとめ

まずは次の 2 つを覚えておけば十分だと思う。

picoclaw skills list
find ~/.picoclaw/workspace/skills -maxdepth 3 -type f | sort

skills list で論理的な一覧を見て、find で実体ファイルを確認する、という流れが分かりやすい。

今の環境では、天気、要約、GitHub、tmux、ハードウェア、スキル作成ガイドの 6 スキルが入っている。