Agent skill

Scan Logs

by marin-community in marin-community/marin

Use scripts/logscan.py only when explicitly requested to scan an oversized log or to perform Gemini-backed log analysis.

Apache-2.0Auto-check passed

Install Scan Logs

skills CLI
$ npx skills add marin-community/marin --skill scan-logs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install marin-community/marin scan-logs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/marin-community/marin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/scan-logs .claude/skills/scan-logs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
scan-logs
GitHub stars
3.9k
Token cost
~438 tokens
SKILL.md length
173 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
Apache-2.0

At a glance

Use scripts/logscan.py only when explicitly requested to scan an oversized log or to perform Gemini-backed log analysis.

  • SKILL.md covers Prerequisites, Modes and Output
  • Calls uv; needs GEMINI_API_KEY

What it does

Scan Logs is an agent skill from marin-community/marin. Use scripts/logscan.py only when explicitly requested to scan an oversized log or to perform Gemini-backed log analysis.

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Open-source framework for the research and development of foundation models. The licence is Apache-2.0.

Example prompts

  • “/scan-logs”

Requirements

  • A credential in GEMINI_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 61bb85c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GEMINI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Scan Logs loads about 438 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 173 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~438

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from marin-community/marin at commit 61bb85c, republished under its Apache-2.0 licence (© marin-community). 173 words, ~438 tokens.

Download SKILL.mdSave it as .claude/skills/scan-logs/SKILL.md (or your agent's skills folder).
name
scan-logs
description
Use scripts/logscan.py only when explicitly requested to scan an oversized log or to perform Gemini-backed log analysis.

Scan large logs

grep finds matching original lines; summarize produces a Markdown report. They can run independently or as a pipeline.

Prerequisites

GEMINI_API_KEY must be set. The log is sent to an external Gemini API and incurs model usage; do not send secrets or sensitive logs without approval.

Modes

grep — find matching lines

Returns line-numbered original lines matching a natural-language query.

bash
uv run scripts/logscan.py grep <logfile> "<query>"
summarize — produce a markdown report

Summarizes the log around the query, hierarchically reducing large inputs.

bash
uv run scripts/logscan.py summarize <logfile> "<query>"

Output is a markdown report on stdout.

Piping modes together

Narrow first, then summarize through --stdin:

bash
uv run scripts/logscan.py grep log.txt "errors" \
  | uv run scripts/logscan.py summarize --stdin "summarize these errors"

Behavior-changing options are --chunk-tokens, --concurrency, --model, --stdin, and --verbose. The defaults are 5,000-token grep chunks, 50,000-token hierarchical summarize chunks, concurrency 16, and gemini-2.5-flash-lite. Smaller grep chunks favor precise line matching; large logs need no manual pre-split. Inspect --help before overriding them.

Output

  • grep: Line-numbered matching lines to stdout. Progress to stderr.
  • summarize: Markdown report to stdout. Progress and token usage to stderr.

Both modes report progress and token usage to stderr. Read the matched source lines before accepting a generated diagnosis.

© marin-community, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/scan-logs of marin-community/marin.

Open the folder on GitHubat commit 61bb85c

Compare with similar skills

Scan Logs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Scan Logs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scan Logs this skillmarin-community/marin3.9k—~438Automated safety check: PassApache-2.0
Scanwshobson/agents40k—~2.2kAutomated safety check: PassMIT
Logging API Requestsjeremylongshore/tons-of-skills-marketplace2.8k—~1.5kAutomated safety check: PassMIT
Repo Scanaffaan-m/ECC276k—~1.5kAutomated safety check: PassMIT
Repo Scanaffaan-m/ECC276k—~1.3kAutomated safety check: PassMIT
Vulnerability Scanningsickn33/agentic-awesome-skills47k1 repos~2.8kAutomated safety check: PassMIT

Similar skills

  • Scan

    wshobson/agents

    Scans the codebase to generate project-doc.md and AGENTS.md.

    40k GitHub stars~2.2k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Logging API Requests

    jeremylongshore/tons-of-skills-marketplace

    Monitor and log API requests with correlation IDs, performance metrics, and security audit trails.

    2.8k GitHub stars~1.5k tokensUpdated today
    SecurityAuto-check passed
  • Repo Scan

    affaan-m/ECC

    固定されレビュー可能なコミットから外部の repo-scan スキルをインストールするブートストラップ用ポインター。クロススタックのソースコード資産監査を実行する前に repo-scan のインストールが必要な場合に使用する。この ECC ポインター自体は監査を実行しない。

    276k GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Repo Scan

    affaan-m/ECC

    用于从固定且可审查的提交安装外部 repo-scan 技能的引导指针。在运行跨栈源代码资产审计前需要安装 repo-scan 时使用;此 ECC 指针本身不执行审计。

    276k GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed
  • Vulnerability Scanning

    sickn33/agentic-awesome-skills

    Scan systems and dependencies for CVEs and security vulnerabilities.

    47k GitHub starsUsed in 1 repo~2.8k tokens
    SecurityAuto-check passed
  • No Explicit Any

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing TypeScript files for type safety regressions, during code review of functions that handle external data, or when the codebase has ESLint warnings for…

    74k GitHub stars~565 tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from marin-community/marin

All 41 skills in this repo
  • Noslop

    marin-community/marin

    Deslop, simplify, or review low-value tests and prose only when explicitly requested for a branch or diff.

    3.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Use Iris

    marin-community/marin

    Use Iris to submit, inspect, debug, monitor, or recover jobs and tasks; diagnose scheduling and federation; deploy controllers; or reserve dev GPUs and TPUs.

    3.9k GitHub stars~745 tokensUpdated today
    Auto-check passed
  • Launch Rl

    marin-community/marin

    Define, validate, submit, or restart a Marin SkyRL experiment through its artifact main.

    3.9k GitHub stars~894 tokensUpdated today
    Auto-check passed
  • Marina Applet

    marin-community/marin

    Build, validate, publish, update, inspect, query, roll back, or archive a dynamic Marina applet.

    3.9k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Query Finelog

    marin-community/marin

    Query Finelog logs and telemetry for Iris tasks, workers, profiles, training, vLLM, and cross-cluster forwarding.

    3.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Trace Pulumi Diff

    marin-community/marin

    Run a read-only preview for a specified Marin infra/pulumi stack and trace each pending resource change to merged pull requests since its latest successful update when that update records a clean…

    3.9k GitHub stars~663 tokensUpdated today
    Auto-check passed

Questions about Scan Logs

What does Scan Logs do?

Use scripts/logscan.py only when explicitly requested to scan an oversized log or to perform Gemini-backed log analysis. Scan Logs is an agent skill from marin-community/marin.py only when explicitly requested to scan an oversized log or to perform Gemini-backed log analysis.

How do I install Scan Logs in Claude Code?

Run `npx skills add marin-community/marin --skill scan-logs -a claude-code`. Or copy the skill folder (.agents/skills/scan-logs in marin-community/marin) into .claude/skills/scan-logs in your project. Claude Code loads it when a task matches its description.

How do I install Scan Logs in Codex?

Run `npx skills add marin-community/marin --skill scan-logs -a codex`. Or copy the skill folder (.agents/skills/scan-logs in marin-community/marin) into .agents/skills/scan-logs in your project. Codex loads it when a task matches its description.

Can I use Scan Logs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add marin-community/marin --skill scan-logs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scan-logs, .gemini/skills/scan-logs, .github/skills/scan-logs and .opencode/skills/scan-logs in your project.

What does Scan Logs need to run?

Going by SKILL.md and its folder, Scan Logs needs the command-line tools its instructions call (uv) and credentials named GEMINI_API_KEY. Our summary lists: A credential in GEMINI_API_KEY.

Does Scan Logs access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Scan Logs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Scan Logs use?

Scan Logs is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Scan Logs use?

About 438 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Scan Logs?

Skills that share tags, products or a category with Scan Logs: Scan (wshobson/agents, 40k stars), Logging API Requests (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Repo Scan (affaan-m/ECC, 276k stars) and Repo Scan (affaan-m/ECC, 276k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scan Logs?

marin-community (a GitHub organization) maintains it in marin-community/marin, which has 3,920 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 9, 2026.

Source: marin-community/marin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.