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

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 well-structured, highly actionable deployment guide with an excellent validated 5-step workflow, but it carries avoidable bloat (duplicated quick-reference tables, conceptual deployment-pattern filler) and one broken script reference. Trimming the padded sections and moving advanced material into reference files would push it into the top band.

Suggestions

Remove the dangling 'scripts/monitor-deployment.sh' reference in the Monitor Deployment section (the file does not exist in the bundle) or add the script and list it in Additional Resources alongside the other five scripts.

Cut the 'Quick Reference' section that repeats the command and environment tables already shown, and drop the ASCII 'Build progress indicators' block, which adds no actionable guidance.

Move the CI/CD Integration and Advanced Deployment Patterns (blue-green/canary/rolling) sections into a reference file (e.g., references/advanced-patterns.md), keeping only a one-line pointer in SKILL.md.

DimensionReasoningScore

Conciseness

The bulk is concrete commands, but there is noticeable padding: an ASCII 'build progress indicators' illustration, an 'Advanced Deployment Patterns' section of conceptual filler with non-executable parenthetical comments ('(Configure via load balancer)', '(Requires horizontal scaling)'), and a 'Quick Reference' section that duplicates tables and commands already shown. This fits the score-3 anchor (mostly efficient, could be tightened) better than score 2 because no space is spent explaining concepts Claude already knows and every section is deployment-specific.

3 / 5

Actionability

Mostly executable guidance: concrete railway CLI invocations with flags, curl health checks, complete GitHub Actions and GitLab CI YAML, and runnable bundled scripts. Minor gaps keep it below 5: unexpanded '<deployment-id>' placeholders in rollback commands and the non-executable comments in the canary/blue-green sections.

4 / 5

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit validation checkpoints and feedback loops for risky operations: a pre-deployment checklist in Step 1, health/validation checklists in Step 4, rollback verification (verify-health.sh, log checks) after Step 5, and a troubleshooting section with check-diagnose-fix-redeploy loops. This matches the score-5 anchor including checklists and error-recovery loops for a destructive-capable process.

5 / 5

Progressive Disclosure

Good structure overall: three references (deployment-sources.md, rollback-strategies.md, staging-workflow.md) are one level deep, clearly signaled, and all exist on disk, and five bundled scripts are invoked by path. Below the score-5 anchor because the body cites 'scripts/monitor-deployment.sh' which does not exist in the bundle (a broken navigation path), and content that belongs in references (CI/CD pipelines, advanced deployment patterns) is inlined in SKILL.md.

4 / 5

Total

16

/

20

Passed

Description

88%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: it states concrete capabilities across all deployment sources, includes an explicit 'Use when...' clause with natural trigger terms, and is written in third person without fluff. The only improvements are broader synonym coverage and sharper separation from sibling Railway skills.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions with comprehensive coverage: 'deployment management for GitHub, Docker, and local sources', 'redeploying services', 'rolling back deployments', 'monitoring deployment status', 'managing staging/production deployments', 'verifying deployment health'. This matches the anchor for multiple specific concrete actions; it is above the score-4 anchor because coverage of the deployment lifecycle is comprehensive rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both questions: 'what' via 'Comprehensive Railway.com deployment management for GitHub, Docker, and local sources' and 'when' via the explicit 'Use when deploying to Railway, redeploying services, rolling back deployments...' clause with concrete trigger phrases. This is a direct match to the score-5 anchor.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say: 'deploying to Railway', 'rolling back deployments', 'monitoring deployment status', 'verifying deployment health', 'staging/production'. It falls short of the score-5 anchor because common synonyms and variations are missing (e.g., 'CI/CD', 'promote', 'release', 'ship'), while it clearly exceeds the score-3 anchor, which requires missing common variations.

4 / 5

Distinctiveness Conflict Risk

The Railway.com platform niche is clear and deployment-specific triggers are distinct, but phrases like 'monitoring deployment status' and 'verifying deployment health' have minor overlap risk with closely related sibling skills in the same family (e.g., railway-observability). Mostly distinct with minor overlap, matching the score-4 anchor rather than the score-5 clear-niche anchor.

4 / 5

Total

18

/

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

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.