home / skills / ceeon / skilllauncher / log-viewer

log-viewer skill

safe

/.claude/skills/log-viewer

This skill helps you view and analyze SkillLauncher logs to quickly diagnose issues and trace commands.

npx playbooks add skill ceeon/skilllauncher --skill log-viewer

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.4 KB

---
name: log-viewer
description: |
  查看和分析应用日志，帮助排查问题。当用户提到以下场景时触发：
  - 查日志、看日志、日志在哪
  - 查一下问题、排查错误、debug
  - 刚才执行了什么、历史记录
  - SkillLauncher 日志、应用日志
---

# Log Viewer

查看 SkillLauncher 日志，快速定位问题。

## 日志位置

```
~/Library/Logs/SkillLauncher/app.log
```

## 日志格式

```
[ISO8601时间戳] 消息
```

示例：
```
[2026-01-27T08:17:44Z] 发送: /todo-hub Anthropic mcpUI方案
```

## 日志类型

| 日志内容 | 含义 |
|----------|------|
| `========== SkillLauncher 启动 ==========` | 应用启动 |
| `加载了 N 个 skills` | 扫描到的 skills 数量 |
| `发送: /skill-name 参数` | 用户执行的命令 |

## 常用查询

```bash
# 最近 50 条
tail -50 ~/Library/Logs/SkillLauncher/app.log

# 搜索特定命令
grep "发送:" ~/Library/Logs/SkillLauncher/app.log | tail -20

# 搜索错误
grep -i "error\|fail\|❌" ~/Library/Logs/SkillLauncher/app.log

# 今天的日志
grep "$(date -u +%Y-%m-%d)" ~/Library/Logs/SkillLauncher/app.log

# 实时监控
tail -f ~/Library/Logs/SkillLauncher/app.log
```

## 排查指南

| 问题 | 检查方法 |
|------|----------|
| 命令没执行 | 看是否有 `发送:` 日志 |
| Skills 没显示 | 检查 `加载了 N 个 skills` 数量 |
| 流式不工作 | 确认 Claude CLI 支持 `--output-format stream-json` |

Overview

This skill inspects SkillLauncher application logs to help you find and fix issues quickly. It focuses on the app.log file stored in the user Library logs and surfaces recent activity, commands sent, load counts, and error markers. Use it to verify what ran, when it ran, and why streaming output or skills may not behave as expected.

How this skill works

The skill reads and filters the log file at ~/Library/Logs/SkillLauncher/app.log, parsing ISO8601 timestamps and common message patterns like startup markers, loaded skill counts, and sent commands. It supports quick queries for recent lines, command history, error searches, and real-time tailing to watch live activity. It also maps common log messages to troubleshooting actions so you can act on findings.

When to use it

You need to see what SkillLauncher executed recently or check command history
Troubleshooting missing or failing skills and verifying how many were loaded
Investigating streaming output issues or confirming Claude CLI formatting
Searching logs for errors, failures, or specific sent commands
Monitoring live activity after triggering a skill or reproducing a problem

Best practices

Open the log file path directly: ~/Library/Logs/SkillLauncher/app.log to avoid confusion
Use tail -50 to inspect recent activity and tail -f to watch live events during tests
Grep for '发送:' to list user-invoked commands, and grep for error|fail|❌ to find problems
Check timestamps in UTC (ISO8601) to correlate with other system logs
Verify CLAUDE CLI supports --output-format stream-json if streaming is failing

Example use cases

Confirm whether a user command was received: grep "发送:" ~/Library/Logs/SkillLauncher/app.log | tail -20
Investigate a failed run by searching for error markers: grep -i "error\|fail\|❌" ~/Library/Logs/SkillLauncher/app.log
See what happened today by grepping the current date in UTC for ISO8601 entries
Watch live output while reproducing an issue with tail -f ~/Library/Logs/SkillLauncher/app.log
Validate the launcher startup sequence by looking for '========== SkillLauncher 启动 ==========' and skill load counts

FAQ

Where is the log file located?

The log file is at ~/Library/Logs/SkillLauncher/app.log.

How do I list recent commands a user ran?

Search for lines containing '发送:' and tail the last results, for example: grep "发送:" ~/Library/Logs/SkillLauncher/app.log | tail -20.