CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

railway-deployment

Comprehensive Railway.com deployment management for GitHub, Docker, and local sources. Use when deploying to Railway, redeploying services, rolling back deployments, monitoring deployment status, managing staging/production deployments, or verifying deployment health.

Quality

81%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 an exemplary 5-step workflow that embeds validation checklists and a rollback feedback loop, backed by real one-level-deep reference and script files. Its main weakness is token efficiency: the Quick Reference, Automated Scripts, and build-progress sections duplicate content already presented, and heavy inline detail (CI configs, advanced patterns) belongs in the existing reference files.

Suggestions

Delete the 'Quick Reference' and 'Automated Scripts' sections: the command tables, environment workflow, and script invocations they repeat are already fully covered in the 5-Step Deployment Workflow, cutting ~80 lines of duplication.

Move the CI/CD (GitHub Actions/GitLab) examples and Advanced Deployment Patterns (blue-green, canary, rolling) into a new references/ci-cd.md and references/advanced-patterns.md, signaled with one-line 'See references/...' pointers, keeping SKILL.md a lean overview.

Remove the mock 'Build progress indicators' progress-bar block and the restated 'What happens' step list, which explain behavior Claude can infer from the commands themselves.

DimensionReasoningScore

Conciseness

The body is predominantly tight, executable command blocks with no basic-concept padding, but redundancy is noticeable: the "Quick Reference" and "Automated Scripts" sections restate commands and script invocations already shown in the 5-step workflow, and the mock "Build progress indicators" progress-bar block adds no actionable value. Not 2 because the bulk is genuinely efficient command reference rather than explanation; not 4 because several sections (~80+ of ~680 lines) are duplicative padding that could be cut.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: concrete CLI invocations with flags ("railway redeploy --deployment dep_abc123xyz", "railway up --detach", "railway variables set --sealed DOCKER_USERNAME=user"), complete GitHub Actions and GitLab CI YAML, curl health checks, and script calls with argument variants. Common cases (GitHub, local, Docker, staging promotion, rollback) are each covered with runnable examples.

5 / 5

Workflow Clarity

The "5-Step Deployment Workflow" gives a clear sequence with explicit validation checkpoints: a pre-deployment checklist (auth, project, environment, pending deployments), a post-deploy validation checklist, and rollback verification steps (verify-health.sh, log checks, functional curl) that form a feedback loop. Not 4 because both checklists and the post-rollback re-verification loop are explicit rather than implicit.

5 / 5

Progressive Disclosure

References are real, clearly signaled, and one level deep ("See `references/rollback-strategies.md` for detailed rollback procedures", plus an Additional Resources index), and all five referenced scripts exist in scripts/. Not 5 because the ~680-line body retains substantial detail inline (full CI/CD pipeline configs, blue-green/canary patterns, troubleshooting tables) that an overview-first split would push into the reference files; the SKILL.md is more a full manual than a lean overview with well-signaled pointers.

4 / 5

Total

17

/

20

Passed

Description

75%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 solid description with an explicit, multi-trigger 'Use when' clause and platform-scoped capabilities. The main weakness is that the opening 'what' phrase ('Comprehensive... deployment management') leans on a buzzword ('Comprehensive') rather than concretely naming what the skill does; the concrete actions only appear in the trigger clause.

DimensionReasoningScore

Specificity

"Comprehensive Railway.com deployment management for GitHub, Docker, and local sources" names the domain and sources, and the trigger clause enumerates several concrete actions ("deploying to Railway, redeploying services, rolling back deployments, monitoring deployment status... verifying deployment health"). Not 5 because the lead 'what' phrase 'deployment management' is itself generic rather than enumerating the actions; not 3 because multiple specific actions are explicitly listed.

4 / 5

Completeness

Both 'what' ("Comprehensive Railway.com deployment management for GitHub, Docker, and local sources") and an explicit 'when' ("Use when deploying to Railway, ... or verifying deployment health") are present. Not 5 because the 'what' clause is somewhat generic ('deployment management') compared to the anchor-5 example that concretely enumerates capabilities; the 'when' half is fully explicit with concrete triggers.

4 / 5

Trigger Term Quality

Natural user phrases are well covered ("deploying to Railway", "rolling back deployments", "redeploying services", "staging/production deployments", "verifying deployment health"). Not 5 because common synonyms like 'release', 'push', 'ship', or 'CI/CD' are absent; not 3 because coverage goes well beyond a bare domain mention with multiple natural trigger phrasings.

4 / 5

Distinctiveness Conflict Risk

"Railway.com deployment management" carves out a clear, platform-scoped niche with distinct triggers. Not 5 because "monitoring deployment status" overlaps the sibling railway-observability skill ("Monitor metrics, logs, and traces") and sibling Railway skills share the platform keyword; not 3 because deployment/redeploy/rollback triggers are clearly owned by this skill.

4 / 5

Total

16

/

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 (680 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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