About steel-reliability
A reliability troubleshooting skill for maintainers of Steel browser workflows. It uses evidence and staged mitigations to investigate failed sessions while respecting access controls and site terms.
Key features
- 01Run a preflight check
- 02Collect failed-session evidence
- 03Troubleshoot reliability in stages
- 04Configure profiles and request pacing
- 05Check access before proxy or CAPTCHA features
- 06Verify the smallest failing step
Use cases
- 01Investigate failed Steel browser sessions
- 02Choose mitigations based on logs and screenshots
- 03Check plan access before configuring proxies or CAPTCHA
- 04Adjust request pacing and retest a failing step
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ steel-dev/ skills --skill steel-reliabilityAfter installing, type/steel-reliabilityin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
README.mdevals/evals.jsonreferences/captchas.mdcredentials.mdfailure-signals.mdfeature-access.mdmitigation-ladder.mdpacing-and-behavior.mdprofiles-and-identity.mdproxies.mdsession-debugging-handoff.mdstealth-and-antibot.mdDetails
From the project READMESteel Reliability
Skill Boundary
Use this skill to plan and verify legitimate reliability improvements for Steel browser workflows.
Do not promise guaranteed bypass. Do not provide advice for evading access controls or violating site terms. Start with the least invasive change that fits the evidence.
If the user has a failed session but no evidence yet, load steel-session-debugging first.
Setup Check
- Confirm
steel doctor --preflightpasses. - Confirm whether the user has a failed session ID, screenshot, logs, or error text.
- Check feature access before enabling paid CAPTCHA or Steel-managed proxy features.
- Preserve evidence before changing configuration.
Mitigation Ladder
- Determine whether the failure is normal auth/app behavior or likely anti-bot/reliability.
- Preserve evidence: status codes, redirects, challenge text, screenshots, console errors, failed requests.
- Use profiles when login state, cookies, or reputation matter.
- Add realistic pacing and lower concurrency.
- Add Steel-managed proxies only when feature access supports them, or BYOP when the user supplies a proxy.
- Add CAPTCHA solving when feature access supports it and the target flow allows it.
- Tune stealth config only with clear justification.
- Verify by rerunning the smallest failing step.
Feature Check
curl -sSfL "https://api.steel.dev/v1/details" \
-H "steel-api-key: $STEEL_API_KEY" | jq -r '.plan'
On Hobby plans, do not silently enable Steel-managed useProxy or CAPTCHA solving. Use defaults, BYOP when supplied, profiles, pacing, or ask the user to upgrade.
References
references/mitigation-ladder.md: staged diagnostic and mitigation workflow.references/stealth-and-antibot.md: challenge signals and acceptable framing.references/feature-access.md: plan checks and feature gates.references/proxies.md: Steel-managed proxies, geotargeting, and BYOP.references/captchas.md: detection, status, manual solve, and failure handling.references/profiles-and-identity.md: persistent identity and session context.references/credentials.md: secure login injection patterns.references/pacing-and-behavior.md: rate, wait, retry, and concurrency guidance.references/failure-signals.md: what evidence suggests each reliability class.references/session-debugging-handoff.md: when to collect more evidence first.