Summary
mir CLI でエラーが発生した際のトラブルシューティングを行う。SnippetNotFoundError, RegistryNotFoundError, FileConflictError 等のエラーメッセージが表示された場合や、ユーザが「エラーが出た」「動かない」「mir がうまくいかない」と言った場合に使用する。
tbsten/mir · Archived
mir-error-handling
mir CLI でエラーが発生した際のトラブルシューティングを行う。SnippetNotFoundError, RegistryNotFoundError, FileConflictError 等のエラーメッセージが表示された場合や、ユーザが「エラーが出た」「動かない」「mir がうまくいかない」と言った場合に使用する。
Installation
$
npx skills add tbsten/mir --skill mir-error-handling
Stronger alternatives
This repository is archived — consider an actively maintained alternative.
mir-getting-started
Same source · more installs
tbsten/mir
mir のインストールと基本的な使い方をユーザに案?
6 installs
mir-update-snippet
Same source · more installs
tbsten/mir
既存の mir snippet を品質チェックリストに基づいて最新化・改善する。「snippet を改善したい」「最…
4 installs
mir-review-snippet
Same source · more installs
tbsten/mir
mir snippet の品質をレビューし、改善点を提案する。「snippet をレビューして」「品質を確認して」…
4 installs
mir-publish-guide
Same source · more installs
tbsten/mir
mir snippet の?
4 installsSimilar popular skills
Related neighbors and high-traction skills in the same topics — useful to compare before installing.
flutter-handling-http-and-json
Similar name
flutter/agent-plugins
Executes HTTP requests and handles JSON serialization in a Flutter app. Use when integrating wi…
8.7K installs
flutter-handling-concurrency
Similar name
flutter/agent-plugins
Executes long-running tasks in background isolates to keep the UI responsive. Use when performi…
8.6K installs
n8n-error-handling-official
Similar name
n8n-io/skills
Use when building any webhook-triggered workflow, scheduled/production-bound workflow, wiring a…
1.2K installs
golang-error-handling
Similar name
samber/cc-skills-golang
Idiomatic Golang error handling — creation, wrapping with %w, errors.Is/As, errors.Join, custom…
39.6K installs
error-handling-patterns
Similar name
wshobson/agents
20.9K installs
gdpr-data-handling
Similar name
wshobson/agents
13.3K installs
Also in this package
Other skills from tbsten/mir · top by installs.
npx skills add tbsten/mir
More details
Agent compatibility
Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.
Claude Code
Not declared
Cursor
Not declared
Codex
Not declared
GitHub Copilot
Not declared
Windsurf
Not declared
Gemini CLI
Not declared
Cline
Not declared
OpenCode
Not declared
Repository health
License
LICENSE
Default branch
main
Open issues
0
Status
Archived
Package contents
Files included with this skill beyond the listing page.
-
skill md
SKILL.md3,171 B -
docs
SUMMARY.md359 B
History
- First seen on skills.sh
- First recorded snapshot · 2 installs
SKILL.md
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