How do I install the Logs skill?

Run npx skillmds@latest add tomevault-io/logs-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Logs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Logs by tomevault-io — Agent Skill

Name: Logs
Author: tomevault-io

File contents

Log Aggregator

View and search logs from multiple sources across your projects.

Arguments

$0: Service name or project (optional - shows all if not specified)
$1: Options - error, warn, tail, search:pattern (optional)

Log Sources by Project

Project	Source	Location/Command
eruditiontx-services-mvp	systemd	`journalctl -u erudition-service`
eruditiontx-services-mvp	app	`~/Projects/eruditiontx-services-mvp/logs/`
mathmatterstx-services	systemd	`journalctl -u mathmatters-service`
agila-tax-management	docker	`docker logs agila-backend`
notaryo.ph	Next.js	`.next/` logs, terminal output
bocs-turbo	Vercel	`vercel logs`

Commands

View Recent Logs

Systemd Services:

journalctl -u $SERVICE -n 100 --no-pager
# Follow mode
journalctl -u $SERVICE -f

Docker Containers:

docker logs $CONTAINER --tail 100
# Follow mode
docker logs $CONTAINER -f

Application Log Files:

tail -n 100 ~/Projects/$PROJECT/logs/app.log
# Follow mode
tail -f ~/Projects/$PROJECT/logs/app.log

Filter by Level

Errors Only:

# Systemd
journalctl -u $SERVICE -p err -n 100 --no-pager

# Docker/Files
docker logs $CONTAINER 2>&1 | grep -i "error\|exception\|traceback"

# Log files
grep -i "error\|exception\|traceback" ~/Projects/$PROJECT/logs/app.log

Warnings:

grep -i "warn\|warning" $LOG_SOURCE

Search Logs

# Search for pattern
journalctl -u $SERVICE | grep -i "$PATTERN"
docker logs $CONTAINER 2>&1 | grep -i "$PATTERN"
grep -i "$PATTERN" ~/Projects/$PROJECT/logs/*.log

Time-Based Filtering

# Last hour
journalctl -u $SERVICE --since "1 hour ago"

# Today
journalctl -u $SERVICE --since today

# Specific time range
journalctl -u $SERVICE --since "2024-01-01 00:00:00" --until "2024-01-01 23:59:59"

Log Aggregation Mode

View logs from multiple services at once:

# All Erudition services
journalctl -u erudition-service -u mathmatters-service -f

# All Docker containers
docker-compose logs -f

Log Analysis

Count Errors by Type

grep -i "error" $LOG_FILE | sort | uniq -c | sort -rn | head -20

Find Slow Requests

grep -E "took [0-9]+ms" $LOG_FILE | awk '{print $NF}' | sort -rn | head -10

Track Request IDs

grep "$REQUEST_ID" $LOG_FILE

Output Format

Logs: [service-name]
Source: [systemd/docker/file]
Filter: [all/error/warn]
Time: [range]

---
[Formatted log entries with timestamps]
---

Summary:
- Total entries: X
- Errors: Y
- Warnings: Z
- Time span: [start] to [end]

Common Log Patterns

FastAPI (Python)

INFO:     127.0.0.1:52847 - "GET /health HTTP/1.1" 200 OK
ERROR:    Exception in route handler: [error message]

Next.js

ready - started server on 0.0.0.0:3000
error - Error: [error message]
warn - [warning message]

Docker

[timestamp] [level] [message]

Troubleshooting

If logs are empty:

Check if service is running: systemctl status $SERVICE
Check log rotation: ls -la /var/log/
Check Docker container status: docker ps -a
Verify log file permissions

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: logs-3description: View and aggregate logs from various sources (systemd, docker, application files). Use when debugging, monitoring services, or investigating errors. Use when this capability is needed.---# Log AggregatorView and search logs from multiple sources across your projects.## Arguments- `$0`: Service name or project (optional - shows all if not specified)- `$1`: Options - `error`, `warn`, `tail`, `search:pattern` (optional)## Log Sources by Project| Project | Source | Location/Command ||---------|--------|------------------|| eruditiontx-services-mvp | systemd | `journalctl -u erudition-service` || eruditiontx-services-mvp | app | `~/Projects/eruditiontx-services-mvp/logs/` || mathmatterstx-services | systemd | `journalctl -u mathmatters-service` || agila-tax-management | docker | `docker logs agila-backend` || notaryo.ph | Next.js | `.next/` logs, terminal output || bocs-turbo | Vercel | `vercel logs` |## Commands### View Recent Logs**Systemd Services:**```bashjournalctl -u $SERVICE -n 100 --no-pager# Follow modejournalctl -u $SERVICE -f```**Docker Containers:**```bashdocker logs $CONTAINER --tail 100# Follow modedocker logs $CONTAINER -f```**Application Log Files:**```bashtail -n 100 ~/Projects/$PROJECT/logs/app.log# Follow modetail -f ~/Projects/$PROJECT/logs/app.log```### Filter by Level**Errors Only:**```bash# Systemdjournalctl -u $SERVICE -p err -n 100 --no-pager# Docker/Filesdocker logs $CONTAINER 2>&1 | grep -i "error\|exception\|traceback"# Log filesgrep -i "error\|exception\|traceback" ~/Projects/$PROJECT/logs/app.log```**Warnings:**```bashgrep -i "warn\|warning" $LOG_SOURCE```### Search Logs```bash# Search for patternjournalctl -u $SERVICE | grep -i "$PATTERN"docker logs $CONTAINER 2>&1 | grep -i "$PATTERN"grep -i "$PATTERN" ~/Projects/$PROJECT/logs/*.log```### Time-Based Filtering```bash# Last hourjournalctl -u $SERVICE --since "1 hour ago"# Todayjournalctl -u $SERVICE --since today# Specific time rangejournalctl -u $SERVICE --since "2024-01-01 00:00:00" --until "2024-01-01 23:59:59"```## Log Aggregation ModeView logs from multiple services at once:```bash# All Erudition servicesjournalctl -u erudition-service -u mathmatters-service -f# All Docker containersdocker-compose logs -f```## Log Analysis### Count Errors by Type```bashgrep -i "error" $LOG_FILE | sort | uniq -c | sort -rn | head -20```### Find Slow Requests```bashgrep -E "took [0-9]+ms" $LOG_FILE | awk '{print $NF}' | sort -rn | head -10```### Track Request IDs```bashgrep "$REQUEST_ID" $LOG_FILE```## Output Format```Logs: [service-name]Source: [systemd/docker/file]Filter: [all/error/warn]Time: [range]---[Formatted log entries with timestamps]---Summary:- Total entries: X- Errors: Y- Warnings: Z- Time span: [start] to [end]```## Common Log Patterns### FastAPI (Python)```INFO: 127.0.0.1:52847 - "GET /health HTTP/1.1" 200 OKERROR: Exception in route handler: [error message]```### Next.js```ready - started server on 0.0.0.0:3000error - Error: [error message]warn - [warning message]```### Docker```[timestamp] [level] [message]```## TroubleshootingIf logs are empty:1. Check if service is running: `systemctl status $SERVICE`2. Check log rotation: `ls -la /var/log/`3. Check Docker container status: `docker ps -a`4. Verify log file permissions---> Converted and distributed by [TomeVault](https://tomevault.io/claim/allanninal) — claim your Tome and manage your conversions.

Frequently asked questions

Logs