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

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

Highly actionable and well-sequenced CLI documentation, but the body is long and duplicated: material that already exists in the references/ files (filter syntax, structured logging, external export) is reproduced inline, plus a redundant keyword-stuffing line. The skill would score much higher by trusting its own progressive-disclosure structure and cutting the duplicated inline content.

Suggestions

Collapse Operation 6 and the 'Integration with External Tools' section to a short summary plus a pointer to references/external-export.md, since that file already contains the detailed guides.

Trim Operation 5's filter tables and example patterns to a few essentials and link to references/log-filtering-syntax.md for the full syntax.

Remove the '**Keywords**' line (the frontmatter description already serves retrieval) and deduplicate the structured-logging DO/DON'T examples shown in both Operation 3 and Best Practices.

DimensionReasoningScore

Conciseness

The ~640-line body has several padded or duplicated sections: a keyword-stuffing "**Keywords**" line, structured-logging DO/DON'T examples repeated in Operation 3 and Best Practices, @httpStatus filter examples repeated across Operations 4 and 5, and ~100 lines of external-export detail and external-tool integration that duplicate references/external-export.md. This is "several unnecessary explanations or padded sections" (anchor 2), not the anchor-3 case of occasional tightening, because the duplication and keyword padding are systematic.

2 / 5

Actionability

Nearly every section gives copy-paste-ready commands (railway logs --build --lines 100, railway logs --json | jq 'select(.level == "error")'), executable Node/Python logging examples, and script usage lines whose flags (--output webhook --url ... --token) match the actual stream-logs.sh CLI. Not anchor 4 because no significant executable guidance is missing for the common cases.

5 / 5

Workflow Clarity

The prerequisite sequence is clearly ordered with an explicit verification checkpoint ("# 3. Verify link / railway status"), each operation has a defined sequence, and troubleshooting tables provide error-recovery guidance (e.g., "Health check failing? Verify `PORT` environment variable"). It falls short of anchor 5 because error recovery is presented as lookup tables rather than explicit validate → fix → retry loops within the workflows.

4 / 5

Progressive Disclosure

Four real reference files (cli-commands.md, log-filtering-syntax.md, structured-logging.md, external-export.md) and two real scripts exist and are clearly signaled in dedicated References/Scripts sections — but the body substantially inlines the same content (filter syntax ~70 lines; external export ~100 lines plus per-tool integration blocks) that already lives in those files. "Content that should be separate is inline" places it at anchor 3 despite good signaling, below anchor 4 where content is appropriately placed.

3 / 5

Total

14

/

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 capabilities across all Railway log types, an explicit 'Use when...' clause with natural trigger phrases, and third-person voice. The only minor concern is overlap with closely related sibling skills in the same Railway skill family.

DimensionReasoningScore

Specificity

"Railway log access and analysis for debugging and monitoring. Covers build logs, deploy logs, runtime logs, HTTP logs, filtering, search, and external export" lists multiple specific concrete capabilities with comprehensive coverage across all Railway log types. It matches the anchor-5 example (multiple specific actions, comprehensive) rather than anchor 4, which allows minor coverage gaps.

5 / 5

Completeness

It explicitly answers what ("Covers build logs, deploy logs, runtime logs, HTTP logs, filtering, search, and external export") and when ("Use when viewing logs, debugging Railway deployments, investigating errors...") with concrete trigger phrases. This mirrors the anchor-5 example structure exactly; the 'when' clause is present and explicit, so it is not capped at 3 or scored 4 for a weaker 'when'.

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" covers natural phrases users would say, plus domain terms (build logs, deploy logs, runtime logs, HTTP logs). Coverage is comprehensive with synonyms; nothing significant is missing, so anchor 5 fits better than anchor 4 ("a few natural terms missing").

5 / 5

Distinctiveness Conflict Risk

"Railway log access and analysis" is clearly niche-scoped, but the skill family includes closely related siblings (railway-api for "Programmatic log access", railway-troubleshooting) that share debugging/logs trigger territory, so there is minor overlap risk with closely related skills — anchor 4 rather than 5. It is well above anchor 3 since Railway-specific triggers make wrong-skill firing unlikely outside the sibling set.

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

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.