CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

railway-auth

Railway authentication and token management. Use when logging into Railway, creating API tokens, setting up CI/CD authentication, or verifying Railway credentials.

Quality

85%

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

82%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, well-structured skill whose commands, API examples, and CI/CD configs are copy-paste ready and paired with verification steps. Its main weaknesses are minor duplication between SKILL.md and the reference files, and a bundled verify-auth.sh script that is never surfaced in the body.

Suggestions

Reference scripts/verify-auth.sh from the SKILL.md body (e.g., in the 'Verify Authentication' operation: 'Or run: bash scripts/verify-auth.sh') so the bundled script is discoverable.

Trim the inline token-type comparison and troubleshooting tables to a summary plus a pointer to references/token-types.md and references/token-troubleshooting.md, since that detail already lives in those files.

Tie verification to recovery explicitly — after each 'railway whoami' or curl check, add a one-line 'if this fails, see the troubleshooting table' loop to close the feedback gap in workflow clarity.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands, tables, and code blocks with almost no filler or explanation of concepts Claude already knows. It could be tightened further: the token-type comparison table and troubleshooting table duplicate content that also lives in references/token-types.md and references/token-troubleshooting.md, so it sits at 'efficient; minor instances that could be trimmed' rather than the lean 5.

4 / 5

Actionability

Every operation ships copy-paste-ready commands: 'railway login', 'railway login --browserless', export RAILWAY_TOKEN/RAILWAY_API_TOKEN snippets, complete curl calls against the GraphQL endpoint, and full GitHub Actions and GitLab CI YAML. Concrete example outputs and a quick-reference command table cover the common cases, matching the fully-executable anchor.

5 / 5

Workflow Clarity

Each operation has a numbered process plus an explicit verification step ('railway whoami', curl token check), and the troubleshooting table gives issue→solution recovery paths. It falls short of anchor 5 because feedback loops are implicit — e.g., no 'if whoami fails, do X' step chains validation directly to recovery — but the sequence and checkpoints are otherwise clear.

4 / 5

Progressive Disclosure

The body is a clear overview with well-signaled one-level-deep references ([token-types.md](references/token-types.md), [token-troubleshooting.md](references/token-troubleshooting.md)), both of which exist in the bundle and contain no nested references. Gaps keep it at 4: scripts/verify-auth.sh is never mentioned in SKILL.md (undiscoverable), and the inline token/troubleshooting tables duplicate the reference files rather than deferring to them.

4 / 5

Total

17

/

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 that states a clear domain, concrete capabilities, and an explicit 'Use when' trigger clause with natural user phrasing. Its only weaknesses are a couple of missing natural trigger terms and slight overlap potential with sibling Railway skills.

DimensionReasoningScore

Specificity

The description names the domain ('Railway authentication and token management') and lists several concrete actions — 'logging into Railway', 'creating API tokens', 'setting up CI/CD authentication', 'verifying Railway credentials'. Coverage has minor gaps (troubleshooting and logout are handled by the skill but not mentioned), matching the 'several specific actions; minor gaps' anchor rather than the comprehensive 5.

4 / 5

Completeness

It explicitly answers both what ('Railway authentication and token management') and when ('Use when logging into Railway, creating API tokens, setting up CI/CD authentication, or verifying Railway credentials') with concrete trigger phrases, matching the anchor-5 example structure. Not a 4 because the 'when' clause is fully explicit rather than vague or under-specified.

5 / 5

Trigger Term Quality

Natural phrases like 'logging into Railway', 'creating API tokens', and 'verifying Railway credentials' match what users would actually say, with both 'authentication' and 'login'-style vocabulary present. A few natural terms are missing ('Railway CLI', 'auth issues', 'Not Authorized'), so it fits the 'good keyword coverage; a few natural terms missing' anchor.

4 / 5

Distinctiveness Conflict Risk

'Railway' is a clearly named niche with distinct triggers, so it won't fire for unrelated skills. Minor overlap risk remains with the related railway-api and railway-automation skills (e.g., 'creating API tokens' could also apply to railway-api), matching 'mostly distinct; minor overlap risk' rather than the minimal-conflict 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

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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