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

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

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

The content is highly actionable with executable commands and scripts, and bundle references are well-organized and real. Its weaknesses are verbosity from restated concepts and command duplication, plus missing inline validation in destructive workflows.

Suggestions

Trim restated concepts (environment types, variable-scoping ASCII tree, environment strategies) that duplicate the reference files, and remove the Quick Reference command tables that repeat the inline examples to cut length.

Add inline validation feedback loops to destructive/batch workflows—e.g., after 'railway environment delete' or 'railway variables delete', run 'railway status'/'railway variables list' to confirm the change before proceeding.

Move the Security Best Practices and Environment Strategies sections into reference files so SKILL.md stays a lean overview pointing one level deep.

Dimension	Reasoning	Score
Conciseness	Command references are useful, but the ~510-line body restates concepts Claude already knows (environment types, variable scoping tree, environment strategies) and duplicates commands across inline examples and Quick Reference tables; mostly efficient but could be tightened, matching anchor 3.	3 / 5
Actionability	Provides copy-paste-ready railway commands across every workflow, a complete railway.json example, and concrete script invocations (init-project.sh, sync-env.sh production staging), covering the common cases per anchor 5.	5 / 5
Workflow Clarity	Multi-step workflows are clearly sequenced with a validation section, but destructive/batch operations (environment delete, variables delete, duplicating production) lack inline validation feedback loops, so workflow_clarity is capped at 3 per the rubric.	3 / 5
Progressive Disclosure	All three references and both scripts exist and are clearly signaled one level deep ('See references/...', an Additional Resources section), but the SKILL.md itself retains substantial inlined detail (environment strategies, security practices) that could live in references, a minor organization gap matching anchor 4.	4 / 5
	Total	15 / 20 Passed

Description

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

The description is strong: it names a specific platform, lists many concrete actions, and includes an explicit 'Use when' trigger clause. Its only weak spot is keyword breadth—missing a few natural synonyms users might say.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions—'creating Railway projects, managing environments, configuring services, setting variables, syncing environments, managing PR environments'—with comprehensive coverage of the domain, matching the anchor-5 example.	5 / 5
Completeness	Clearly states what ('Comprehensive Railway.com project, environment, and variable management') and an explicit 'Use when' clause enumerating concrete triggers, matching the anchor-5 what-and-when example.	5 / 5
Trigger Term Quality	Strong natural keywords ('creating Railway projects', 'managing environments', 'setting variables', 'syncing environments'), but lacks common synonyms such as 'deploy'/'secrets' and offers no file-extension equivalents, landing just below the comprehensive anchor 5.	4 / 5
Distinctiveness Conflict Risk	Tied to the specific Railway.com platform with niche triggers (PR environments, sealed variables), giving a clear niche and minimal overlap with unrelated skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
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: skills/railway-project-management/SKILL.md
Commit: 93ed392

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.