tbsten/mir-error-handling
skills/mir-error-handling/SKILL.md
mir CLI でエラーが発生した際のトラブルシューティングを行う。SnippetNotFoundError, RegistryNotFoundError, FileConflictError 等のエラーメッセージが表示された場合や、ユーザが「エラーが出た」「動かない」「mir がうまくいかない」と言った場合に使用する。
tools
Updated Apr 15, 2026
$ install --global
skillsauthnpx skillsauth add tbsten/mir mir-error-handlingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 3:19 AM5.2s1 file scanned
SKILL.md
- name:
- mir-error-handling
- description:
- mir CLI でエラーが発生した際のトラブルシューティングを行う。SnippetNotFoundError, RegistryNotFoundError, FileConflictError 等のエラーメッセージが表示された場合や、ユーザが「エラーが出た」「動かない」「mir がうまくいかない」と言った場合に使用する。
error-handling
mir CLI でエラーが発生した際のトラブルシューティングを行う skill。
トリガー
ユーザが mir コマンドの実行中にエラーに遭遇した場合、またはエラーの原因を調べたい場合に使用する。
エラー一覧と対処法
SnippetNotFoundError
snippet が見つからない。
.mir/snippets/<name>.yamlと.mir/snippets/<name>/ディレクトリの両方が存在するか確認- 片方だけでは動作しない
- snippet 名のタイポがないか確認
snippet 名が不正
^[a-zA-Z0-9][a-zA-Z0-9-]*$に従っているか確認- 英数字とハイフンのみ、英数字始まり
RegistryNotFoundError
registry が見つからない。
mirconfig.yamlのregistries設定を確認--registryで指定した名前が存在するか確認mir listで利用可能な registry を確認
FileConflictError
install 先に同名ファイルが既にある。
- 対話モードで実行すると上書き確認プロンプトが表示される（yes/no/all）
--no-interactive使用時は上書きがスキップされる（--safeと同様）- または手動で既存ファイルを退避してから再実行
PathTraversalError
テンプレートのファイル名に .. が含まれている。
- テンプレートディレクトリ内のファイルパスに
..が含まれていないか確認 - テンプレートのファイルパスを修正する
変数未指定（非対話モード）
--no-interactive 使用時に必須変数が指定されていない。
- CLI 引数で
--変数名=値を指定する - または snippet.yaml の変数定義に
defaultを設定する
リモート registry への publish 失敗
| HTTP ステータス | 原因 | 対処 |
|---|---|---|
| 401 | publish_token が無効 | トークンを再取得して mirconfig.yaml を更新 |
| 403 | 権限不足 | トークンの権限を確認 |
| 409 | 同名 snippet が存在 | --force で上書き公開 |
YAML バリデーションエラー
snippet.yamlがschema/v1/snippet.schema.jsonに準拠しているか確認- 必須フィールド
nameが設定されているか確認 nameフィールドがファイル名と一致しているか確認
手順
- エラーメッセージを確認する
- 上記の一覧から該当するエラーを特定する
- 対処法に従って修正する
- 修正後、コマンドを再実行して動作を確認する
解決できない場合
mir --helpやmir <command> --helpでコマンドの使い方を確認- どうしても解決できなければ GitHub に issue を立てる: https://github.com/TBSten/mir/issues
Related Skills
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026
openclaw/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,764SKILL.mdUpdated Apr 10, 2026
steipete/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,588SKILL.mdUpdated Apr 13, 2026
steipete/xurl
tools
VerifiedTrustedCommunity
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
356,423SKILL.mdUpdated Apr 13, 2026