CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

railway-project-management

Comprehensive Railway.com project, environment, and variable management. Use when creating Railway projects, managing environments, configuring services, setting variables, syncing environments, managing PR environments, or organizing Railway infrastructure.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/railway-project-management/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

67%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 skill with concrete CLI commands, numbered workflows, validation checklists, and a properly structured reference bundle. Its main flaw is verbosity from significant self-duplication, plus a handful of steps delegated to the dashboard or left vague where executable guidance was expected.

Suggestions

Remove the Quick Reference tables and the repeated reference/script pointers (they duplicate sections 1-5 and the inline 'See references/...' links verbatim); keep a single 'Additional Resources' pointer list to cut ~100 lines.

Move the Quick Reference command tables and Environment Strategies diagrams into references/ (e.g., a cli-cheatsheet.md) so SKILL.md stays a lean overview with one-level-deep pointers.

Replace vague or dashboard-only steps with executable guidance: give non-interactive flags for 'railway init'/'railway link', and spell out the staging-variable replication step in the init workflow instead of '# (Set staging-specific variables)'.

DimensionReasoningScore

Conciseness

Most sections are efficient command blocks, but the ~515-line body carries clear padding: the Quick Reference tables restate every earlier command section, reference pointers are repeated three times (inline, scripts section, Additional Resources), 'Variable Organization' repeats examples already shown, and it explains 'DRY (Don't Repeat Yourself)' to Claude. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; the sheer volume of duplication keeps it from 4.

3 / 5

Actionability

Concrete, copy-paste CLI commands with placeholders dominate ('railway init --name "my-project"', 'railway variables set --sealed STRIPE_KEY=sk_live_...'), plus real script invocations. Minor gaps: several steps are deferred to the dashboard ('Done via dashboard - automated per PR'), interactive commands like 'railway init' and 'railway link' offer no non-interactive flags for agent use, and some steps are hand-waved ('# (Usually auto-set by Railway)').

4 / 5

Workflow Clarity

Multi-step workflows are clearly numbered ('Initialize New Full-Stack Project' 1-6), a dedicated Verification section provides a checklist, and Troubleshooting gives symptom-to-solution feedback loops. It falls short of 5 because validation is mostly 'run status/list and open in browser', the staging-replication step is vague ('# (Set staging-specific variables)'), and PR environment configuration has no CLI steps at all.

4 / 5

Progressive Disclosure

The bundle is real and well-signaled: all three references files exist, are pointed to inline ('See references/environment-types.md for detailed guide'), and are one level deep with only a single sibling cross-reference; both scripts exist and are invoked with concrete paths. It misses 5 because SKILL.md itself at 515 lines carries bulk content (full quick-reference tables, Environment Strategies diagrams, repeated variable examples) that belongs in the reference files.

4 / 5

Total

15

/

20

Passed

Description

83%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 with an explicit 'Use when...' trigger clause and a well-scoped Railway.com domain. Its main weaknesses are the generic 'Comprehensive ... management' framing and minor keyword/overlap gaps against closely related Railway skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions ('creating Railway projects, managing environments, configuring services, setting variables, syncing environments'), but the capability statement itself ('Comprehensive Railway.com project, environment, and variable management') is generic and 'Comprehensive' is filler, so it falls short of the fully concrete 5 anchor.

4 / 5

Completeness

It explicitly answers both what ('Comprehensive Railway.com project, environment, and variable management') and when ('Use when creating Railway projects, managing environments...') with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Natural user phrases like 'creating Railway projects', 'setting variables', 'PR environments', and 'syncing environments' are covered, but common variations users might say ('staging', 'secrets', 'environment variables') are missing, matching 'good keyword coverage; a few natural terms missing' rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

'Railway.com' carves a clear niche, but the broad 'organizing Railway infrastructure' clause and the closely related sibling skills named in the body (railway-cli, railway-deployment) create minor overlap risk, fitting 'mostly distinct; minor overlap risk with closely related skills' rather than minimal conflict at 5.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/railway-project-management/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.