CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

railway-logs

Railway log access and analysis for debugging and monitoring. Covers build logs, deploy logs, runtime logs, HTTP logs, filtering, search, and external export. Use when viewing logs, debugging Railway deployments, investigating errors, analyzing HTTP requests, filtering log output, or exporting logs to external systems.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is railway-logs in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured body with verified commands and real bundle files behind every reference. Its main costs are token weight — generic logging best-practice content Claude already knows and duplicated inline detail that belongs in the reference files — plus missing validation checkpoints on the export workflows.

Suggestions

Trim the Best Practices section to only Railway-specific facts (single-line JSON requirement, >10KB truncation, retention limits) and drop generic advice (log-level meanings, never log passwords, avoid per-request logging) that Claude already knows.

Cut the 'Keywords' line and 'When to Use This Skill' section, which duplicate the frontmatter description and add no new information.

Compress the inlined filter-syntax, structured-logging, and external-export sections to short summaries that defer detail to their existing reference files, and add a verification step to the export workflows (e.g., confirm webhook delivery or check the output file is non-empty).

DimensionReasoningScore

Conciseness

The operation sections are dense with concrete commands, but the body pads with content Claude already knows: a "Keywords" line duplicating the description, a "When to Use This Skill" section repeating it, generic log-level explanations, and a ~70-line Best Practices section of standard logging advice (DO/DON'T JSON logging, never log passwords, avoid logging every request). This sits between 'noticeably verbose' (2) and 'mostly efficient' (3) — the Railway-specific bulk is efficient, so 3.

3 / 5

Actionability

Copy-paste-ready CLI commands throughout ("railway logs --build --lines 100", "railway logs --json | jq 'select(.level == \"error\")'"), concrete filter-syntax tables, step-by-step dashboard paths, and script usage examples whose flags (--output file|webhook|s3, --bucket, --token) were verified against the actual bundle scripts. All common cases are covered executably.

5 / 5

Workflow Clarity

Operations are clearly sequenced, the prerequisites section includes an explicit validation checkpoint ("railway status" to verify the link), and troubleshooting tables give error-recovery guidance. Minor gaps: locomotive/OTEL export setup and the streaming script lack verification that export actually succeeded, and there is no explicit validate-retry feedback loop.

4 / 5

Progressive Disclosure

Good structure: all four reference files and both scripts exist, are one level deep, and are well signaled with descriptions in a References/Scripts section. However, substantial content (filter syntax, structured-logging code examples, external export options) is inlined in near-full detail while also having dedicated reference files, so some content that should be separate remains inline — fitting 'most content appropriately placed, minor organization gaps' (4) rather than the clean split of 5.

4 / 5

Total

16

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capability list, explicit 'Use when' triggers, and a clearly pinned Railway niche. The only weakness is mild trigger overlap with sibling Railway skills for generic error/debug phrasing.

DimensionReasoningScore

Specificity

"Covers build logs, deploy logs, runtime logs, HTTP logs, filtering, search, and external export" lists multiple concrete capabilities with comprehensive coverage of the Railway log domain, matching the top anchor rather than the 'minor gaps' of a 4.

5 / 5

Completeness

The 'what' is explicit ("Railway log access and analysis for debugging and monitoring" plus the enumerated capabilities) and the 'when' is an explicit Use-when clause with concrete triggers, directly mirroring the anchor-5 example pattern.

5 / 5

Trigger Term Quality

"Use when viewing logs, debugging Railway deployments, investigating errors, analyzing HTTP requests, filtering log output, or exporting logs to external systems" provides comprehensive natural trigger phrases users would actually say; no meaningful natural term for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

"Railway" pins a clear niche, but generic triggers like "investigating errors" and "viewing logs" overlap with closely related sibling skills in the same plugin (railway-troubleshooting, observability-stack-setup), fitting the 'minor overlap risk with closely related skills' anchor rather than minimal conflict.

4 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (643 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 7 suspicious

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/railway-logs/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.